asciiimg

Convert images to terminal-friendly ASCII using English letters and numbers only.

Installation

Using Cargo:

cargo install asciiimg

Or clone and build manually:

git clone https://github.com/GNDFR/asciiimg.git
cd asciiimg
cargo build --release

Usage

asciiimg <input_file> [OPTIONS]

Options

• -o, --output <PATH>: Output file path (default: print to stdout)
• -w, --width <WIDTH>: Output width in characters (default: terminal width)
• --ascii-ramp <STRING>: ASCII characters to use for grayscale
• -i, --invert: Invert brightness
• --brightness <FLOAT>: Brightness multiplier (default: 1.0)
• --contrast <FLOAT>: Contrast multiplier (default: 1.0)

Examples

Basic usage:

asciiimg image.png --width 80

Save to a file:

asciiimg image.png --output art.txt

Invert brightness:

asciiimg image.png -i

Reading from stdin:

cat image.png | asciiimg - --width 100

License

This project is licensed under the MIT License.