Bash Prompts

A collection of bash prompts with individual themes to alter your bash terminal experience. Each theme includes git integration, dynamic status indicators, and unique aesthetic elements.

Features

• Git Integration - Shows branch, commit status, and upstream sync
• Time Display - Current time in the prompt
• Full Path Display - Always know where you are
• Two-line Format - Clean separation between info and input
• 256-color Support - Rich, vibrant color schemes
• Easy Customization - Multiple variants for each theme
• Optional Greetings - Mutiple on-theme greetings for new sessions

Installation

Quick Install

1. Clone this repository:

git clone https://gitlab.com/nmrc/bash-prompts.git
cd bash-prompts

2. Back up your current .bashrc:

cp ~/.bashrc ~/.bashrc.backup

3. Add your chosen theme to .bashrc:

cat themes/cyberpunk.sh >> ~/.bashrc

4. Reload your shell:

source ~/.bashrc

Manual Install

Copy the desired theme configuration from the themes/ directory and append it into your existing ~/.bashrc file.

Available Themes

1. Cyberpunk Theme

File: themes/cyberpunk.sh

A neon-infused, high-tech prompt for the cyberpunk nerd enthusiast.

Features:

• Color Scheme: Neon cyan, hot pink, electric yellow, and vibrant green
• Git Symbols:
  • ⚡ = Uncommitted changes
  • ✓ = Clean working directory
  • ↑/↓ = Ahead/behind upstream
• Prompt Symbols: Cascading arrows (▶▶▶) in different colors
• Time Format: HH:MM:SS in cyan brackets

Variants:

• Default: Full featured with background colors
• Minimal: Clean with λ (lambda) prompt symbol
• Unicode: Special characters (⟦⟧◢◣) for extra flair

---

2. Pagan/Celtic Theme

File: themes/pagan-celtic.sh

Invoke nature and ancient wisdom through earth tones and mystical symbols.

Features:

• Color Scheme: Forest greens, earth browns, harvest gold, moss, copper
• Special Functions:
  • Moon phase tracker (updates daily)
  • Seasonal indicator (❄️ Winter, 🌱 Spring, ☀️ Summer, 🍂 Autumn)
• Git Symbols:
  • ᚦ (Thor rune) = Changes pending (chaos/transformation)
  • ᚨ (Ansuz rune) = Clean state (divine order)
• Celtic Elements: ☘ (shamrock), ⟨⟩ (Celtic brackets)

Variants:

• Default: Celtic symbols with moon and seasons
• Runic: Elder Futhark runes (ᚠᚱᚢᚾ)
• Native American: Four directions (◈) and arrow (➳)
• Tree of Life: Nature emojis (🌳🌿)

---

3. Dark Machine/Infernal Theme

File: themes/dark-infernal.sh

Embrace the darkness using both industrial machinery aesthetics and occult symbolism.

Features:

• Color Scheme: Blood reds, crimson, rust, iron blacks, steel greys
• Special Functions:
  • ⚙ System load indicator (⚙→⚡→⚠→☠)
  • Random corruption glitches (5% chance)
  • Infernal time markers at 13:13, 03:33, 00:00
• Git Symbols:
  • ⸸ = Chaos/uncommitted
  • ⛧ = Controlled/clean
• Dark Elements: Pentagrams, skulls, industrial symbols

Variants:

• Default: Full infernal machine with pentagrams
• Industrial: Pure mechanical, no occult
• Satanic: Heavy occult symbolism with ₆₆₆
• Corrupted: Digital decay with glitch effects
• Minimalist: Simple but sinister

Special Commands:

• darkinfo - Display system status in themed format
• gdestroy - Alias for git reset --hard

---

Configuration

Common Customizations

Change Colors

Each theme defines colors using 256-color codes. Modify these variables:

CYAN='\[\033[38;5;51m\]'    # Change 51 to any color code
MAGENTA='\[\033[38;5;213m\]' # Change 213 to any color code

Modify Git Symbols

Edit the git_prompt() function in each theme:

status_symbol="YOUR_SYMBOL"  # For uncommitted changes
status_symbol="YOUR_SYMBOL"  # For clean state

Adjust Time Format

Change the date format in the PS1 variable:

$(date +%H:%M:%S)  # Current: HH:MM:SS
$(date +%I:%M%p)   # Alternative: 12-hour with AM/PM
$(date +%H:%M)     # Minimal: HH:MM only

Explore The Prompts

Each prompt may have a few extras (on-theme aliases, etc), so look through the themes for little surprises.

Terminal Configuration

For best results, configure your terminal:

1. Font: Use a font with good Unicode support (e.g., Fira Code, JetBrains Mono)
2. Colors: Set terminal background to match theme:
   • Cyberpunk: Deep black (#0a0a0a)
   • Pagan: Dark earth (#1a1610)
   • Dark Machine: Void black (#080808)

Troubleshooting

Common Issues

Escape sequences showing literally

Problem: Seeing \[\] in your prompt Solution: Ensure you're using bash (not sh) and source the file properly

Missing symbols/boxes

Problem: Seeing □ instead of special characters Solution: Install a font with full Unicode support

Git status not showing

Problem: Git information missing from prompt Solution: Ensure you're in a git repository (.git folder exists)

Requirements

• Bash 4.0 or higher
• Git (for repository status)
• Terminal with 256-color support
• Unicode-capable font

License

MIT License - feel free to use and modify these prompts for your own use.

Acknowledgments

• Inspired by the bash prompt community
• Special thanks to Unicode Consortium for the extensive symbol sets
• Git prompt functions adapted from git-prompt.sh

Gallery

Cyberpunk theme, with a few variants uncommented:

Pagan-Celtic theme, with a few variants uncommented:

Dark Infernal theme, with a few variants uncommented:

Links

• Bash Prompt HOWTO
• 256 Color Chart
• Unicode Symbol Reference

---

Tossed together by Simple Nomad (thegnome @ nmrc.org) during 2025, for no apparent reason.