A tool for recording terminal sessions as GIFs for integration testing and demoing CLI tools.
- v0.12.1
- Published at
- Sep 24, 2026
- 21,054
- Stars
- 198,081
- Download
- Synced at
- Oct 4, 2026
Latest release
v0.12.1Sep 24, 2026, 09:30 AMDownloads slow? Switch the source anytime above
README
Project Overview
VHS records terminal sessions as GIFs for integration testing and demoing your CLI tools.
Key Features
- Record terminal sessions as GIFs
- Write recordings using
.tapefiles - Custom terminal dimensions and font size
- Sleep, type, enter, and other commands
- Cross-platform support
Target Audience
- Developers who need to demo CLI tools
- Teams needing CLI integration testing
- Open-source project maintainers
Quick Start
- Install VHS:
brew install vhs - Create a
.tapefile:vhs new demo.tape - Edit the tape file
- Generate GIF:
vhs demo.tape
Core Advantages
- Code as recording, version-controllable
- Cross-platform support
- Rich command reference
- Open-source and free
System Requirements
- OS: macOS, Linux, Windows
- Architectures: x86_64, arm64
- Additional Dependencies:
ttydandffmpeg
Notes
- Requires
ttydandffmpeg - Can run via Docker:
docker run --rm -v $PWD:/vhs ghcr.io/charmbracelet/vhs .tape
Release history
Sort
Related projects
obs-studio
obsproject/obs-studio
A free and open-source screen recording and live streaming software, widely used for video capture and real-time streaming.
33.0.1 C
Author updated 14d ago
openscreen
siddharthvaddem/openscreen
A free, open-source, no-subscription, no-watermark desktop screen recorder and demo video creation tool for producing polished product demos and walkthroughs.
v1.5.0 TypeScript
Author updated Jun 6, 2026
Recordly
webadderallorg/Recordly
An open-source screen recorder and editor for creating polished demo videos, walkthroughs, and product videos with auto-zooms, cursor polish, webcam overlays, and timeline editing.
v1.4.0 TypeScript
Author updated Sep 8, 2026
ScreenToGif
NickeManarin/ScreenToGif
A tool that allows you to record a selected area of your screen, live feed from your webcam, or live drawings from a sketchboard, edit the animation, and save it as a GIF, APNG, video, or PNG image.
2.43.2 C#
Author updated Jul 28, 2026
Kap
wulkano/Kap
An open-source screen recorder built with web technology for macOS, allowing quick recording of selected screen areas via the menu bar icon.
v3.6.0 TypeScript
Author updated Oct 27, 2022
Magpie
Blinue/Magpie
Magpie is a lightweight Windows window upscaling tool supporting fullscreen and windowed scaling with built-in algorithms like Anime4K, FSR and CRT shaders behind a WinUI interface.
v0.13.0 HLSL
Author updated 27d ago