Skip to content
MichaelAcostaDevPublic

About

A lightweight Bash CLI for generating customizable ASCII text banners in the terminal.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

Repository files navigation

TextForge

TextForge is a lightweight Bash CLI that renders large multi-line ASCII banners directly in the terminal. It is built for quick, dependency-free text rendering and supports multiple fonts, colors, alignment, and simple installation.

Features

  • Pure Bash implementation
  • Multiple built-in fonts
  • ANSI color support
  • Adjustable alignment, width, and spacing
  • Simple install and uninstall workflow
  • Works from any directory once installed

Requirements

  • Bash 4+
  • A Unix-like environment
  • Standard shell utilities already present on most Linux systems

Installation

1. Clone the repository

git clone https://github.com/MichaelAcostaDev/TextForge.git
cd TextForge

2. Install TextForge

./install.sh

3. Make sure the executable is on your PATH

If textforge is not found in your current shell, run:

export PATH="$HOME/.local/bin:$PATH"

Then verify the installation:

textforge --help
textforge --version

Usage

Basic banner

textforge "Hello"

Choose a font

textforge -f block "Hello"
textforge -f digital "Hello"
textforge -f banner "Hello"
textforge -f small "Hello"

List available fonts

textforge --list-fonts
textforge -l

View available colors

textforge --colors

Disable ANSI colors

textforge --no-color "Hello"

Show help and version

textforge --help
textforge --version
textforge -v

Uninstall

./uninstall.sh

This removes the installed TextForge executable and its shared resource directory under $HOME/.local/share/textforge.

Examples

WhatsApp Image 2026-09-24 at 17 13 25 WhatsApp Image 2026-09-24 at 17 13 25 (1)

License

This project is licensed under the MIT License.

Author

Michael Acosta / @MichaelAcostaDev

Disclaimer

Made with love in Bash 💕

About

A lightweight Bash CLI for generating customizable ASCII text banners in the terminal.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Contributors

Languages