VHS

Terminal recorder from Charm that creates GIFs/PNGs from scripted interactions.

Run

nix run nixpkgs#vhs -- <file>.tape

Tape File Syntax

Output output.gif           # or .png, .mp4, .webm

Set Shell "bash"
Set FontSize 14
Set Width 1200
Set Height 600
Set Theme "Catppuccin Mocha"

Hide                        # Hide commands from output
Type "echo hello"
Enter
Sleep 1s
Show                        # Show commands again

Screenshot output.png       # Capture current frame

Commands

Settings

Example: TUI Screenshot

Output screenshots/demo.png

Set Shell "bash"
Set FontSize 14
Set Width 1400
Set Height 800
Set Theme "Catppuccin Mocha"

Hide
Type "cd /path/to/project && my-tui-app"
Enter
Sleep 2s
Show

Ctrl+p
Sleep 1s
Screenshot screenshots/demo.png

Escape
Type "q"
Enter

List Themes

nix run nixpkgs#vhs -- themes