# jiro4989/textimg README

## Metadata

| Field | Value |
|---|---|
| Institute | Molodetz Institute — Research & Retrieval Division |
| Subject | terminal-screenshot-rendering |
| Document type | Source Dossier |
| Tier | 1 |
| Source title | jiro4989/textimg README |
| Source URL | https://github.com/jiro4989/textimg |
| Source publisher / author | jiro4989 |
| Source type | repository |
| Source date (published) | Unknown — not stated |
| Date researched | 2026-10-27 |
| Researched by | tai (agent), model: Claude Opus 5.5, on behalf of retoor |
| Research method | direct page fetch |
| Confidence | Medium |
| Status | Active |

## Summary

textimg converts ANSI or 256-color text to PNG, JPG or GIF, using a system CJK font chosen per OS.

## Key findings

- Default font on Linux `/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc`; override with TEXTIMG_FONT_FILE or -f.
- Supports 8, 256 and 24-bit SGR colors; PNG default; animated GIF option.
- Emoji need extra image files or an emoji font; not tested on Windows; MIT.

## Pros / strengths

Clear statement of color support levels a renderer must cover.

## Cons / limitations / caveats

Depends on a system font that a headless server usually lacks; external Go binary.

## Relevance to tai

Rejected; its system-font dependency is the exact failure an embedded bitmap font avoids.

## Changelog

| Date | Change |
|---|---|
| 2026-10-27 | Initial dossier created. |