termframe

termframe is a non-interactive terminal emulator that executes single commands, renders their output in a virtual terminal session, and exports screenshots as SVG files. It functions as a specialized screenshot tool for terminal output, enabling developers to create visual documentation of CLI commands and their results.

The tool provides comprehensive ANSI style support including bold, italic, underlined text, reversed colors, and the full spectrum of terminal colors from basic 16-color palette to 24-bit truecolor. It includes extensive theming capabilities with built-in themes from iTerm2-Color-Schemes and support for custom themes in TOML, YAML, or JSON formats. Window styles can be customized with predefined options like macOS and compact styles.

Developers, technical writers, and educators creating documentation, tutorials, or presentations can use termframe to generate consistent terminal screenshots. The tool supports auto-sizing to determine optimal terminal dimensions based on command output, with flexible width and height constraints. Configuration is handled through platform-specific config files with support for both dark and light modes, making it suitable for various documentation themes and environments.

Installation

# via Homebrew
brew install pamburus/tap/termframe

# via Cargo
cargo install --locked --git https://github.com/pamburus/termframe.git