macOS
Homebrewverified · 100%
brew install termshotlocal Homebrew formula metadata
MacPortsverified · 94%
sudo port install termshotMacPorts ports tree · graphics/termshot/Portfile · source: api.github.com
brew
Install termshot with Homebrew, MacPorts, Nix
Creates screenshots based on terminal command output. Version 0.6.1 via Homebrew; verified from local package data.
install
Additional install commands
Linux
Nixverified · 92%
nix profile install nixpkgs#termshotnixpkgs package indexes · pkgs/by-name/te/termshot/package.nix · source: api.github.com
overview
Package summary
Creates screenshots based on terminal command output
Project links
Commands and aliases
- termshot
history
Project history and usage
termshot is a Go command-line utility for turning terminal command output into PNG screenshots. Its project history sits in the same niche as carbon-style code-image generators and terminal documentation tools, but its README emphasizes preserving ANSI escape-code output from real commands rather than applying syntax highlighting to pasted text.
Project history
The repository was created in November 2020 and published its first GitHub release, v0.1.0, in December 2020. The README describes the tool as a terminal-native way to generate screenshots and documents a workflow where users prefix a command with `termshot`, similar to tools such as `time`, `watch`, or `perf`.
Later releases added package-friendly installation and capture controls rather than changing the basic purpose. Release notes show continued maintenance through v0.6.x, including raw read/write support, configurable screenshot margins and padding, decoration toggles, and Go dependency updates.
Adoption history
The official README documents Homebrew installation through the Homeport tap and prebuilt Darwin and Linux release binaries. In the input package facts, termshot also appears in Brew, MacPorts, and Nix, which is typical adoption for a small terminal utility useful to developers who generate README images, release notes, or reproducible CLI screenshots.
How it is used
Typical usage is `termshot <command>`, which runs the command in a pseudo terminal and writes `out.png` by default. The README documents flags for output file selection, clipboard output on supported platforms, editing captured output before rendering, showing or hiding command/window decoration, fixed column width, raw capture, and reading raw terminal output back into an image.
Why package nerds care
For package-maintainer and terminal-tool users, termshot is useful because it makes command output into a distributable artifact without requiring a GUI terminal screenshot workflow. It is especially relevant for Homebrew/Nix-style CLI culture where maintainers often want small, reproducible images for READMEs, changelogs, and examples.
Timeline
- 2020: GitHub repository created.
- 2020: v0.1.0 published as the first GitHub release.
- 2024: v0.3.0 added README documentation and screenshot layout controls such as fixed columns and decoration/shadow toggles.
- 2025: v0.5.0 added raw read/write flags.
- 2026: v0.6.1 continued maintenance with dependency updates and configurable margin/padding work.
Related projects
- The README explicitly positions termshot near web-based screenshot tools such as carbon.now.sh and codekeep.io/screenshot, but distinguishes it by reading ANSI escape-code rich text from command output.
- It overlaps with terminal recording and sharing tools such as termsvg and asciinema, but produces static PNG screenshots rather than terminal session recordings.
Sources
security posture
Risk level: green
narrow executable package without higher-risk signals.
Risk classifier
green risk · low confidence · appliance
Why
- narrow executable package without higher-risk signals
Signals
- metadata:no-higher-risk-signals
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 6 platform targets.
- Build metadata lists 1 build dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
termshot | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-07-08
manager version0.6.1
manager updated
local dataok
upstreamcurrent
latest detectedv0.6.1
https://github.com/homeport/termshot
- infoNo package-manager update timestamp was available.low confidence
install metadata
Package metadata
| Package key | brew:termshot |
|---|---|
| Version | 0.6.1 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/termshot |
| Homepage | https://github.com/homeport/termshot |
| Repository | https://github.com/homeport/termshot |
| Upstream docs | https://github.com/homeport/termshot#readme |
| License | MIT |
| Source archive | https://github.com/homeport/termshot/archive/refs/tags/v0.6.1.tar.gz |
| Build dependencies | go |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | termshot |
| Version Scheme | 0 |
| Revision | 0 |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Nix95%
termshot
nix profile install nixpkgs#termshot- normalized package name match
- Matched by: Termshot
MacPorts95%
termshot
sudo port install termshot- normalized package name match
- Matched by: Termshot
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment