chafa (adj): cheap, low quality; lame

The future is now

The premier UX of the last half-century just got a little better: With chafa, you can now view very, very reasonable approximations of pictures and animations without leaving the comfort of your favorite terminal emulator.

Features

Example

You 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.

Installation

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.

Tarball

The latest release is version 0.9.0 (2018-04-24).

  1. Download the latest release.
  2. ./configure && make && sudo make install

Git repository

In order to build from Git, you will need automake, libtool and optionally the Docbook tools if you want to generate the documentation.

  1. git clone https://github.com/hpjansson/chafa
  2. ./autogen.sh && make && sudo make install

You may also browse the git repository.

Development

The core functionality of Chafa is implemented as a shared library with a stable C API. It has an online reference manual. There is also a man page for the command-line tool.

License

chafa is written and maintained by Hans Petter Jansson (hpj@cl.no) and is licensed under the LGPLv3+.