253 lines
4.5 KiB
Markdown
253 lines
4.5 KiB
Markdown
# Bashrc Dotfiles — Global & Portable Bash Prompt
|
||
|
||
Elegant, portable, and easy-to-install Bash prompt with:
|
||
|
||
- ✨ Two color zones
|
||
- 🌅 Time-based emoji accents
|
||
- 🖥️ Fallback when Nerd Fonts aren’t available
|
||
- 📍 Shortened but informative path
|
||
- 🔘 Status-colored prompt arrow
|
||
- 🧠 Works on Linux, WSL, and macOS
|
||
|
||
---
|
||
|
||
## 🚀 Install (step by step)
|
||
|
||
### 🐧 Linux / WSL (global, all users)
|
||
|
||
1) Clone the repo:
|
||
|
||
```bash
|
||
git clone <repo-url>
|
||
```
|
||
|
||
2) Enter the folder:
|
||
|
||
```bash
|
||
cd Bashrc
|
||
```
|
||
|
||
3) Run the global installer (auto-installs deps + prompts for punchline):
|
||
|
||
```bash
|
||
sudo bash dotfiles/install/install-linux-global.sh
|
||
```
|
||
|
||
4) Open a new shell to see the prompt and banner.
|
||
|
||
### 🍏 macOS (per-user)
|
||
|
||
1) Clone the repo:
|
||
|
||
```bash
|
||
git clone <repo-url>
|
||
```
|
||
|
||
2) Enter the folder:
|
||
|
||
```bash
|
||
cd Bashrc
|
||
```
|
||
|
||
3) Run the user installer:
|
||
|
||
```bash
|
||
bash dotfiles/install/install-macos-user.sh
|
||
```
|
||
|
||
4) Reload your shell (or open a new terminal):
|
||
|
||
```bash
|
||
source ~/.bashrc
|
||
```
|
||
|
||
### 🖼️ Nerd Fonts (optional but recommended)
|
||
|
||
```bash
|
||
bash dotfiles/install/install-nerdfont.sh
|
||
```
|
||
|
||
After install:
|
||
|
||
- Open your terminal settings
|
||
- Set font to JetBrainsMono Nerd Font (or any Nerd Font)
|
||
- Terminal must use a Nerd Font for glyphs like ``, ``, `` to render correctly
|
||
|
||
---
|
||
|
||
## ✅ What the installers do
|
||
|
||
### Linux / WSL
|
||
|
||
- Installs the prompt module to `/etc/profile.d/ps1.sh`
|
||
- Installs the banner module to `/etc/profile.d/banner.sh`
|
||
- Sources both from `/etc/bash.bashrc`
|
||
- Installs `landscape-common`, `figlet`, and `lolcat` if missing
|
||
- Prompts for the global punchline used by the banner
|
||
|
||
### macOS
|
||
|
||
- Copies `ps1/ps1.sh` to `~/.config/ps1/ps1.sh`
|
||
- Adds a source block in `~/.bashrc` and `~/.bash_profile`
|
||
|
||
---
|
||
|
||
## PS1 module (when it runs)
|
||
|
||
The prompt is loaded automatically by the installer:
|
||
|
||
- Linux/WSL: sourced from `/etc/bash.bashrc` (global)
|
||
- macOS: sourced from `~/.bashrc` and `~/.bash_profile` (per-user)
|
||
|
||
You normally do not need to run `ps1.sh` manually.
|
||
|
||
---
|
||
|
||
## Banner (hostname + punchline + sysinfo)
|
||
|
||
På Linux/WSL lastes også et banner ved login:
|
||
|
||
- `figlet $(hostname) -c | lolcat`
|
||
- `figlet -f digital "<punchline>" -c | lolcat`
|
||
- `landscape-sysinfo | lolcat`
|
||
|
||
### Punchline (global)
|
||
|
||
Banneret leser punchline fra:
|
||
|
||
- `/etc/ps1-punchline`
|
||
|
||
Install-scriptet spør etter punchline og lagrer den i filen. Du kan også sette den manuelt:
|
||
|
||
```bash
|
||
echo "Din punchline" | sudo tee /etc/ps1-punchline >/dev/null
|
||
```
|
||
|
||
---
|
||
|
||
## 🧠 Features
|
||
|
||
- **Clean, modern powerline-style prompt**
|
||
- Zone 1: date/time/user (cool gray-blue)
|
||
- Zone 2: host/path (turquoise / cool green)
|
||
- Automatically switches emoji during the day
|
||
- Smart path shortening (keeps your home dir visible)
|
||
- Fallback to ASCII/Unicode if Nerd Fonts are not installed
|
||
- Per-user disable support
|
||
- Simple per-user or global install
|
||
|
||
---
|
||
|
||
## 🗂️ Repo Structure
|
||
|
||
```text
|
||
dotfiles/
|
||
├── ps1/
|
||
│ └── ps1.sh
|
||
├── install/
|
||
│ ├── install-linux-global.sh
|
||
│ ├── install-macos-user.sh
|
||
│ └── install-nerdfont.sh
|
||
└── README.md
|
||
```
|
||
|
||
## ⚙️ Overrides (Optional)
|
||
|
||
Sometimes autodetection doesn’t work (e.g., on macOS without fontconfig):
|
||
|
||
Force Nerd Font glyphs:
|
||
|
||
```bash
|
||
export PS1_FORCE_NF=1
|
||
```
|
||
|
||
Force fallback (no powerline glyphs):
|
||
|
||
```bash
|
||
export PS1_FORCE_ASCII=1
|
||
```
|
||
|
||
Add these to your `~/.bashrc` or `~/.bash_profile`.
|
||
|
||
---
|
||
|
||
## 🙅 Disable Prompt (per user)
|
||
|
||
If you want to disable the global prompt for your account:
|
||
|
||
Temporarily in a shell:
|
||
|
||
```bash
|
||
export DISABLE_GLOBAL_PS1=1
|
||
```
|
||
|
||
Permanently:
|
||
|
||
```bash
|
||
mkdir -p ~/.config/ps1
|
||
touch ~/.config/ps1/disable
|
||
```
|
||
|
||
To re-enable:
|
||
|
||
```bash
|
||
rm -f ~/.config/ps1/disable
|
||
```
|
||
|
||
---
|
||
|
||
## 🧪 Testing
|
||
|
||
After install, open a new shell and run:
|
||
|
||
```bash
|
||
bash -i -c 'echo OK'
|
||
```
|
||
|
||
If you see a prompt with colors and emoji, things are working.
|
||
|
||
---
|
||
|
||
## 💡 Usage Notes
|
||
|
||
Font matters: even with Nerd Fonts installed, you must select them in your terminal settings.
|
||
|
||
Works on terminals like:
|
||
|
||
- GNOME Terminal
|
||
- iTerm2
|
||
- Kitty
|
||
- VS Code integrated terminal
|
||
- Windows Terminal (WSL)
|
||
|
||
If you see squares or missing glyphs, your terminal is likely using a non-Nerd font.
|
||
|
||
---
|
||
|
||
## 📸 Example Prompt
|
||
|
||
This prompt shows:
|
||
|
||
<p align="center">
|
||
<img src="images/image.png" width="900">
|
||
</p>
|
||
|
||
With exit-status colored arrow and emoji reflecting time of day.
|
||
|
||
---
|
||
|
||
## 🛠️ Contribution
|
||
|
||
Want to help improve this project?
|
||
|
||
- Fork the repository
|
||
- Make your changes
|
||
- Open a merge request
|
||
- Please keep consistent colors and styles
|
||
|
||
---
|
||
|
||
## 📄 License
|
||
|
||
MIT © 2026 Steffen Skui
|