# 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 ```sh sudo av install brew:termshot ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install termshot ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install termshot ``` Evidence: MacPorts ports tree: graphics/termshot/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Nix (92%): ```sh nix profile install nixpkgs#termshot ``` Evidence: nixpkgs package indexes: pkgs/by-name/te/termshot/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:termshot - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.6.1 - **Source summary:** Creates screenshots based on terminal command output - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - termshot (cli) - termshot (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.6.1 - Local data: ok - Upstream repository: https://github.com/homeport/termshot - Upstream latest detected: v0.6.1 (current) - info: No package-manager update timestamp was available. ## 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 `, 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 - - - - - source_facts.package-manager ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** termshot - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - termshot: normalized package name match | nixpkgs package indexes: pkgs/by-name/te/termshot/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - MacPorts - termshot: normalized package name match | MacPorts ports tree: graphics/termshot/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [grc](https://www.automicvault.com/pkg/brew/grc/) - Shares av.db curated category or tags: cli, command-output, developer-tools, terminal. - [aha](https://www.automicvault.com/pkg/brew/aha/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [amtterm](https://www.automicvault.com/pkg/brew/amtterm/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [ansifilter](https://www.automicvault.com/pkg/brew/ansifilter/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [ccat](https://www.automicvault.com/pkg/brew/ccat/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [clive](https://www.automicvault.com/pkg/brew/clive/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [colordiff](https://www.automicvault.com/pkg/brew/colordiff/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [colormake](https://www.automicvault.com/pkg/brew/colormake/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [diagram](https://www.automicvault.com/pkg/brew/diagram/) - Both packages work with overlapping file formats or content types. Shared terms: cli, developer, developer-tools, generation, image. - [faketty](https://www.automicvault.com/pkg/brew/faketty/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, output, terminal. ## Combined YAML source View the package source record on GitHub. [combined/termshot.yml](https://github.com/automic-vault/db/blob/main/combined/termshot.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph