Chargrill

Chargrill is an image-to-ASCII art generator that turns your high-definition images into beautifully low-resolution text masterpieces. Give it a picture, pick a gradient, and watch it roast your pixels into something your GPU would cry about.

Installation

Note

Chargrill is published on crates.io. To install it, you need to have Rust and Cargo installed on your system.

Install Chargrill using Cargo:

cargo install chargrill

Usage

Run Chargrill as:

chargrill "path_to_image_file"

Specify target width (default = 100) of the generated ASCII representation:

chargrill --width 420 images/cat_photo.jpeg

or use the shorthand:

chargrill -w 420 images/cat_photo.jpeg

Specify a character gradient. For now, you can't specify your own gradient and instead have to use one of the predefined ones:

chargrill --gradient code-page437 images/waifu.png

or use the shorthand:

chargrill -g minimalist -w 160 images/waifu.png

To see the available gradients and other options:

chargrill --help

or use the shorthand:

chargrill -h

Examples

normal
less-normal
minimalist
code-page437
weird