macOS
Homebrewverified · 100%
brew install vhslocal Homebrew formula metadata
MacPortsverified · 94%
sudo port install vhsMacPorts ports tree · graphics/vhs/Portfile · source: api.github.com
brew
Install vhs with Homebrew, apk, dnf, MacPorts, Nix, pacman, scoop, winget, zypper
Your CLI home video recorder. Version 0.11.0 via Homebrew; verified from local package data.
install
Additional install commands
Linux
Alpine Linux apkverified · 92%
sudo apk add vhsAlpine Linux edge package indexes · vhs · source: dl-cdn.alpinelinux.org
Fedora dnfverified · 92%
sudo dnf install vhsFedora Rawhide package metadata · vhs · source: dl.fedoraproject.org
Nixverified · 92%
nix profile install nixpkgs#vhsnixpkgs package indexes · pkgs/by-name/vh/vhs/package.nix · source: api.github.com
Arch Linux pacmanverified · 92%
sudo pacman -S vhsArch Linux sync databases · vhs · source: geo.mirror.pkgbuild.com
openSUSE zypperverified · 92%
sudo zypper install vhsopenSUSE Tumbleweed package metadata · vhs · source: download.opensuse.org
Windows
Scoopverified · 92%
scoop install main/vhsScoop official bucket manifest trees · bucket/vhs.json · source: api.github.com
Windows Package Managerverified · 92%
winget install --id charmbracelet.vhs -eWindows Package Manager source index · charmbracelet.vhs · source: cdn.winget.microsoft.com
overview
Package summary
Your CLI home video recorder
Project links
Commands and aliases
- vhs
history
Project history and usage
VHS is Charmbracelet's terminal demo recorder: a command-line tool that describes terminal sessions as `.tape` files and renders them to GIF, MP4, WebM, or related outputs. It sits in the same developer-experience niche as asciinema and terminal screenshot tools, but emphasizes reproducible, scripted demos.
Project history
Charmbracelet created the public VHS repository on 2022-07-19. The project adopted the metaphor of terminal 'home video' and 'tape' files: a tape contains commands such as output settings, typed text, sleeps, and enter/key events, and VHS evaluates those commands in a controlled terminal session.
The release stream shows VHS maturing through regular 0.x releases after its 2022 repository creation, including v0.4.0 in April 2023, v0.6.0 in July 2023, v0.8.0 in September 2024, v0.10.0 in June 2025, and v0.11.0 in March 2026. The project remained under Charmbracelet stewardship and in Charmbracelet's broader family of polished terminal tools.
Adoption history
VHS gained adoption among CLI authors because it turns README demos into source-controlled assets: the demo script can live beside the project, and the rendered animation can be regenerated when the CLI changes. Charmbracelet also maintains `vhs-action`, a GitHub Action intended to regenerate GIFs from `.tape` files in CI, reinforcing VHS's role in documentation and integration testing workflows.
How it is used
A normal VHS workflow starts with `vhs new demo.tape`, editing the generated tape file, and running `vhs demo.tape` to create the configured output. The README documents settings for terminal dimensions, font, shell, output path, and scripted terminal actions; it also supports recording an interactive session into a tape for later editing.
Why package nerds care
For package maintainers, VHS matters because it treats terminal recordings as build artifacts rather than hand-captured media. That makes CLI demos reviewable, repeatable, and automatable in release or README pipelines, which is a practical improvement over stale screenshots and manually captured GIFs.
Timeline
- 2022-07-19: Public GitHub repository created.
- 2023-04-05: v0.4.0 release published.
- 2023-07-20: v0.6.0 release published.
- 2024-09-06: v0.8.0 release published.
- 2025-06-17: v0.10.0 release published.
- 2026-03-10: v0.11.0 release published.
Related projects
- vhs-action is the companion GitHub Action for regenerating VHS outputs in CI.
- Charmbracelet's broader terminal ecosystem includes Bubble Tea, Lip Gloss, Gum, and other Go-based CLI/TUI projects that share the same polish-oriented developer audience.
Sources
security posture
Risk level: blue
broad file, network, media, or database tool signal.
Risk classifier
blue risk · medium confidence · tool
Why
- broad file, network, media, or database tool signal
Signals
- text:video,record
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 6 platform targets.
- Installs with 2 runtime dependencies.
- Build metadata lists 1 build dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
vhs | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-07-08
manager version0.11.0
manager updated
local dataok
upstreamcurrent
latest detectedv0.11.0
https://github.com/charmbracelet/vhs
- infoNo package-manager update timestamp was available.low confidence
install metadata
Package metadata
| Package key | brew:vhs |
|---|---|
| Version | 0.11.0 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/vhs |
| Homepage | https://github.com/charmbracelet/vhs |
| Repository | https://github.com/charmbracelet/vhs |
| Upstream docs | https://github.com/charmbracelet/vhs#readme |
| License | MIT |
| Source archive | https://github.com/charmbracelet/vhs/archive/refs/tags/v0.11.0.tar.gz |
| Dependencies | ffmpeg, ttyd |
| Build dependencies | go |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | vhs |
| Version Scheme | 0 |
| Revision | 0 |
| Head Version | HEAD |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Nix95%
vhs
nix profile install nixpkgs#vhs- normalized package name match
- Matched by: Vhs
apk95%
vhs 0.11.0-r2
Tool for automatic recording of terminal sessions
https://github.com/charmbracelet/vhs
sudo apk add vhs- License: MIT
- Architecture: x86_64
- Source Package: vhs
- 1 dependencies
- 1 provides
- normalized package name match
- Matched by: Vhs
apk95%
vhs-bash-completion 0.11.0-r2
Bash completions for vhs
https://github.com/charmbracelet/vhs
sudo apk add vhs-bash-completion- License: MIT
- Architecture: x86_64
- Source Package: vhs
- normalized package name match
- Matched by: Vhs
apk95%
vhs-doc 0.11.0-r2
Tool for automatic recording of terminal sessions (documentation)
https://github.com/charmbracelet/vhs
sudo apk add vhs-doc- License: MIT
- Architecture: x86_64
- Source Package: vhs
- normalized package name match
- Matched by: Vhs
apk95%
vhs-fish-completion 0.11.0-r2
Fish completions for vhs
https://github.com/charmbracelet/vhs
sudo apk add vhs-fish-completion- License: MIT
- Architecture: x86_64
- Source Package: vhs
- normalized package name match
- Matched by: Vhs
apk95%
vhs-zsh-completion 0.11.0-r2
Zsh completions for vhs
https://github.com/charmbracelet/vhs
sudo apk add vhs-zsh-completion- License: MIT
- Architecture: x86_64
- Source Package: vhs
- normalized package name match
- Matched by: Vhs
dnf95%
vhs 0.11.0-2.fc45
Your CLI home video recorder
https://github.com/charmbracelet/vhs
sudo dnf install vhs- License: Apache-2.0 AND BSD-3-Clause AND MIT AND MPL-2.0 AND OFL-1.1
- Category: Unspecified
- Architecture: x86_64
- Source Package: vhs
- 5 dependencies
- 2 provides
- normalized package name match
- Matched by: Vhs
pacman95%
vhs 0.11.0-1
A tool for recording terminal GIFs
https://github.com/charmbracelet/vhs
sudo pacman -S vhs- License: MIT
- Architecture: x86_64
- 3 dependencies
- normalized package name match
- Matched by: Vhs
zypper95%
vhs 0.9.0-1.11
CLI video recorder
https://github.com/charmbracelet/vhs
sudo zypper install vhs- License: MIT
- Category: Unspecified
- Architecture: x86_64
- Source Package: vhs
- 3 dependencies
- 1 provides
- normalized package name match
- Matched by: Vhs
zypper95%
vhs-bash-completion 0.9.0-1.11
Bash Completion for vhs
https://github.com/charmbracelet/vhs
sudo zypper install vhs-bash-completion- License: MIT
- Category: System/Shells
- Architecture: noarch
- Source Package: vhs
- 2 dependencies
- 1 provides
- normalized package name match
- Matched by: Vhs
zypper95%
vhs-doc 0.9.0-1.11
Documentation for vhs
https://github.com/charmbracelet/vhs
sudo zypper install vhs-doc- License: MIT
- Category: System/Shells
- Architecture: noarch
- Source Package: vhs
- 2 dependencies
- 1 provides
- normalized package name match
- Matched by: Vhs
zypper95%
vhs-fish-completion 0.9.0-1.11
Fish Completion for vhs
https://github.com/charmbracelet/vhs
sudo zypper install vhs-fish-completion- License: MIT
- Category: System/Shells
- Architecture: noarch
- Source Package: vhs
- 2 dependencies
- 1 provides
- normalized package name match
- Matched by: Vhs
zypper95%
vhs-zsh-completion 0.9.0-1.11
Zsh Completion for vhs
https://github.com/charmbracelet/vhs
sudo zypper install vhs-zsh-completion- License: MIT
- Category: System/Shells
- Architecture: noarch
- Source Package: vhs
- 2 dependencies
- 1 provides
- normalized package name match
- Matched by: Vhs
MacPorts95%
vhs
sudo port install vhs- normalized package name match
- Matched by: Vhs
Scoop95%
main/vhs
scoop install main/vhs- normalized package name match
- Matched by: Vhs
winget95%
charmbracelet.vhs
winget install --id charmbracelet.vhs -e- normalized package name match
- Matched by: Vhs
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment