Run a command, get a PNG that looks like your terminal. Standalone CLI and MCP server, built for pentest reports, blog posts, and PR descriptions.
Highlights
Real ANSI rendering - colors, bold, italic, underline, Unicode, at 2x resolution with your own font.
Redaction - opt-in masking of secrets in the image; the text returned to the caller keeps the originals. See docs/redaction.md.
Themes - 11 built-in, plus your own in ~/.config/termshot/themes/.
See docs/themes.md.
for; do
done
Your prompt, whatever it is - commands run through your login shell, so the
image shows the prompt your own shell config draws: the four panes below are
four different prompts in the one built-in dark theme.
TERMSHOT_SHELL=/path/to/shell-wrapper
Chrome frames - title bar presets with optional timestamp.
Composition - combine screenshots side by side or stacked, tmux-style.
MCP server - four tools for agent workflows, see docs/mcp.md.
Accessible by default - every PNG embeds its terminal text (redacted, when
redaction ran) in a UTF-8 Description chunk for screen readers.
Install
# or build from source:
Prebuilt binaries, packages, and source builds: docs/install.md.
Docs
- docs/install.md - install methods, platform support
- docs/tips.md - shell recipes and workflow shortcuts
- docs/mcp.md - MCP setup, tool reference, agent workflows
- docs/themes.md - built-in and user themes, fonts, fallback
- docs/redaction.md - rules, custom rules, partial redaction
- docs/config.md -
config.tomlreference - docs/man/termshot.1 - full CLI reference