jinghaihan

termsnap: Capture Terminal Output as Screenshots, GIFs, and Video

termsnap is a TypeScript CLI built around a Go-based terminal output proxy and web rendering, capturing terminal commands as images, GIFs, videos, or HTML. It suits developers making polished, font- and emoji-aware terminal demos, including interactive sessions.

View on GitHub Compare
Stars
17
Forks
2
Stars, last 30 days
+0
Last commit
6 months ago
Contributors
1

Our take

Quietno commits in the last 90 days

Health score

21/100

How it is scored
Activity
38
Community
4
Issues
21
Pull requests
20

+0 stars in the last 30 days

  • Fewer contributors than 91% of the projects we track

termsnap is a capable, format-rich capture tool, but its quiet recent activity and reliance on a single contributor are worth weighing for ongoing adoption.

Good fit if

  • You need polished terminal screenshots or recordings and value local font and emoji rendering.
  • Your workflow benefits from multiple export formats, configurable themes, or animated command input.
  • You can use a Node.js and Go-based toolchain and are comfortable with an MIT-licensed project.

Look elsewhere if

  • You need evidence of active maintenance: the project has no commits in the last 90 days, despite six releases in the past year.
  • Your team requires multiple contributors or shared project ownership, as all recorded contributions come from one person.
  • You need a capture tool that does not rely on both Node.js and Go.
All health signals
Last commit2026-04-16 (6 months ago)
Commits, last 90 days0
Releases, last 12 months6 (latest v0.5.0, 2025-11-04)
Contributors1
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age15 months

Checked on 2026-10-16 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

17

Forks

2

Change since Nov 16, 2026: 0 stars·0 forks

Overview

termsnap is a TypeScript CLI built around a Go-based terminal output proxy and web rendering technology. It captures terminal command output as screenshots, animated GIFs, videos, or HTML, addressing the difficulty of producing polished terminal visuals that preserve local fonts, emoji, and interactive sessions.

It is aimed at developers who want reproducible terminal demos for documentation, project pages, or presentations. Capture can be styled with themes and layout settings, and output can be previewed in a browser.

Key Features

  • Capture interactive terminal sessions through its Go-based output proxy.
  • Export PNG, JPEG, and WebP images, animated GIFs, or MP4, AVI, MOV, and WebM video.
  • Generate standalone HTML, including animated HTML with configurable typing behavior.
  • Render with local fonts and emoji support.
  • Customize terminal themes, colors, dimensions, fonts, borders, and window decorations.
  • Use built-in themes or fetch themes from the iTerm2-Color-Schemes VSCode directory.
  • Open a browser preview powered by Broz.

Use Cases

  • CLI developers can create screenshots for README files without manually styling terminal output.
  • Documentation authors can record a command as a GIF or video when a static image cannot show its progression.
  • Project maintainers can make animated HTML demos with adjustable typing speed and pauses.
  • Teams showcasing interactive command-line tools can capture sessions while retaining terminal-style output.

What you need

Detected in the repository

  • Node.js (from package.json)
  • Go 1.20 or newer (from go.mod)
  • A test suite and automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Run a command directly with npx:

npx termsnap "command" --png

See the README for output options, configuration, and additional examples.

Alternatives

  • vhs: VHS records scripted terminal sessions from text-based tape files, while termsnap captures commands through a proxy and supports interactive sessions and web rendering.
ProjectLanguageLicenseStarsStatus
termsnapTypeScriptMIT17Quiet
vhsGoMIT21.1kActive

Considerations

The project is marked Quiet, with no commits in the last 90 days. It has had releases in the past year, but development is concentrated in one contributor, so teams should consider continuity and maintenance needs. It requires Node.js and Go 1.20; the repository reports tests and CI, but the supplied information does not describe their coverage. Remote themes and capture binaries are cached locally, with a command available to clear that cache.

Found this useful?

Share it with someone who would like termsnap.

Comparisons