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

Terminal ASCII banner generator — because plain text is boring.

✨ Screenshot

---

▶️ Demonstration

👆 Click the picture to watch the demo (redirects to YouTube)

---

🎨 What is Bangen?

Bangen is a colorful, animated terminal banner generator built on pyfiglet and rich. Type a word, pick a font and a color, and watch your terminal come alive with big bold ASCII art — optionally animated, optionally saved.

No config files. No setup ceremony. Just run and render.

---

✨ Features

Feature	Description
🖋️ Multiple Fonts	Choose from a curated preset list or type any pyfiglet font name
🌈 Five Colors	cyan · red · green · yellow · magenta
📦 Panel Display	Clean bordered panel with optional title via rich
🎞️ Line Animation	Optional line-by-line reveal for dramatic effect
💾 Save to File	Export your banner to a .txt file instantly
💬 Interactive Prompts	Clear, guided terminal UI — no arguments needed

---

🛠️ Requirements

• 🐍 Python 3.9+

---

🚀 Installation

# Clone the repo
git clone https://github.com/pro-grammer-SD/bangen.git
cd bangen

# Set up a virtual environment
python -m venv .venv
.\.venv\Scripts\activate   # Windows
# source .venv/bin/activate  # Linux / macOS

# Install
pip install .
# Or, for development:
# pip install -e .

---

▶️ Usage

bangen

Bangen will walk you through everything interactively — text, font, color, animation, and save options. No flags, no config. Just vibes.

---

🖼️ Example Output

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

Rendered above: BANGEN in ansi_shadow font, cyan color, inside a rich panel.

---

🗂️ Project Layout

bangen/
├── 🐍 bangen.py          # Main application
├── 📦 pyproject.toml      # Packaging + dependencies
├── 📄 LICENSE            # MIT license
├── 🙈 .gitignore         # Python defaults
├── 💁‍♂️ README.md          # Project information
├── 🌟 demo.mp4           # A demonstration of the app
└── 📸 screenshot.png     # A screenshot of the app

---

💡 Tips

🔠 Want more fonts? When prompted for a font, type any valid pyfiglet font name directly. Explore the full list with:

import pyfiglet
print(pyfiglet.FigletFont.getFonts())

---

📜 License

MIT — do whatever you want with it. See LICENSE for the legal bits.

---

Made with 🖤 and too much terminal time · pro-grammer-SD