Installation
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 repology.org.
Packages
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 Linux | pacman -S chafa |
| Brew | brew install chafa |
| Debian | apt install chafa |
| Fedora | dnf install chafa |
| FreeBSD | pkg install chafa |
| Gentoo | emerge media-gfx/chafa |
| Guix | guix install chafa |
| Kali Linux | apt install chafa |
| MacPorts | port install chafa |
| OpenBSD | pkg_add chafa |
| openSUSE | zypper in chafa |
| Ubuntu | apt install chafa |
On Windows, you can use the stand-alone executable below, or get it from one of the following providers:
| Scoop | scoop install chafa |
| Winget | winget 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.0 for Linux (x86_64)
Get Chafa 1.14.0 for Windows (x86_64)
Find signatures and older binary releases here.
Tarball
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.0 (2024-01-08).
- Download the latest release (signature).
./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.
git clone https://github.com/hpjansson/chafa./autogen.sh && make && sudo make install
You may also browse the git repository.