# Bashrc Dotfiles β€” Global & Portable Bash Prompt Elegant, portable, and easy-to-install Bash prompt with seasonal palettes, time-aware emoji, and clean powerline structure. --- ## βœ… Requirements (Nerd Fonts) This prompt relies on Nerd Font glyphs for the rounded separators. ```bash bash dotfiles/install/install-nerdfont.sh ``` After install: - Set your terminal font to JetBrainsMono Nerd Font (or any Nerd Font) - Manual download: https://www.nerdfonts.com/font-downloads If you use a non‑Nerd font, the prompt falls back to ASCII/Unicode. --- ## πŸš€ Install ### 🐧 Linux / WSL (global, all users) 1) Clone the repo: ```bash git clone ``` 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 ``` 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 ```
Installer choices Linux/WSL: - PS1 only / Banner only / Both - PS1 modes: Single season, Dynamic season, Contest pack, Holidays pack, Custom pack - Dynamic season auto-switches by time of year (Spring: Mar–May, Summer: Jun–Aug, Autumn: Sep–Nov 14, Winter: Nov 15–Feb) - Layout order (day-time-user, user-time, time-user, day-time) for seasonal and contest modes macOS: - PS1 modes: Single season, Dynamic season, Contest pack, Holidays pack, Custom pack - Dynamic season auto-switches by time of year (same ranges as Linux) - Layout order (day-time-user, user-time, time-user, day-time) for seasonal and contest modes
--- ## ✨ Features - Two-line, powerline-style prompt - Seasonal palettes + time-based emoji accents - Smart path shortening (keeps home visible) - Status-colored prompt arrow - Works on Linux, WSL, and macOS - Per-user disable switch ---
What gets installed ### 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 - You can change the selection or remove PS1/banner by running the installer again ### macOS - Copies `ps1/ps1.sh` to `~/.config/ps1/ps1.sh` - Adds a source block in `~/.bashrc` and `~/.bash_profile`
---
PS1 module (when it runs) - 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) On Linux/WSL, a banner is also shown on login: - `figlet $(hostname) -c | lolcat` - `figlet -f digital "" -c | lolcat` - `landscape-sysinfo | lolcat` ### Punchline (global) The banner reads the punchline from: - `/etc/ps1-punchline` The install script prompts for a punchline and stores it in the file. You can also set it manually: ```bash echo "Your punchline" | sudo tee /etc/ps1-punchline >/dev/null ```
--- ## πŸŽ›οΈ Themes & Style Packs ### 🏁 Contest Pack The contest pack is a bold, DEFCON-ready set of five styles (Aurora, Neon, Forge, Circuit, Mono) with optional layout order. It always starts on a new line and ends with `@host - /path`. Note: This repo was built with AI assistance, and the contest pack itself is fully AI-authored. ---
Custom Pack (bold styles) Seven extra styles, built to be loud and expressive: - Radar: green scanline HUD - Synthwave: pink/cyan/orange glow blocks - Noir: near-black minimal + red path - Topo: elevation-style path segments - Glitch: jitter separators + neon - ArcticFire: icy blues into ember orange - AcidLime: black + electric green Custom styles add a small context badge when relevant (`ssh`, `ctr`, `git`).
---
Git Theme (details) The Git theme adds a repo-aware capsule on line 2 that only appears inside a Git repo. The branch name is wrapped as `⟦branch⟧`, and status emojis reflect state: - Clean: ✨ - Dirty: πŸ”¨ - Staged: πŸ“Œ - Untracked: 🧷 - Stashed: πŸ“¦ It uses the same two-block layout as Aurora, but focuses on signal and minimal noise for fast scanning. Use it when you want repo status on every command without a full VCS prompt. Git capsule switch: - `PS1_GIT=1` enables the git capsule on all themes - Git theme always shows it, regardless of `PS1_GIT`
---
Holidays Pack (themes) Holidays pack uses themed palettes + emojis and the contest layout order: - Christmas, Easter, Halloween, Valentine, Thanksgiving, New Year
--- ## 🧭 Theme Design Notes - **Aurora (seasonal):** calm hierarchy, subtle gradients, long-term readability - **Contest styles:** bold contrast and distinct silhouettes for instant recognition - **Custom pack:** experimental, high-signal variants for strong personal style - **Holidays:** themed colors + emojis without compromising legibility ---
Emoji palette Fixed times (all seasons): - Lunch 11:00–11:29 = πŸ₯ͺ - Dinner 16:00–16:59 = 🍲 Seasonal sets (sunrise / work): - Spring: 🌷 🌱 🐣 🌀 / 🌿 πŸͺ΄ 🐝 🌼 - Summer: 🌞 πŸ–οΈ πŸŒ… 🌀 / πŸ„ πŸ–οΈ 🚀 🌴 - Autumn: 🍁 πŸ‚ 🌫️ 🌦️ / πŸ‚ πŸ„ πŸŽƒ πŸͺ΅ - Winter: πŸ”οΈ 🌨️ ❄️ 🌌 / 🎿 ⛷️ πŸ‚ 🧊 Time slots: - Sunrise: 05:00–08:59 - Coffee: 09:00–10:59 - Work: 11:30–15:59 (unless lunch overrides) - Evening: 17:00–22:59 - Night: 23:00–04:59 Meaning: - Emoji is a light accent for time/season; it never replaces core info
--- ## πŸ—‚οΈ Repo Structure ```text . β”œβ”€β”€ .context.json β”œβ”€β”€ contest-styles.json β”œβ”€β”€ images/ β”‚ β”œβ”€β”€ bash-pallete.png β”‚ └── contest.png β”œβ”€β”€ dotfiles/ β”‚ β”œβ”€β”€ banner/ β”‚ β”‚ └── banner.sh β”‚ β”œβ”€β”€ ps1/ β”‚ β”‚ └── ps1.sh β”‚ └── install/ β”‚ β”œβ”€β”€ install-global-ps1.sh β”‚ β”œβ”€β”€ 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.
--- ## πŸ“Έ Seasonal Previews Placeholders for the four seasonal prompts (screenshots will be added here): - Winter: `images/season-winter.png` (placeholder) - Spring: `images/season-spring.png` (placeholder) - Summer: `images/season-summer.png` (placeholder) - Autumn: `images/season-autumn.png` (placeholder) Current combined palette reference:

--- ## πŸ› οΈ 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