fancybash

          ███████╗ █████╗ ███╗   ██╗ ██████╗██╗   ██╗██████╗  █████╗ ███████╗██╗  ██╗
          ██╔════╝██╔══██╗████╗  ██║██╔════╝╚██╗ ██╔╝██╔══██╗██╔══██╗██╔════╝██║  ██║
          █████╗  ███████║██╔██╗ ██║██║      ╚████╔╝ ██████╔╝███████║███████╗███████║
          ██╔══╝  ██╔══██║██║╚██╗██║██║       ╚██╔╝  ██╔══██╗██╔══██║╚════██║██╔══██║
          ██║     ██║  ██║██║ ╚████║╚██████╗   ██║   ██████╔╝██║  ██║███████║██║  ██║
          ╚═╝     ╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝   ╚═╝   ╚═════╝ ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝

⚡ The Ultimate Bash Environment for Modern Developers

Beautiful • Fast • Smart • Zero Bloat

🌐 Live Website: fancybash.netlify.app

• ✨ What is fancybash?
• 🌟 Feature Highlights
• 🚀 Quick Install
• 🗑️ Uninstall
• 🦄 Zsh Setup Guide
• ⚙️ Font Setup
• 📟 Smart Prompt
• 🎨 Prompt Themes
  • 🖼️ Preview All 55 Themes
  • ⚡ Switch Themes
  • 📋 All 55 Themes
• 🛠️ Command Reference
  • 📂 Navigation
  • 📦 Package Managers
  • 🌿 Git Shortcuts
  • 🔧 Project Setup
  • ⚙️ System Tools
  • 🔨 Utilities
  • 🚀 Interactive Utilities (GUM & FZF)
    • 📋 Todo Manager
    • 📝 Notes Manager
    • 🎬 FFmedia Multimedia Suite
    • 🔀 Other GUM / FZF Utilities
  • 🐳 Docker & Containers
    • 📊 Dashboard & Monitoring
    • ⚡ Service Control
    • 🔄 Container Lifecycle
    • 🐛 Debugging & Building
    • 🧩 Docker Compose
    • 🧪 Quick Test Sandboxes
    • 🧠 Advanced Functions
  • 🐘 PostgreSQL
  • 💎 Prisma ORM
• 🏗️ Project Structure
• 🖥️ Zed IDE Settings
• 🐧 Linux App Ecosystem
• 🤝 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.

Requirements: curl, bash — that's it.

Auto-detects your OS (Linux/macOS) and active shell (Bash/Zsh/Fish/PowerShell) automatically:

curl -fsSL https://github.com/raw/rihadjahanopu/fancybash/refs/heads/main/i.sh | bash

