Display images in an ANSI terminal
Clone or download
hopey-dishwasher So it turns out you shouldn't just accept pull requests from well-mea…
…ning randoms on the internet. Put back in a the scale_dimension function that was previously omitted.
Latest commit bb2fcc5 Mar 9, 2016



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.

buzz smaller

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

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. lena looks bad



Apache 2.0 license