ASCIIPIC is a high-performance command-line tool written in Go that converts images into ASCII art. It supports true-color terminal output and includes a specialized PNG exporter that applies a background luminosity effect, producing vibrant, high-contrast results suitable for sharing.
Renders ASCII art in the terminal using 24-bit ANSI color codes, preserving the original image's color palette.
Exports ASCII art to PNG with a custom glow rendering engine. This engine fills the background of each character cell with a dimmed version of the image color, preventing exported art from appearing too dark or washed out.
Includes 15 character sets ranging from classic ASCII to Braille patterns, block elements, and mathematical symbols.
Complete control over output width, font size for PNG export, and brightness adjustment.
Supports JPEG and PNG input files.
- Go 1.18 or higher
go install github.com/thesfb/asciipic@latestgit clone https://github.com/thesfb/asciipic.git
cd asciipic
go build -o asciipic main.go./asciipic -input image.jpg./asciipic -input image.jpg -color -width 100./asciipic -input image.jpg -png -color -output result.png -width 200Using the Braille character set with enhanced brightness:
./asciipic -input image.jpg -png -color -charset e -width 300 -brightness 130 -output braille_art.png| Flag | Type | Default | Description |
|---|---|---|---|
-input |
string | "" |
Path to the input image file (required). |
-output |
string | ascii-art.png |
Path for the exported PNG file. |
-width |
uint | 80 |
Width of the output in characters. |
-color |
bool | false |
Enable true color output (ANSI for terminal, RGB for PNG). |
-png |
bool | false |
Enable PNG export mode. |
-charset |
string | a |
Select character set (a–o). |
-fontsize |
int | 8 |
Font size in pixels for PNG export. |
-brightness |
int | 110 |
Brightness percentage (50–200). |
a: Classic ASCIIb: Blocksc: Dotsd: Vertical Barse: Braillef: Numbersg: Lettersh: Slashesi: Punctuationj: Mixed Blocksk: Advanced Braillel: Circle Fillm: Box Drawingn: Dot Sizeso: Math Symbols
github.com/golang/freetypegithub.com/nfnt/resizegolang.org/x/image
Distributed under the MIT License. See LICENSE for details.

