🚀 Banner CLI - Modern ASCII Art Generator

🌐 Select your language / Chọn ngôn ngữ của bạn:

🇺🇸 English

🇻🇳 Tiếng Việt

🇺🇸 English

🌟 Introduction

Banner CLI is a powerful Node.js-based tool that allows you to generate stunning ASCII banners with advanced styling.

It goes beyond simple ASCII generation by supporting:

🎨 Gradient, Rainbow, Neon color systems
🧱 Layout effects (Box, Double Border, Rounded, Shadow)
⚡ Glitch text effects
📦 Export to multiple programming languages (JavaScript, Python, C#, etc.)

Perfect for:

CLI tools
Discord bots
Terminal branding
Developer portfolios

🛠 Installation

npm install

⚠ Requires Node.js >= 16

💻 Usage (Non-Interactive Mode)

🔹 Normal Command

node src/index.js

Run everything instantly via CLI arguments (no prompts required).

🔹 Basic Command

node src/index.js "Your Text" --style <preset> --export --exportLang <language>

🔹 Run the generated file

node banner.js

🔹 Examples

Hacker style + export Python

node src/index.js "JS-ARMOR" --style hacker --export --exportLang python --exportVar my_banner

Neon style + center align

node src/index.js "WELCOME" --style neon --align center

Retro style + export JavaScript

node src/index.js "NODEJS" --style retro --export --exportLang javascript

Preset	Vibe	Font	Colors	Effect
`hacker`	Green code-rain Matrix vibes	`Ghost`	gradient `#00ff66 → #003311`	shadow
`neon`	Pink → purple cyberpunk glow	`Slant`	neon gradient `#ff3df1 → #7b2dff` (bold)	none
`retro`	Yellow → orange in a box	`Chunky`	gradient `#ffd700 → #ff6a00`	box
`minimal`	Plain white, clean and quiet	`Standard`	single `white`	none
`glitch`	Corrupted, jittery, doom text	`Doom`	rainbow	glitch
`ocean`	Calming deep-blue gradient	`ANSI Shadow`	gradient `#00d4ff → #0066ff → #003a9b`	none
`fire`	Red → orange → yellow flame	`Big`	gradient `#ff0000 → #ff8800 → #ffee00`	shadow

📂 Project Structure

src/
├── index.js     # CLI entry point, argument parser & main flow
├── prompt.js    # Interactive CLI (optional mode)
├── preview.js   # Render pipeline (font → effect → color → align)
├── font.js      # Figlet integration & font manager
├── color.js     # ANSI colors, gradient, neon logic
├── effect.js    # Box, shadow, glitch, layout effects
├── codegen.js   # Multi-language export engine (10+ languages)
├── file.js      # File writing handler
├── preset.js    # Preset definitions
└── i18n.js      # Multi-language support (EN / VI)

Example outputs

banner.js (from node bin/banner-cli.js "Hi" --style neon --export --export-lang javascript --export-var greeting)

// Generated by banner-cli
const greeting = "\x1b[1m\x1b[38;2;255;61;241m \x1b[39m...    __  ___ ...\x1b[22m";

console.log(greeting);

export default greeting;

banner.py

# Generated by banner-cli
greeting = """\x1b[1m\x1b[38;2;255;61;241m ...    __  ___ ...\x1b[22m"""

if __name__ == "__main__":
    print(greeting)

banner.go

// Generated by banner-cli
package main

import "fmt"

const greeting = "\x1b[1m\x1b[38;2;255;61;241m ...    __  ___ ...\x1b[22m"

func main() {
    fmt.Println(greeting)
}

banner.sh

#!/usr/bin/env bash
# Generated by banner-cli
GREETING=$'\e[1m\e[38;2;255;61;241m ...    __  ___ ...\e[22m'

printf '%s\n' "$GREETING"

⭐ At 100 Stars

🌐 Web Dashboard (GUI version)
🌍 More export languages:
- Kotlin
- Swift
- Lua
🎭 Custom font upload (.flf support)

🤝 Contributing

Feel free to:

Open Issues
Submit Pull Requests
Suggest new presets or features

⭐ Support

If you like this project, give it a ⭐ It helps the project grow!

🇻🇳 Tiếng Việt

🌟 Giới thiệu

Banner CLI là một công cụ mạnh mẽ chạy trên nền Node.js giúp bạn tạo ra các banner ASCII đẹp mắt với nhiều hiệu ứng nâng cao.

Không chỉ là ASCII thông thường, tool hỗ trợ:

🎨 Gradient, Rainbow, Neon
🧱 Hiệu ứng khung (Box, Double, Rounded, Shadow)
⚡ Glitch text
📦 Export ra nhiều ngôn ngữ (JavaScript, Python, C#, ...)

Phù hợp cho:

CLI tools
Bot Discord
Branding terminal
Portfolio dev

🛠 Cài đặt

npm install

⚠ Yêu cầu Node.js >= 16

💻 Cách sử dụng (Không cần tương tác)

🔹 lệnh chạy bằng prompt

node src/index.js

Chạy CLI với tham số → tool tự xử lý toàn bộ

🔹 Cú pháp cơ bản

node src/index.js "Nội dung" --style <preset> --export --exportLang <ngôn_ngữ>

🔹 Chạy file đã đc tạo

node banner.js

🔹 Ví dụ

Hacker + export Python

node src/index.js "JS-ARMOR" --style hacker --export --exportLang python --exportVar my_banner

Neon + căn giữa

node src/index.js "WELCOME" --style neon --align center

Retro + export JavaScript

node src/index.js "NODEJS" --style retro --export --exportLang javascript

Preset	Phong cách	Font	Màu sắc	Hiệu ứng
`hacker`	Style hacker xanh lá kiểu Matrix	`Ghost`	gradient `#00ff66 → #003311`	shadow
`neon`	Cyberpunk hồng → tím phát sáng	`Slant`	neon gradient `#ff3df1 → #7b2dff` (bold)	none
`retro`	Vibe cổ điển vàng cam có khung	`Chunky`	gradient `#ffd700 → #ff6a00`	box
`minimal`	Đơn giản, trắng, nhìn sạch sẽ	`Standard`	màu đơn `white`	none
`glitch`	Kiểu lỗi chữ, méo mó, hơi “ma”	`Doom`	rainbow	glitch
`ocean`	Tông xanh biển dịu mắt, chill	`ANSI Shadow`	gradient `#00d4ff → #0066ff → #003a9b`	none
`fire`	Lửa đỏ → cam → vàng cháy rực	`Big`	gradient `#ff0000 → #ff8800 → #ffee00`	shadow

📂 Cấu trúc dự án

src/
├── index.js     # Entry CLI, xử lý tham số
├── prompt.js    # CLI interactive (nếu dùng)
├── preview.js   # Pipeline render
├── font.js      # Quản lý font ASCII (figlet)
├── color.js     # Xử lý màu & gradient
├── effect.js    # Hiệu ứng box, glitch, shadow
├── codegen.js   # Export code đa ngôn ngữ
├── file.js      # Ghi file
├── preset.js    # Preset styles
└── i18n.js      # Đa ngôn ngữ

Ví dụ output

banner.js (tạo từ lệnh node bin/banner-cli.js "Hi" --style neon --export --export-lang javascript --export-var greeting)

// Generated by banner-cli
const greeting = "\x1b[1m\x1b[38;2;255;61;241m \x1b[39m...    __  ___ ...\x1b[22m";

console.log(greeting);

export default greeting;

banner.py

# Generated by banner-cli
greeting = """\x1b[1m\x1b[38;2;255;61;241m ...    __  ___ ...\x1b[22m"""

if __name__ == "__main__":
    print(greeting)

banner.go

// Generated by banner-cli
package main

import "fmt"

const greeting = "\x1b[1m\x1b[38;2;255;61;241m ...    __  ___ ...\x1b[22m"

func main() {
    fmt.Println(greeting)
}

banner.sh

#!/usr/bin/env bash
# Generated by banner-cli
GREETING=$'\e[1m\e[38;2;255;61;241m ...    __  ___ ...\e[22m'

printf '%s\n' "$GREETING"

⭐ Khi đạt 100 stars

🌐 Web Dashboard (giao diện web)
🌍 Thêm ngôn ngữ:
- Kotlin
- Swift
- Lua
🎭 Hỗ trợ font custom (.flf)

🤝 Đóng góp

Bạn có thể:

Tạo issue
Gửi pull request
Đề xuất ý tưởng mới

⭐ Ủng hộ

làm ơn cho tui 1 star >.<

Name		Name	Last commit message	Last commit date
Latest commit History 35 Commits
src		src
README.md		README.md
package.json		package.json

Folders and files

Latest commit

History

Repository files navigation