pkg.soopen package index

brew / rank 5757

Install termshot with Homebrew, MacPorts, Nix

Creates screenshots based on terminal command output. Version 0.6.1 via Homebrew; verified 2026-07-26. Also installable with nix: nix profile install nixpkgs#termshot.

install

Additional install commands

macOS

Homebrewverified · 100%
brew install termshot

local Homebrew formula metadata

MacPortsverified · 94%
sudo port install termshot

MacPorts ports tree · graphics/termshot/Portfile · source: api.github.com

Linux

Nixverified · 92%
nix profile install nixpkgs#termshot

nixpkgs package indexes · pkgs/by-name/te/termshot/package.nix · source: api.github.com

overview

Package summary

Creates screenshots based on terminal command output

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.

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 bottle metadata was recorded.

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

CommandKindExposureNote
termshotexecutableindexed executableDiscovered from the local executable index.

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-08-03
manager version0.6.1
manager updated2026-07-26
local dataunknown
upstreamnot available
latest detectednot detected
  • okNo freshness warnings were generated.

install metadata

Package metadata

Package keybrew:termshot
Version0.6.1
Package managerHomebrew
Homepagehttps://github.com/homeport/termshot
Repositoryhttps://github.com/homeport/termshot
Last updated2026-07-26T00:50:35+02:00
Pulseupdated
Bottlenot recorded
Servicenone declared

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
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/te/termshot/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
MacPorts95%

termshot

sudo port install termshot
  • normalized package name match
  • Matched by: Termshot
MacPorts ports tree · api.github.com · MacPorts ports tree: graphics/termshot/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

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.

Used sources

  • Geiger risk classifier
  • cross-ecosystem install command graph
  • curated package history
  • external package-manager database matches
  • pkg.so package database
  • pkgdb category and tag curation