The future is now
The premier UX of the 21st 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. The power of ANSI X3.64 compels you!
- Supports most popular image formats, including animated GIFs.
- Combines Unicode symbols from multiple selectable ranges 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.
- Suitable for terminal graphics, ANSI art composition and even black & white print.
- Works with most modern and classic terminals and terminal emulators.
- Documented, stable C API.
- Fast & lean.
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 packages are available for Arch, Debian, Fedora, Gentoo and Ubuntu. Check your Linux distribution's repositories, or look for it on pkgs.org.
Chafa can also 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 1.0.1 (2018-12-18).
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.