# Chafa

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

Canonical page: https://ourlocalhost.com/app/6678/chafa

## Description

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.

## Health score

48/100 (Fair), based on 4 of 5 factors.
- Maintained: 44 (last commit 293 days ago)
- Popular: 39 (86 GitHub stars)
- Easy to install: 15 (0 install platforms, install notes)
- Security check: 100 (no serious findings, CI, tests)

## Links

- Official website: https://hpjansson.org/chafa
- Documentation: https://hpjansson.org/ref/
- GitHub: https://github.com/hectorm/chafa-wasm

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

## Alternatives

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

---
Source: Our Local Host (https://ourlocalhost.com/app/6678/chafa), the self-hosted and open-source app directory.
