███████╗ █████╗ ███╗ ██╗ ██████╗██╗ ██╗██████╗ █████╗ ███████╗██╗ ██╗
██╔════╝██╔══██╗████╗ ██║██╔════╝╚██╗ ██╔╝██╔══██╗██╔══██╗██╔════╝██║ ██║
█████╗ ███████║██╔██╗ ██║██║ ╚████╔╝ ██████╔╝███████║███████╗███████║
██╔══╝ ██╔══██║██║╚██╗██║██║ ╚██╔╝ ██╔══██╗██╔══██║╚════██║██╔══██║
██║ ██║ ██║██║ ╚████║╚██████╗ ██║ ██████╔╝██║ ██║███████║██║ ██║
╚═╝ ╚═╝ ╚═╝╚═╝ ╚═══╝ ╚═════╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝
Beautiful • Fast • Smart • Zero Bloat
🌐 Live Website: fancybash.netlify.app
- ✨ What is fancybash?
- 🌟 Feature Highlights
- 🚀 Quick Install
- 🗑️ Uninstall
- ⚙️ Font Setup
- 📟 Smart Prompt
- 🛠️ Command Reference
- 🏗️ Project Structure
- 🖥️ Zed IDE Settings
- 🤝 Contributing
- 📄 License
fancybash is a production-ready, opinionated Bash configuration designed for modern web developers. It replaces your dull terminal with a fully-featured, intelligent shell environment — without the overhead of frameworks like Oh My Zsh.
One file. One install. Zero drama.
Built by a developer, for developers — with Node.js, Bun, Git, and Linux workflows baked in.
| Feature | Description |
|---|---|
| ⚡ Lightning Fast | No heavy plugins or slow git parsing — stays snappy even on old hardware |
| 🛡️ 100% Safe Install | Never blindly overwrites .bashrc — creates a timestamped backup every time |
| 🔄 Idempotent | Running the installer multiple times is always safe — detects existing installs |
| 🌈 Dynamic Prompt | Rainbow colors, random emoji per folder type, git branch with dirty state indicator |
| 🟢 Node.js First-Class | Built-in nvm support, Node/NPM/Bun version display, and instant aliases |
| 🥐 Bun First-Class | bi, brd, brb, brs shortcuts — runs .ts files with zero config |
| 🔧 Single Config File | Everything lives in config.sh — easy to read, fork, and customize |
| 📦 Universal Uninstaller | uu — interactive fuzzy app remover with fzf, supports apt/snap/flatpak/AppImage |
| 🔁 Mega Updater | uup — updates OS + Snap + Flatpak + Bun + Node.js in one interactive command |
| 🌡️ System Health Prompt | CPU temp with color-coded alerts, disk space, load average, command timer |
| 🔑 Secret Key Generator | gen 32 — cryptographically secure random key generation via OpenSSL |
| 🗜️ Universal Extractor | ex — handles .zip, .tar.gz, .rar, .7z, .bz2 and more |
Requirements:
curl,bash— that's it.
For Bash (.bashrc):
bash <(curl -fsSL https://gist.githubusercontent.com/rihadjahanopu/a1c286e48b3ecee1a207c759279e352c/raw/install.sh)For Zsh (.zshrc):
zsh <(curl -fsSL https://gist.githubusercontent.com/rihadjahanopu/fa5874bf928c2416816b7092030f1f3b/raw/install.zsh)For PowerShell ($PROFILE):
Set-ExecutionPolicy Bypass -Scope Process -Force; iex (irm https://gist.githubusercontent.com/rihadjahanopu/54b3d3bf8aac456b1aa19a62ac76a993/raw/install.ps1)The installer will:
- ✅ Check for existing installation (safe to re-run)
- 💾 Create a timestamped backup of your current shell configuration
- 📥 Download and append the config with boundary markers
- 🔄 Automatically reload your shell
git clone https://github.com/rihadjahanopu/fancybash.git
cd fancybash
# For Bash:
cat config.sh >> ~/.bashrc
source ~/.bashrc
# For Zsh:
cat config.zsh >> ~/.zshrc
source ~/.zshrc
# For PowerShell:
.\install.ps1Cleanly removes only the fancybash block from your config file, leaving the rest untouched:
For Bash:
sed -i '/# >>> fancy-bashrc >>>/,/# <<< fancy-bashrc <<</d' ~/.bashrc && source ~/.bashrcFor Zsh:
sed -i '/# >>> fancy-zshrc >>>/,/# <<< fancy-zshrc <<</d' ~/.zshrc && source ~/.zshrcFor PowerShell:
$p = $PROFILE; (Get-Content $p -Raw) -replace '(?s)# >>> fancy-powershell >>>.*?# <<< fancy-powershell <<<\s*', '' | Set-Content $p💡 Your original config remains untouched — only the
fancybashblock wrapped in>>> / <<<markers is removed.
fancybash uses color emoji and Fira Code ligatures in the prompt. Follow these steps for the best experience:
sudo apt install fonts-noto-color-emojisudo apt install fonts-firacodesudo nano /etc/fonts/local.confPaste the following config:
<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
<alias>
<family>monospace</family>
<prefer>
<family>Fira Code</family>
<family>Noto Color Emoji</family>
</prefer>
</alias>
<alias>
<family>sans-serif</family>
<prefer>
<family>Noto Color Emoji</family>
</prefer>
</alias>
</fontconfig>fc-cache -fvecho -e "LANG=en_US.UTF-8\nLC_ALL=en_US.UTF-8\nLANGUAGE=en_US" | sudo tee /etc/default/locale
sudo locale-gen en_US.UTF-8
sudo update-locale
rebootfancybash renders a smart two-part prompt with contextual awareness:
🚀 myproject ← Emoji (auto by folder name) + colored folder
❯❯❯ ← Blinking cursor arrow (Line 2)
Prompt features include:
| Element | Description |
|---|---|
rand_emoji |
Folder-aware emoji — 🌐 for web, 🟢 for node, 🥐 for bun, 🐍 for py, random otherwise |
rand_color |
Rainbow color cycle on every prompt render |
parse_git_branch |
Shows branchname ❗ when working tree is dirty |
cpu_temp |
🟢 Green / 🟡 Yellow / 🔴 Red based on temperature thresholds |
disk_usage |
Shows free disk space on / |
load_avg |
System load average |
get_duration |
Shows ⏱️ Ns for any command taking longer than 1 second |
check_readonly |
Shows 🔒 when current directory is not writable |
pending_updates |
Shows 🆙 N if system packages need updating |
battery_info |
Shows battery % when available |
kernel_version |
Displays current kernel version |
By default, fancybash/fancyzsh renders a clean, minimalistic single-line prompt. However, all the dynamic system monitoring metrics listed above (such as CPU temp, disk space, active runtime versions) are already built-in and ready to be used.
You can modify or toggle the prompt layout to your liking by editing your shell configuration file (~/.bashrc or ~/.zshrc) and uncommenting/commenting the lines under the 🎯 TWO LINE PROMPT section:
# 💡 Uncomment these lines in your ~/.bashrc or ~/.zshrc if you want the full two-line prompt:
# PS1="\$(rand_emoji) \[\033[\$(rand_color)m\]\W\[\033[0m\] "
# PS1+="\$(folder_size) [🌿 \$(parse_git_branch)]\$(cpu_temp) \$(disk_usage) \$(load_avg) \$(get_duration) \$(check_readonly) \$(pending_updates)\n"
# PS1+="\$(node_version) │ \$(npm_version) │ \$(bun_version) │ \$(kernel_version) │ "
# PS1+="\$(time_date) │ \$(sys_info) │ \$(battery_info)\n"Feel free to customize, add, or remove any helper functions (like node_version, cpu_temp, etc.) from your configuration block to design your own custom layout!
Run
keepin your terminal to see this full reference at any time.
| Command | Action |
|---|---|
.. |
Go up one directory |
... |
Go up two directories |
.... |
Go up three directories |
dev |
Jump to ~/Development |
fr / ba / fu |
Jump to Frontend / Backend / Fullstack project folder |
fig / ar / de |
Jump to Figma / Archive / Dev folders |
des / doc / dow |
Jump to Desktop / Documents / Downloads |
| Alias | Expands To |
|---|---|
ni |
npm install |
nid |
npm install -D |
nr |
npm run |
nrd |
npm run dev |
nrb |
npm run build |
nrs |
npm run start |
bi |
bun install |
br |
bun run |
brd |
bun run dev |
brb |
bun run build |
brs |
bun run start |
html |
bun run index.html |
| Command | Description |
|---|---|
gi |
Initialize new git repository |
gs |
Git status (short format) |
ga |
Stage all files (git add .) |
gcm "msg" |
Commit with message |
gps / gpl |
Push / Pull from remote |
gl |
Pretty git log with graph |
gco <branch> |
Checkout branch |
gcb <name> |
Create & checkout new branch |
gd |
View diff |
gst / gsta / gpop |
Stash / Apply stash / Pop stash |
gwip "msg" |
Quick WIP commit + auto push to current branch |
gwip # Prompts for message, falls back to "Work in progress (Save Point)"
gwip "add auth middleware" # Custom message| Command | Description |
|---|---|
init |
Interactive project init — choose Bun or NPM, auto-creates .gitignore |
next |
Scaffold Next.js app (create-next-app) via Bun or NPM |
vite |
Scaffold Vite project with optional Tailwind CSS v4 setup |
ui |
Install & init Shadcn/UI with optional component selection |
css |
Auto-detect package manager and install Tailwind CSS + clsx + tailwind-merge |
run |
Interactive JS/TS file runner via Bun |
pg |
Generate package.json for current project |
vite
# ⚡ Setup Vite with:
# 1) Bun 2) NPM
# Add Tailwind CSS v4? (y/n): y
# → Installs packages, creates src/index.css with @import "tailwindcss"| Command | Description |
|---|---|
uup |
Mega Updater — interactive fzf menu: OS core, Snap, Flatpak, Bun, Node.js, NPM, deep clean |
uu |
Universal Uninstaller — fuzzy search across apt/snap/flatpak/AppImage, shows size & install date |
uc |
Universal system clean (cache, orphans, logs) |
update |
Update system packages |
clean |
Clean apt cache & remove orphaned packages |
setuppc |
Bootstrap a new PC with all essential developer tools |
rt |
Install Node.js (via nvm), Bun, and Deno |
ut |
Setup optimized CLI tooling for the PC |
rel |
Reload .bashrc configuration |
myip |
Show your public IP address |
iploc |
Show IP + city/region/org info via ipinfo.io |
ports |
List all open ports |
kp <port> |
Kill the process running on a given port |
serve |
Start a local Python HTTP server in current directory |
rn |
Rename all files — removes special characters (@, %, *, #) |
uup
# Opens fzf menu:
# 0. ALL_MAINTENANCE_TASKS
# 1. Core_System_Update
# 2. Snap_Package_Refresh
# 3. Flatpak_Cleanup_Update
# 4. Bun_Runtime_Upgrade
# 5. Node.js_LTS_Sync
# 6. Global_NPM_Update
# 7. Full_System_Deep_Cleanuu
# Opens fzf picker with all installed apps (apt + snap + flatpak + AppImage)
# Columns: IDX | NAME | SOURCE | VERSION | SIZE | INSTALL DATE
# TAB to multi-select, ENTER to purge with animated progress bar
# Automatically runs turbo-clean after removal| Command | Description | Example |
|---|---|---|
mkd <name> |
Create directory and cd into it |
mkd my-app |
rmd <name> |
Force remove directory recursively | rmd old-build |
rmf <file> |
Safely remove a file | rmf config.bak |
bak <file> |
Create a .bak backup copy |
bak .env |
trash <file> |
Move file to system trash (safe delete) | trash temp.log |
ex <archive> |
Extract any archive format | ex project.tar.gz |
ff <name> |
Find file by name (skips node_modules, .git) |
ff tsconfig |
gen <len> |
Generate a cryptographically secure secret key | gen 32 |
h <word> |
Search command history | h docker |
to |
Open current directory in VS Code | |
v |
Play video in terminal | |
c / cls |
Clear the terminal screen |
.tar.bz2 · .tar.gz · .bz2 · .rar · .gz · .tar · .zip · .7z
fancybash/
├── install.sh # Bash installer with spinner & backup
├── install.zsh # Zsh installer with spinner & backup
├── install.ps1 # PowerShell installer with backup & profile integration
├── config.sh # Bash configuration, aliases, prompt, colors
├── config.zsh # Zsh configuration, aliases, prompt, colors
├── config.ps1 # PowerShell configuration, aliases, prompt, colors
├── web/
│ ├── index.html # Landing page (fancybash.netlify.app)
│ ├── style.css # Design system & responsive styles
│ └── main.js # Interactive tabs, animations, copy buttons
├── zed/
│ └── install-settings.sh # Zed IDE settings installer (Flatpak + native)
├── README.md # You are here
└── LICENSE # MIT — free to use, fork, and modify
install.sh
├── check_deps() # Verifies curl & grep are present
├── check existing install # Exits early if already installed (idempotent)
├── backup .bashrc # Creates ~/.bashrc.backup.YYYYMMDD_HHMMSS
├── spinner() # Animated download progress
├── download config.sh # Fetched from GitHub Gist
├── validate response # Guards against HTML error pages
├── append to .bashrc # Wrapped in >>> / <<< markers
└── source ~/.bashrc # Auto-reloads the shell
Install a fully-configured settings.json for the Zed editor — works for both the Flatpak and native installations in one shot.
bash <(curl -fsSL https://gist.githubusercontent.com/rihadjahanopu/bb56371f87793c21a8fad4e4b9815a9b/raw/install-settings.sh)The script will:
- 💾 Back up any existing
settings.jsonwith a timestamp - ✍️ Write the new config to both paths:
~/.var/app/dev.zed.Zed/config/zed/settings.json(Flatpak)~/.config/zed/settings.json(native)
- ✅ Print a confirmation for each path
Restart Zed after running the script for all settings to take effect.
| Setting | Value |
|---|---|
| Theme | BlackFox (dark) / Everforest Light Hard (light) |
| Buffer Font | Cascadia Code 22px (fallback: JetBrains Mono, Fira Code) |
| UI Font | JetBrains Mono 20px |
| Terminal Font | JetBrains Mono 22px + FiraCode Nerd Font fallback |
| Tab Size | 2 spaces |
| Soft Wrap | editor_width |
| Autosave | on_focus_change |
| Keymap | VSCode |
| Inlay Hints | Enabled with background |
| Inline Diagnostics | Enabled |
| Minimap | auto |
| Prettier | Allowed |
| Git Inline Blame | With commit summary |
Contributions are welcome! Whether it's a new alias, a bug fix, or a feature idea:
- Fork the repository
- Create a feature branch:
git checkout -b feat/my-feature - Commit your changes:
gcm "feat: add my feature"(or regulargit commit) - Push and open a Pull Request
Please keep functions focused, well-commented, and compatible with Bash 4+.
MIT © Rihad Jahan Opu
If fancybash saves you time daily, give it a ⭐ — it helps others find it!
Made with ❤️ in Bangladesh
© 2026 Rihad Jahan Opu. All rights reserved.