Fork me on GitHub
chafa /ˈtʃafa/ (adj): cheap, low quality; lame


Chafa packages are available for many Linux distributions, including Arch, Debian, Fedora, Gentoo and Ubuntu. There is a native build for Microsoft Windows, and thanks to Brew and MacPorts, it is also available for MacOS X. Check your software distribution's repositories, or look for it on


Most Linux distributions ship packages for Chafa, although these may not always be up to date. Below are the command lines for installation on some of them. Note that you must do this as root, typically by prefixing each command with sudo.

Arch Linuxpacman -S chafa
Brewbrew install chafa
Debianapt install chafa
Fedoradnf install chafa
FreeBSDpkg install chafa
Gentooemerge media-gfx/chafa
Guixguix install chafa
Kali Linuxapt install chafa
MacPortsport install chafa
OpenBSDpkg_add chafa
openSUSEzypper in chafa
Ubuntuapt install chafa
Packaging status

On Windows, you can use the stand-alone executable below, or get it from one of the following providers:

Scoopscoop install chafa
Wingetwinget install hpjansson.Chafa

Stand-alone executable

If Chafa is not available from your package manager and you don't want the hassle of building it yourself, you can get a statically linked binary. These should work on any GNU/Linux distribution released since 2013 or so (glibc version 2.17 or later). Simply unpack chafa from its archive and move it into your path.

The Windows binary requires Windows 10 and must be launched from the Command Prompt (cmd.exe) or a Windows-compatible terminal emulator.

Get Chafa 1.14.1 for Linux (x86_64)

Get Chafa 1.14.1 for Windows (x86_64)

Find signatures and older binary releases here.


Chafa can 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.14.1 (2024-06-17).

  1. Download the latest release (signature).
  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
  2. ./ && make && sudo make install

You may also browse the git repository.