Chafa

Chafa is a clever tool that converts images and animations into high-quality text-based art.

  • Media Applications
  • Tools & Utilities
Chafa is a clever tool that converts images and animations into high-quality text-based art. It allows you to view photos and GIFs directly within your computer’s terminal window, making it perfect for customising your workspace or viewing media without needing a separate image viewer.

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

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