ASCII Art Generator

Transform Text Into Art — One Character at a Time

About

ASCII Art Generator is a command-line tool built in Go that converts any string into a large-scale graphic representation using ASCII characters. Whether it's letters, numbers, or special characters — this program brings your text to life in the terminal.

 _    _          _   _          
| |  | |        | | | |         
| |__| |   ___  | | | |   ___   
|  __  |  / _ \ | | | |  / _ \  
| |  | | |  __/ | | | | | (_) | 
|_|  |_|  \___| |_| |_|  \___/  

Key Features

• Full support for letters, numbers, spaces and special characters
• Multi-line output using \n for line breaks
• Clean 8-line character height for consistent formatting
• Covers all printable ASCII characters (32–126)

Getting Started

Installation

git clone <repository-url>
cd ascii-art

Usage

go run . [string]

Examples

# simple text
go run . "HelloWorld"

# multi-line output
go run . "Hello\nThere"

# adding blank lines between blocks
go run . "Hello\n\nThere"

# special characters
go run . "{Hello There}"

# mixing numbers and letters
go run . "1Hello 2There"

Testing

Run the test suite to verify everything works as expected:

go test -v

Project Structure

ascii-art/
├── main.go          — core program logic
├── main_test.go     — unit tests
├── go.mod           — Go module definition
├── standard.txt     — ASCII art character templates
└── README.md        — project documentation

Under the Hood

1. The program accepts a string input from the command line
2. It reads standard.txt, which stores a pre-built ASCII art template for every printable character
3. Each character occupies 8 lines of art separated by a newline delimiter
4. Characters are located using the formula: (ASCII value - 32) * 9 + 1
5. The output is assembled row by row, printing each character's art side by side to form the final result

Built With

• Go — using only standard library packages

Authors

• Adeleke Victor
• Moses Caleb
• Ogunrotimi Damilola

---

Crafted as part of the 01-Edu curriculum — where code meets creativity.