termframe creates screenshots of terminal output without recording an existing desktop window. It runs a command in a virtual terminal session, renders the resulting text and styling, and saves the output as an SVG image.
The tool is intended for developers and documentation writers who need consistent, repeatable images of command-line output. Instead of manually arranging a terminal window and taking a desktop screenshot, commands can be rendered with controlled dimensions, typography and window decoration.
termframe also accepts piped input, and can automatically size its virtual terminal to suit the content. This helps when producing documentation from commands with different output lengths.
This is free and open source software.
Key Features
- Renders a command executed in an internal terminal emulator, or formats text supplied through a pipeline.
- Exports scalable SVG output with configurable window backgrounds, margins, titles and frame styles.
- Preserves ANSI text styling, including bold, dim, italic, underline, strikethrough and reversed colours.
- Supports basic terminal colours, 256-colour palettes and 24-bit true colour.
- Automatically determines terminal width and height from output, with optional minimums, maximums, steps and preferred starting sizes.
- Includes dark and light presentation modes and a collection of terminal colour themes.
- Loads custom themes and window styles from user configuration directories.
- Allows optional font embedding so screenshots can preserve their appearance on other systems.
- Reads TOML, YAML and JSON configuration files, including system-wide and per-user settings.
- Lets environment variables and command-line arguments override configuration defaults.
- Produces repeatable terminal output images suited to documentation, README files and presentations.
Website: github.com/pamburus/termframe
Support:
Developer: Pavel Ivanov
License: MIT License
termframe is written in Rust. Learn Rust with our recommended free books and free tutorials.
Related Software
| CLI Screen Capture Tools | |
|---|---|
| maim | Make Image aims to improve on scrot |
| scrot | SCReenshOT is a simple command line screen capture utility |
| slop | Queries for a selection from the user and prints the region to stdout |
| wayshot | Screenshot tool for wayland compositors |
| termframe | Terminal output SVG screenshot tool |
| grim | Utility to take screenshots of Wayland desktops |
| shotman | Uncompromising screenshot tool for Wayland compositors |
| shotgun | Minimal screenshot utility |
| ImageMagick | Create, edit, and compose bitmap images |
| HyprCap | Capture screenshots and screen recordings on Hyprland |
| grimblast | Capture windows, selected areas, and screens on Hyprland |
| lqth | Simple but fast screenshot utility inspired by xscreenshot |
| grimshot | Capture windows, selected areas, and screens under Sway |
Read our verdict in the software roundup.
 LinuxLinks helps you discover the best free and open source software for Linux. Explore our extensive collection of recommended applications, including alternatives to popular proprietary software.We also publish software reviews, Linux tutorials, hardware reviews, free programming books and articles covering the wider open source community. Browse our Linux resources to discover more. Know a useful free and open source Linux application we haven't covered? Suggest a program for inclusion. Has your software been featured on LinuxLinks? Display one of our Featured on LinuxLinks badges on your website or GitHub README. |
Please read our Comment Policy before commenting.