# homeport/termshot README

## Metadata

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

termshot runs a command in a pseudo terminal and renders the ANSI output into a PNG that looks like a terminal window; `--raw-read` takes existing output from a file.

## Key findings

- Default output out.png; `--raw-read <file>` reads captured output instead of running a command; `--raw-write` saves raw output.
- Self-described work in progress; commands that reset the cursor position are known to cause issues.
- MIT license.

## Pros / strengths

Shows that a plain ANSI stream replayed through a renderer is enough for a useful picture.

## Cons / limitations / caveats

Font handling and PNG library not stated on the page; cursor-moving programs break it, which a real VT screen (TuiVtScreen) avoids.

## Relevance to tai

Rejected as a dependency; its failure mode on cursor movement is why detz replays through a full VT screen rather than parsing SGR line by line.

## Changelog

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