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