VHS
A CLI tool that renders terminal sessions scripted in .tape files into GIFs, videos or text output for demos and integration testing.
Tested on LinuxKnown vulnerabilities
Use it
Before you install: known vulnerabilities
pickfit found 1 known high or critical vulnerability in the packages a fresh install brings (OSV.dev, 16 Nov 2026). Weigh this before you install it.
go:github.com/charmbracelet/wish v1.4.7Wish has SCP Path Traversal that allows arbitrary file read/write (GHSA-xjvp-7243-rg9h, critical, no fix yet)
Linux x86_64
You need first
- System packages:
ttyd,ffmpeg
Download the vhs v0.12.1 Linux x86_64 release binary into ~/.local/bin
cd /tmp && V=$(curl -fsSL https://api.github.com/repos/charmbracelet/vhs/releases/latest | python3 -c 'import sys,json;print(json.load(sys.stdin)["tag_name"].lstrip("v"))') && curl -fsSLO https://github.com/charmbracelet/vhs/releases/download/v$V/vhs_${V}_Linux_x86_64.tar.gz && tar xzf vhs_${V}_Linux_x86_64.tar.gz && mkdir -p ~/.local/bin && cp vhs_${V}_Linux_x86_64/vhs ~/.local/bin/Install the ttyd and ffmpeg static binaries (README prerequisites) into ~/.local/bin
cd /tmp && curl -fsSL -o ~/.local/bin/ttyd https://github.com/tsl0922/ttyd/releases/latest/download/ttyd.x86_64 && chmod +x ~/.local/bin/ttyd && curl -fsSLO https://github.com/BtbN/FFmpeg-Builds/releases/download/latest/ffmpeg-master-latest-linux64-gpl.tar.xz && tar xJf ffmpeg-master-latest-linux64-gpl.tar.xz && cp ffmpeg-master-latest-linux64-gpl/bin/ffmpeg ~/.local/bin/ && ffmpeg -version
Where the README and reality differ
- README: VHS requires ttyd and ffmpeg
What worked: VHS also downloads Chromium at runtime (go-rod, to ~/.cache/rod) on the first render, which needs network and system libraries (libnss3, libatk, libX11, libgbm, libcairo, libasound and more). Without them rendering fails with 'could not start browser'.
Check that it works
vhs --versionThe output should contain “vhs version v0.12.1”.
First thing to try
(sleep 2; printf 'echo hello\r'; sleep 1; printf 'exit\r'; sleep 2) | timeout 30 script -qec "vhs record --shell bash" /dev/nullRun vhs record --shell bash to start recording a terminal session as a tape script.
What it does
- Record terminal actions into a tape fileTested
How to use it
- Run
vhs record --shell bashto start recording. - Type your commands as usual, then type
exitto stop. - VHS prints the recorded actions as tape commands, such as
Type "<your text>".
- Run
- Turn tape scripts into terminal GIFsNot tested
- Publish GIFs to share themNot tested
- Run the built-in SSH rendering serverNot tested
How far pickfit got
Linux x86_64
- Installs
- Starts
- 1 of 4 features work
- Works offline
macOS and Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- create a GIF demo of a CLI tool from a script
- generate golden files for integration testing of terminal apps
- keep demo GIFs updated in CI
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 15 Nov 2026
- Version v0.12.1 (24fa225)
Differences the test machine hit
- README: Install with go install, pacman, nix, xbps, brew or apt (all need a toolchain, root or another distro)
In the test: The release tarball vhs_0.12.1_Linux_x86_64.tar.gz from GitHub releases, copied to ~/.local/bin, plus static ttyd (tsl0922 releases) and ffmpeg (BtbN builds) - README: vhs record > cassette.tape
In the test: It needs a real TTY: with no terminal it fails with 'inappropriate ioctl for device'. Running it under `script` worked.