The future is now
The premier UX of the last half-century just got a little better: With
you can now view very, very reasonable approximations
of pictures and animations without leaving the comfort of your
favorite terminal emulator.
- Supports most popular image formats, including animated GIFs.
- Combines a range of Unicode block and box-drawing elements for optimal output.
- Multiple color modes, including Truecolor, 256-color, 16-color and simple FG/BG.
- RGB and DIN99d color spaces for improved color picking.
- Alpha transparency support in any color mode, including in animations.
- Vectorized inner loops for the impatient.
ExampleYou can get fair results by using only U+2580 (upper half block). This is supported with
chafa --symbols vhalf. However, the default is to combine a greater range of symbols.
Chafa must currently be compiled from source in a Unix-like environment, either from a tarball release or directly from the Git repository.
You need the GLib and ImageMagick development files in order to perform the build. These are usually available from your package manager.
The latest release is version 0.9.0 (2018-04-24).
- Download the latest release.
./configure && make && sudo make install
In order to build from Git, you will need automake, libtool and optionally the Docbook tools if you want to generate the documentation.
git clone https://github.com/hpjansson/chafa
./autogen.sh && make && sudo make install
You may also browse the git repository.