✨ DBD (Directory Banner Display) is a custom plugin for Oh-My-Zsh that displays eye-catching banners whenever you change directories (cd). It uses figlet and lolcat to generate colorful banners, giving your terminal a stylish touch.

✅ Custom Banners: Show directory names in customizable banners.
✅ Custom Fonts: Supports any .flf font from figlet's library.
✅ Random Mode: Random fonts and colors every time you change directories.
✅ Easy Configuration: Use dbd-config to tweak settings on the fly.
✅ Font Converter: Convert .ttf and .otf fonts into .flf for use with figlet.
✅ Auto-Installer: Comes with a setup script that handles everything.

These are automatically installed by dbd-setup.sh if missing:

• figlet: Generates the banners.
• lolcat: Adds rainbow colors (optional).
• toilet: Alternative banner generator (optional).
• otf2bdf and bdf2psf: Convert modern fonts into figlet-compatible .flf.

Just run this:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/BlackFlame444/dpd-plugin/refs/heads/main/dbd-setup.sh)"

1️⃣ Clone the repo into your Oh-My-Zsh custom plugins folder:

git clone https://github.com/BlackFlame444/dbd-plugin.git ~/.oh-my-zsh/custom/plugins/dbd-plugin

2️⃣ Run the setup script directly:

~/.oh-my-zsh/custom/plugins/dbd-plugin/dbd-setup.sh

3️⃣ Reload your shell:

source ~/.zshrc

When you change directories, the banner displays automatically:

cd ~/projects

Want to show the banner manually?

dbd-show

You can configure everything via the dbd-config command:

dbd-config set font <font_name>  # Set the default font
dbd-config set color <color>     # Set the default color
dbd-config set random on         # Enable random mode
dbd-config show                   # View current configuration

Easily convert .ttf and .otf fonts to figlet .flf using:

dbd-font /path/to/font.ttf

See all fonts installed:

dbd-list-fonts

Drop your .flf files directly into:

dbd-ff https://github.com/user/figlet-fonts.git

dbd-plugin/
├── dbd.plugin.zsh          # Main plugin loader
├── dbd-config.zsh          # User configuration
├── dbd-setup.sh            # Installation script
└── /usr/local/share/figlet # System font directory (300+ fonts)

    █ █         █            █              ▀
▄▀▀▀█ █▀▀▀▄ ▄▀▀▀█      ▄▀▀▀▄ █ █   █ ▄▀▀▀▄ ▀█  █▀▀▄
█   █ █   █ █   █ ▀▀▀▀ █   █ █ █   █ █   █  █  █  █
▀▄▄▄▀ ▀▄▄▄▀ ▀▄▄▄▀      █▄▄▄▀ █ ▀▄▄▄▀ ▀▄▄▄█ ▄█▄ █  █
                       █              ▄▄▄▀
📂 /.oh-my-zsh/custom/plugins/dbd-plugin

dbd-fonts  dbd-config.zsh  dbd-plugin.zsh

Run dbd-config anytime to change your style without editing files manually.

rm -rf ~/.oh-my-zsh/custom/plugins/dbd-plugin
sed -i '/dbd-plugin/d' ~/.zshrc
source ~/.zshrc

MIT License - Modify, share, and enjoy.

Developed by BlackFlame444
GitHub