# charmbracelet/freeze README

## Metadata

| Field | Value |
|---|---|
| Institute | Molodetz Institute — Research & Retrieval Division |
| Subject | terminal-screenshot-rendering |
| Document type | Source Dossier |
| Tier | 1 |
| Source title | charmbracelet/freeze README |
| Source URL | https://github.com/charmbracelet/freeze |
| Source publisher / author | Charmbracelet |
| 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

Freeze is a Go CLI that turns code and terminal output into SVG, PNG or WebP images. The README documents capturing ANSI output with `--execute` and piping `tmux capture-pane -pet 1 | freeze -c full`; it does not explain how PNG rasterization works.

## Key findings

- Captures ANSI output with `--execute "cmd"`; TUI example `tmux capture-pane -pet 1 | freeze -c full`.
- Output format follows the file extension: .svg, .png, .webp; default out.svg.
- Default font JetBrains Mono 14 px, line height 1.2; `--font.file` embeds a TTF/WOFF/WOFF2 into the SVG.
- MIT license; repository contains ansi.go, font.go, png.go (not read).

## Pros / strengths

Confirms the industry pattern this design copies: tmux capture-pane with escapes as the input.

## Cons / limitations / caveats

README only; PNG pipeline and whether a system font or rasterizer library is required were not stated. A Go binary dependency for detz.

## Relevance to tai

Rejected as a dependency (external Go binary, outline fonts); its `capture-pane -pet` input pattern was adopted.

## Changelog

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