vhs

Your CLI home video recorder

write terminal GIFs as code for integration testing and demoing your CLI tools.

terminal

https://github.com/charmbracelet/vhs

arm64 amd64

Installation

1. Add WakeMeOps repository

curl -sSL https://raw.githubusercontent.com/upciti/wakemeops/main/assets/install_repository | sudo bash

2. Install vhs

sudo apt install vhs

Snippets

DockerfileGithub Action

FROM wakemeops/minideb:bullseye

RUN install_packages \
    vhs=0.11.0*

USER 1001

- name: Install dependencies
  uses: upciti/wakemeops-action@v1
  with:
    packages: |
      vhs=0.11.0*

Download URLs

amd64arm64

Version	SHA256	Size (KB)
0.11.0	35caae350ea2460e0b7afb3d7e6b87a0639601d1702ddfbd110a97a2ab90e4f7	7330
0.10.0	cf8956da6b1cc039f77550e2f0e132fd07b4dfe48eb19ac071fed2a4fc498747	7329
0.9.0	4cd8184ebc82bee1877b82e7ade9fd0c19b418df42d32c010e654e39be86c9a7	7032
0.8.0	1607f8724552c38d45c77830bb2137d7d17cb47d99747a5eaf705ec895aa5c84	7023

Version	SHA256	Size (KB)
0.11.0	236ec80233a607f6b612363b0f1828e3045d9c902fb6cfbdec0d360ab2bd5c6a	6600
0.10.0	ccb510eba714986ddf5e82ad47b67261a10efe6fb13eace3f89558a236a0aa25	6604
0.9.0	1124b97afe743a63181e821505c54fc83675150e6d1a987a8a643d96e852ffe1	6371
0.8.0	ebb1176e54cba09d8bfdb5b862bc44528c3453830cda0fdc7a5cd712b52a2b93	6364

Blueprints

Debian packages listed on this page are generated from op2deb YAML blueprints. Blueprints for vhs are versioned here.

Click here to see vhs ops2deb blueprints

https://github.com/upciti/wakemeops/blob/main/blueprints/terminal/vhs/ops2deb.yml

name: vhs
matrix:
  architectures:
    - amd64
    - arm64
  versions:
    - 0.8.0
    - 0.9.0
    - 0.10.0
    - 0.11.0
homepage: https://github.com/charmbracelet/vhs
summary: your CLI home video recorder
description: write terminal GIFs as code for integration testing and demoing your
  CLI tools.
fetch:
  url: https://github.com/charmbracelet/vhs/releases/download/v{{version}}/vhs_{{version}}_Linux_{{target}}.tar.gz
  targets:
    amd64: x86_64
install:
  - vhs_{{version}}_Linux_{{target}}/vhs:/usr/bin/

The blueprint fetch keyword contains a URL template pointing to vhs releases. Downloaded files are locked in a lockfile versioned here.

Click here to see vhs release hashes

https://github.com/upciti/wakemeops/blob/main/blueprints/terminal/vhs/ops2deb.lock.yml

- url: https://github.com/charmbracelet/vhs/releases/download/v0.8.0/vhs_0.8.0_Linux_arm64.tar.gz
  sha256: 8625f2b02ba5a7626841e3045be767ca1da30920fb567b6488387c1a47853db9
  timestamp: 2025-01-02 18:51:01+00:00
- url: https://github.com/charmbracelet/vhs/releases/download/v0.8.0/vhs_0.8.0_Linux_x86_64.tar.gz
  sha256: 0371e5b57b335330272aba6992656b6785e2e5d8538d6e4d85dcfd9f70400c5b
  timestamp: 2025-01-02 18:51:01+00:00
- url: https://github.com/charmbracelet/vhs/releases/download/v0.9.0/vhs_0.9.0_Linux_arm64.tar.gz
  sha256: d272dc1460d90c0ba1f69d9bfed0e29666272e76948fe905a713083a338ed08a
  timestamp: 2025-01-15 21:06:04+00:00
- url: https://github.com/charmbracelet/vhs/releases/download/v0.9.0/vhs_0.9.0_Linux_x86_64.tar.gz
  sha256: db0b38837489930513353dbf988a8d48e9750040dbb1cd6dd1a883c6fe213962
  timestamp: 2025-01-15 21:06:04+00:00
- url: https://github.com/charmbracelet/vhs/releases/download/v0.10.0/vhs_0.10.0_Linux_arm64.tar.gz
  sha256: 6d7300028d4641b9dc004a05cf411d40f1e12e560cc6fca985dd90504b6652a7
  timestamp: 2025-06-17 21:06:43+00:00
- url: https://github.com/charmbracelet/vhs/releases/download/v0.10.0/vhs_0.10.0_Linux_x86_64.tar.gz
  sha256: b552c3870aca101dcafe533cfef32dceb7b783400ad32642e728775c9f125407
  timestamp: 2025-06-17 21:06:43+00:00
- url: https://github.com/charmbracelet/vhs/releases/download/v0.11.0/vhs_0.11.0_Linux_arm64.tar.gz
  sha256: af782cddbf844a377df6ea41c0e72339393fa021be3f6cb70a2f47d48675d92b
  timestamp: 2026-03-11 00:08:21+00:00
- url: https://github.com/charmbracelet/vhs/releases/download/v0.11.0/vhs_0.11.0_Linux_x86_64.tar.gz
  sha256: 99cb634587eaae0473c1ea377db80c3a048c27f99fe0a7febb1a1e8cb7ee5009
  timestamp: 2026-03-11 00:08:21+00:00

Badge

MarkdownHTMLRST

[![WakeMeOps](https://docs.wakemeops.com/badges/vhs.svg)](https://docs.wakemeops.com/packages/vhs)

<a href="https://docs.wakemeops.com/packages/vhs">
  <img src="https://docs.wakemeops.com/badges/vhs.svg"/>
</a>

.. image:: https://docs.wakemeops.com/badges/vhs.svg
:target: https://docs.wakemeops.com/packages/vhs