bash <(curl -fsSL https://github.com/raw/rihadjahanopu/fancybash/refs/heads/main/install.sh)

zsh <(curl -fsSL https://github.com/raw/rihadjahanopu/fancybash/refs/heads/main/install.zsh)

fish <(curl -fsSL https://github.com/raw/rihadjahanopu/fancybash/refs/heads/main/install.fish)

For PowerShell ($PROFILE):

🤖 Universal smart installer — auto-detects if you're in PowerShell or CMD:

irm https://raw.githubusercontent.com/rihadjahanopu/fancybash/refs/heads/main/i.ps1 | iex

The installer will:

1. ✅ Check for existing installation (safe to re-run)
2. 💾 Create a timestamped backup of your current shell configuration
3. 📥 Download and append the config with boundary markers
4. 🔄 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.bat

# For Fish:
cat config.fish >> ~/.config/fish/config.fish
source ~/.config/fish/config.fish

Cleanly removes only the fancybash block from your config file, leaving the rest untouched:

Automatically detects your OS (Linux/macOS) and shell configuration (.bashrc / .zshrc / .config/fish/config.fish):

curl -fsSL https://github.com/raw/rihadjahanopu/fancybash/refs/heads/main/u.sh | bash

fish <(curl -fsSL https://github.com/raw/rihadjahanopu/fancybash/refs/heads/main/uninstall.fish)

For PowerShell ($PROFILE):

⚠️ Run only ONE of these — do NOT run powershell -c inside a PowerShell window!

💡 Your original config remains untouched — only the fancybash block wrapped in >>> / <<< markers is removed.

Install Zsh, set it as your default shell, and supercharge it with syntax highlighting and autosuggestions — no framework needed.

For Ubuntu/Debian-based systems:

sudo apt update && sudo apt install git zsh -y

Check the installed version, then set Zsh as your default shell. Log out and back in for this to take effect.

zsh --version
chsh -s $(which zsh)

fancybash (config.zsh) automatically loads plugins if they are present in the ~/.zsh/ directory.

mkdir -p ~/.zsh

Clone both plugins directly — no plugin manager required.

git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ~/.zsh/zsh-syntax-highlighting
git clone https://github.com/zsh-users/zsh-autosuggestions.git ~/.zsh/zsh-autosuggestions

Open a new terminal window. fancybash will auto-source the plugins and everything will work automatically!

fancybash uses color emoji and Fira Code ligatures in the prompt. Follow these steps for the best experience:

sudo apt install fonts-noto-color-emoji

sudo apt update && sudo apt install -y fonts-firacode fonts-cascadia-code

sudo nano /etc/fonts/local.conf

Paste 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 -fv

echo -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
reboot

fancybash 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:

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!

fancybash ships with 55 world-class prompt themes inspired by the best designs from Oh My Zsh, Oh My Posh, Starship, Spaceship, and modern terminal communities. Every theme works on Bash, Zsh, and Fish with full color and emoji support.

# Open interactive scrollable gallery — scroll with ↑↓ / PageUp / PageDown
fancy preview

# Same as above:
fancy list

The gallery opens in a less-powered pager showing all 55 themes numbered [1/55] through [55/55] with full ANSI colors. Press q to exit.

# Interactive picker (gum or fzf UI — arrow keys to select)
fancy

# Switch directly by name
fancy catppuccin
fancy tokyonight
fancy dracula
fancy cyberpunk
fancy starship
fancy matrix
fancy gruvbox
fancy rosepine
fancy kanagawa
fancy nightowl

# Theme is saved to ~/.fancybash_theme and persists across sessions

Run keep in your terminal to see this full reference at any time.

gwip                         # Prompts for message, falls back to "Work in progress (Save Point)"
gwip "add auth middleware"   # Custom message

vite
# ⚡ Setup Vite with:
# 1) Bun  2) NPM
# Add Tailwind CSS v4? (y/n): y
# → Installs packages, creates src/index.css with @import "tailwindcss"

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_Clean

uu
# 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

.tar.bz2 · .tar.gz · .bz2 · .rar · .gz · .tar · .zip · .7z

These utilities use gum and/or fzf for rich interactive UIs. They degrade gracefully: gum → fzf → plain read prompt — no tool is strictly required.

Tasks are saved to ~/.todo_list.txt.

Notes are stored in ~/.my_notes/<Category>/<Title>.md.

Viewer fallback: glow → bat → batcat → less Preview (fzf): bat → batcat → glow → cat Clipboard: wl-copy (Wayland) → xclip → xsel → pbcopy (macOS)

Interactive FFmpeg powerhouse driven by gum, fzf, and terminal prompts.

Interactive fuzzy directory navigator and multi-media file launcher with rich live preview and interactive keybindings.

Usage: cf [directory] (Defaults to current directory .)

Live Preview Features:

• 📁 Directories: Interactive folder tree (eza / tree / ls), Git active branch & recent 3 commits.
• 📄 Code & Text: Colorized syntax-highlighted preview via bat / batcat.
• 🖼️ Images: High-resolution terminal thumbnail preview powered by chafa.
• 📦 Archives: Previews .zip, .tar.gz, .7z, .rar contents without extracting.
• 🎵 Audio & Video: Audio metadata preview (mediainfo) and video quick actions.

| cf | Advanced FZF Dev Walk & Quick CD (see above) | | gbranch | Modern interactive Git branch manager (fzf / gum) | | fkill | Advanced interactive process killer (fzf / gum) | | fcd | Fuzzy quick directory jump (fzf / gum) |

Usage: gbranch [-l] [-r] [-a] [-h]

Replaces the basic git branch workflow with a fully interactive, fuzzy-searchable branch manager. Branches are sorted by most recently committed so your active branches are always at the top.

FZF Keybindings:

Preview Panel: Live commit graph with hash, author, date, and subject (git log --graph --color) shown on the right side as you navigate.

Smart Remote Checkout: Selecting origin/feature-xyz auto-strips the remote prefix and runs a clean git checkout feature-xyz.

Fallback chain: fzf → gum filter → numbered interactive menu (no dependencies required).

Usage: fkill [query] [port_number]

A full-featured process manager in your terminal. Processes are sorted by CPU usage (highest first) so resource-hungry processes are instantly visible.

FZF Keybindings:

Process Type Badges:

• [APP] — User GUI Applications (Chrome, VS Code, Slack, Discord, Firefox, VLC, Zed, Spotify, etc.)
• [SYS] — System Services & Daemons (root, systemd, dbus, background system workers)
• [USR] — User CLI, Scripts, and Shell processes (node, python, npm, bash, etc.)

Preview Panel: Shows Process Type, PID, User, CPU %, Memory %, Uptime, and open network ports for the highlighted process.

Port-based kill: fkill 3000 uses ss / lsof to identify the process on that port, confirms with you, tries SIGTERM first, then SIGKILL if needed.

Fallback chain: fzf (multi-select + preview) → gum filter (with confirm) → numbered interactive menu.

fancybash/
│
├── config.sh               # ★ Bash configuration — aliases, prompt, functions
├── config.zsh              # ★ Zsh configuration — full port of config.sh
├── config.fish             # ★ Fish configuration — full port of config.sh
├── config.ps1              # ★ PowerShell configuration
│
├── install.sh              # Bash installer — spinner, backup, idempotency guard
├── install.zsh             # Zsh installer — same logic, targets ~/.zshrc
├── install.fish            # Fish installer — targets ~/.config/fish/config.fish
├── install.ps1             # PowerShell installer — targets $PROFILE
├── install.bat             # Windows batch launcher — downloads & runs install.ps1
├── i.sh                    # Universal Linux/macOS installer — auto-detects shell
├── i.ps1                   # Universal Windows installer — auto-detects PS vs CMD
│
├── u.sh                    # Universal uninstaller (Linux/macOS) — auto-detects shell
├── uninstall.sh            # Bash uninstaller — removes fancybash block
├── uninstall.zsh           # Zsh uninstaller — removes fancybash block from ~/.zshrc
├── uninstall.fish          # Fish uninstaller — removes fancybash block from config.fish
├── uninstall.ps1           # PowerShell uninstaller — removes block from $PROFILE
│
├── web/                    # Static website (fancybash.netlify.app)
│   ├── index.html          #   Landing page (all-in-one)
│   ├── style.css           #   Design system — glassmorphism, dark theme
│   ├── main.js             #   Tabs, copy buttons, scroll animations
│   ├── docs.html           #   Full documentation page (v2.0)
│   ├── docs.css            #   Docs design system — dark theme, mobile responsive
│   ├── docs.js             #   Trie autocomplete, command explorer, terminal sim
│   ├── linux-setup.html    #   Linux App Ecosystem sub-page
│   ├── linux-setup.css     #   Styles for linux-setup page
│   ├── linux-setup.js      #   Search & filter logic for app browser
│   ├── favicon.svg         #   SVG favicon (scalable)
│   ├── favicon.ico         #   Legacy favicon
│   ├── favicon.png         #   PNG favicon
│   ├── favicon-16x16.png   #   16px favicon for browser tabs
│   ├── favicon-32x32.png   #   32px favicon for browser tabs
│   ├── apple-touch-icon.png#   iOS home screen icon
│   ├── og-image.png        #   Open Graph / social media preview image
│   ├── ascii-logo.png      #   ASCII art logo image asset
│   ├── robots.txt          #   Search engine crawl rules
│   └── sitemap.xml         #   XML sitemap for SEO
│
├── zed/
│   └── install-settings.sh #   Zed IDE settings installer (Flatpak + native)
│
├── .vscode/
│   ├── settings.json       #   Workspace editor settings
│   └── extensions.json     #   Recommended VS Code extensions
│
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.md          # Structured bug report form
│   │   ├── feature_request.md     # Feature request form
│   │   └── documentation.md       # Documentation issue form
│   ├── PULL_REQUEST_TEMPLATE.md   # PR checklist for contributors
│   ├── CODEOWNERS                 # Auto-assign reviewers per file/path
│   ├── FUNDING.yml                # GitHub Sponsors & Ko-fi button config
│   ├── dependabot.yml             # Monthly auto-update for GitHub Actions
│   ├── labeler.yml                # Path-based auto-label rules (bash/zsh/fish/web/docs)
│   └── workflows/
│       ├── greetings.yml          # Auto-greet first-time contributors
│       ├── label.yml              # Auto-labeler for pull requests (labeler@v5)
│       ├── shellcheck.yml         # CI — lint all shell scripts on push/PR
│       ├── stale.yml              # Auto-close inactive issues (60d) & PRs (30d)
│       └── summary.yml            # AI summary comment on new issues
│
├── README.md               # User-facing documentation (you are here)
├── wiki.md                 # Extended wiki & deep-dive reference
├── ARCHITECTURE.txt        # Contributor system design & code map
├── DSA.md                  # Data structures, algorithms & performance manual
├── CONTRIBUTING.md         # How to contribute — workflow, standards, PR guide
├── CHANGELOG.md            # Version history — all notable changes per release
├── SECURITY.md             # Vulnerability reporting policy & scope
├── CODE_OF_CONDUCT.md      # Community behavior standards
├── LICENSE                 # MIT — free to use, fork, and modify
├── .editorconfig           # Consistent editor settings (indent, charset, newlines)
├── .prettierrc             # Prettier config for web/ files
└── .prettierignore         # Files excluded from Prettier formatting

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.

curl -fsSL https://github.com/raw/rihadjahanopu/fancybash/refs/heads/main/zed/install-settings.sh | bash

The script will:

1. 💾 Back up any existing settings.json with a timestamp
2. ✍️ Write the new config to both paths:
   • ~/.var/app/dev.zed.Zed/config/zed/settings.json (Flatpak)
   • ~/.config/zed/settings.json (native)
3. ✅ Print a confirmation for each path

Restart Zed after running the script for all settings to take effect.

A curated list of essential applications for a Linux development and creative environment.

This project provides a clean, searchable, and filterable web interface to discover and browse recommended Linux applications. It includes categories for Creative Applications, IDEs, Browsers, System Tools, and Dev Tools.

Features:

• Searchable Interface: Instantly search for applications by name, category, or format.
• Dynamic Filters: Filter applications by categories like Creative, Development IDE, Browser, Dev Tools, and Tools.
• Package Formats: Displays the recommended package format (Flatpak, DEB, etc.) for each application with color-coded badges.

This page has been integrated into the main fancybash website and can be accessed via the Linux Apps link in the navigation menu.

The Docs page (docs.html) provides a full interactive documentation experience with:

• 🔍 Trie-based autocomplete search (O(k) prefix lookup)
• ⚡ Live Command Explorer — filter 60+ aliases by category
• 🛠️ Terminal Simulator — click chips to demo fancybash commands
• 🎨 4 Color Themes — Cyber Cyan, Matrix Green, Sunset Pink, Nord Frost
• 📱 Fully Mobile Responsive — hamburger drawer sidebar, touch-friendly layout

fancybash includes The Ultimate Docker Swiss Army Knife — a full suite of aliases and smart functions for managing containers, images, volumes, and services.

Spin up a temporary container that auto-deletes on exit:

dclean
# 🧹 Performing deep clean of all unused Docker resources...
# → docker system prune -a --volumes -f
# ✨ System optimization complete!

dbackup mydata backup.tar
# Backs up 'mydata' volume to backup.tar in current directory

💡 Tab Completion is built-in — press Tab after dsh, dlogs, dstop, dkill, drestart, dports, dwatch, dnetstat, dtop-proc to auto-complete container names. Same for drmi and dhist with image names.

fancybash includes a full suite of PostgreSQL aliases for managing your database service with minimal typing.

fancybash includes a complete suite of Prisma ORM aliases using the first letter of each word for maximum typing speed.

Pattern: n(px) + p(risma) + sub-command initials → Node | b(unx) + p(risma) + sub-command initials → Bun

Contributions are welcome! Whether it's a new alias, a bug fix, or a feature idea:

1. Fork the repository
2. Create a feature branch: git checkout -b feat/my-feature
3. Commit your changes: gcm "feat: add my feature" (or regular git commit)
4. Push and open a Pull Request

Please keep functions focused, well-commented, and compatible with Bash 4+.

• 🤝 CONTRIBUTING.md — Step-by-step guidelines for contributing to fancybash.
• 🆘 SUPPORT.md — Support options, quick troubleshooting, and issue reporting.
• 🗺️ ROADMAP.md — Future feature plans, version milestones, and community voting.
• 👥 AUTHORS.md — Core maintainers and project leadership.
• 🤝 CONTRIBUTORS.md — Community contributor recognition wall.
• 🌟 CODE_OF_CONDUCT.md — Community standards and covenant.
• 🔒 SECURITY.md — Vulnerability reporting policy.

MIT © Rihad Jahan Opu