Chafa
Chafa is a clever tool that converts images and animations into high-quality text-based art.
Platform availability
Available on 0 of 10 platforms
- Unraid (not listed)
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
48/100 Fair
- Maintained
- 44last commit 293 days ago
- Popular
- 3986 GitHub stars
- Easy to install
- 150 install platforms, install notes
- Light to run
- No data
- Security check
- 100no serious findings, CI, tests
Based on 4 of 5 factors.
- GitHub stars
- 86
- Open issues
- 8
- Last commit
- 2026-02-01
- Latest release
- v0.3.3
- License
- LGPL-3.0
- Activity
- stale
Checked yesterday - source: GitHub (hectorm/chafa-wasm)
Resources & Compatibility
Requirements not published yet.
First-install notes
- Use Sixel mode if your terminal supports it In Chafa, set the pixel mode to Sixels when your terminal supports Sixel graphics. Without this, images may fall back to basic terminal characters and look blocky, blurry, or not display at all. source
Fetched 49 days ago - each note links to its source
Variants
Alternatives (3)
- Browsh - A fully-modern text-based browser, rendering to TTY and browsers.
- Kitty terminal - Kitty ( not to be confused with KiTTY ) is a powerful, cross-platform GPU-based terminal emulator.
- Terminology - Terminology is a terminal emulator for e17.
Checked 54 days ago - source: AlternativeTo
Common questions
Which terminal output formats does Chafa support?
It can output to Sixels, Kitty, iTerm2, and Unicode mosaics. It also combines Unicode symbols from multiple selectable ranges for optimal output.
What should I do if images look blocky or do not display correctly in my terminal?
If your terminal supports Sixel graphics, set Chafa's pixel mode to Sixels. Without this, output may fall back to basic terminal characters and look blocky, blurry, or not display at all.
Can Chafa use custom font files?
Yes. Glyphs can be loaded from any font file supported by Freetype, including TTF, OTF, and PCF files.
Can Chafa run in Node.js, Deno, Bun, or web browsers?
A WebAssembly module can convert images into ANSI escape codes, HTML, or console.log arguments in Node.js, Deno, Bun, and web browsers. It is installed with npm install chafa-wasm.
Does Chafa handle animated images and transparency?
It supports animated GIFs and alpha transparency in any color mode, including in animations. It also supports Truecolor, 256-color, 16-color, and simple FG/BG modes.
Is there a known stdin problem after running Chafa in 1.16.2?
Issue 293 reports that since 1.16.2, the shell's standard input could be messed up so the line after the chafa command could not read stdin, even after sleep. The reporter said 1.16.1-1 did not have the problem.
Answers sourced from github.com, github.com, github.com, hpjansson.org
Community
Collected 48 days ago - public community threads