termshot 1.2.0

Terminal screenshot CLI and MCP server with ANSI rendering, redaction, themes, and composition
Documentation

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.

termshot exec --chrome gnome --title 'termshot - ls src/' 'ls --color=always -la src/'

Highlights

Real ANSI rendering - colors, bold, italic, underline, Unicode, at 2x resolution with your own font.

termshot exec 'git log --graph --oneline --color=always -n 6'

Redaction - opt-in masking of secrets in the image; the text returned to the caller keeps the originals. See docs/redaction.md.

termshot exec --redact --chrome macos --title 'cat .env.staging' \
  'command cat .env.staging'

Themes - 11 built-in, plus your own in ~/.config/termshot/themes/. See docs/themes.md.

for theme in catppuccin-mocha dracula nord; do
  termshot exec --theme "$theme" --no-rounded -o "$theme.png" \
    'git log --oneline --color=always -n 4'
done
termshot compose --divider 4 -o themes.png \
  catppuccin-mocha.png dracula.png nord.png

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 termshot exec --cwd /path/to/project \
  --theme dark -o prompt.png 'git status -sb'
termshot compose --divider 4 -o prompts.png prompt-*.png

Chrome frames - title bar presets with optional timestamp.

termshot exec --chrome gnome --timestamp 'nmap -F localhost'

Composition - combine screenshots side by side or stacked, tmux-style.

termshot exec -o before.png 'git status -su'
git add -A
termshot exec -o after.png 'git status -su'
termshot compose --layout horizontal --chrome gnome \
  --title 'git status - before / after staging' -o compose.png before.png after.png

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

cargo binstall termshot
# or build from source:
cargo install termshot

Prebuilt binaries, packages, and source builds: docs/install.md.

Docs

License

MIT

Third-party notices