termpix

Draw images in an ANSI terminal! Requires that your terminal can show ANSI colours, and uses a font that can show the 'bottom half block' character (▄).

Usage: termpix <file> [--width <width>] [--height <height>] [--max-width <max-width>] [--max-height <max-height>] [--true-color|--true-colour]

file can be any image file readable by the rust 'image' library. I've seen it fail with some unusual jpeg files ("Marker SOF2 is not supported.")

By default, it will fill as much of the terminal as possible, while keping the aspect ratio of the input image. Use --width or --height to override this, specifying the number of terminal rows or columns to fit to (Or both to specify an absolute size). Alternatively, use --max-width and/or --max-height to fit to the terminal up to a maximum.

If your terminal supports it, you can use the full 24-bit colour palette with the --true-colour flag:

In low-colour mode, high-contrast, colourful images tend to work better than flatter images. Skin tones and shades of brown are particularly poorly represented in the ANSI colour pallette.

Installing

• Install Rust & Cargo: https://www.rust-lang.org/downloads.html
• cargo install --git https://github.com/hopey-dishwasher/termpix (see cargo install options for e.g. install location customisation)

License

Apache 2.0 license