VHS — screenshot of github.com

VHS

VHS is a tool to record CLI tool demos. I use it to script terminal interactions with a `.tape` file, generating GIFs or videos for documentation and testing.

Visit github.com →

Questions & Answers

What is VHS?
VHS is a CLI tool that allows users to script terminal interactions to create high-quality animated GIFs or videos. It functions as a "CLI home video recorder" for demonstration and testing purposes.
Who is VHS designed for?
VHS is designed for developers, technical writers, and open-source project maintainers who need to create consistent and reproducible demonstrations of their command-line interfaces. It's useful for documentation, tutorials, and showcasing CLI tools.
How does VHS differ from traditional screen recording software?
Unlike traditional screen recording tools, VHS operates by interpreting a `.tape` file, which contains commands that define terminal actions, timing, and settings programmatically. This approach ensures reproducibility, consistency, and version control for recorded demonstrations.
When should I use VHS?
You should use VHS when you need to create automated, high-quality, and repeatable visual demonstrations of command-line tools, such as for project READMEs, documentation, or integration testing. It's particularly effective for showing complex CLI workflows.
What is a `.tape` file in VHS?
A `.tape` file is a plain text file that contains a sequence of commands, such as `Type`, `Sleep`, `Enter`, and `Set` that instruct VHS on how to interact with a virtual terminal. This script defines the entire recording, from window size to key presses.