Releases · charmbracelet/vhs (original) (raw)

v0.11.0

Scroll? More keys?

This release includes two nice features that include scrolling the viewport and supporting Ctrl+<arrow> keys. You can now use the ScrollUp and ScrollDown commands to scroll the viewport. VHS will also now recognize Ctrl+Left/Up/Right/Down keys.

Thanks to @joshka-oai and @sectore for their gracious contributions and support 🙂

Changelog

New!

Fixed

Other stuff

Verifying the artifacts

First, download the checksums.txt file and the checksums.txt.sigstore.json file files, for example, with wget:

wget 'https://github.com/charmbracelet/vhs/releases/download/v0.11.0/checksums.txt' wget 'https://github.com/charmbracelet/vhs/releases/download/v0.11.0/checksums.txt.sigstore.json'

Then, verify it using cosign:

cosign verify-blob
--certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main'
--certificate-oidc-issuer 'https://token.actions.githubusercontent.com'
--bundle 'checksums.txt.sigstore.json'
./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

The Charm logo

Thoughts? Questions? We love hearing from you. Feel free to reach out on X, Discord, Slack, The Fediverse, Bluesky.

v0.10.0

Changelog

New Features

Bug fixes

Dependency updates

Documentation updates

Other work

Verifying the artifacts

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/vhs/releases/download/v0.10.0/checksums.txt'

Then, verify it using cosign:

cosign verify-blob
--certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main'
--certificate-oidc-issuer 'https://token.actions.githubusercontent.com'
--cert 'https://github.com/charmbracelet/vhs/releases/download/v0.10.0/checksums.txt.pem'
--signature 'https://github.com/charmbracelet/vhs/releases/download/v0.10.0/checksums.txt.sig'
./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

The Charm logo

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v0.9.0

VHS v0.9.0

Hurry up and Wait

This release introduces the Wait keyword:

Output wait.gif
Require gum
Type "./slow.sh"
Enter
Wait+Screen@10s /Hello/
Type "echo Lets Go!"
Enter
Sleep 1

Made with VHS

This allows you to remove all the random Sleeps in your tape files!
You can now wait for specific conditions instead. This means more control while simplifying tape file creation.

More shells

There's also support for xonsh and osh, so you can now use them in
your tapes as well:

Output examples/settings/set-shell-xonsh.gif
Set FontSize 38
Set Height 225
Set Shell xonsh
Sleep 1s
Type "I am using xonsh."
Sleep 2s

Made with VHS

Changelog

New Features

Bug fixes

Documentation updates

Other work

Verifying the artifacts

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/vhs/releases/download/v0.9.0/checksums.txt'

Then, verify it using cosign:

cosign verify-blob
--certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main'
--certificate-oidc-issuer 'https://token.actions.githubusercontent.com'
--cert 'https://github.com/charmbracelet/vhs/releases/download/v0.9.0/checksums.txt.pem'
--signature 'https://github.com/charmbracelet/vhs/releases/download/v0.9.0/checksums.txt.sig'
./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

The Charm logo

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v0.8.0

Environmental friendliness

Ever want to alter the environment in your .tape files? Now you can with the ENV directive:

Env HELLO "WORLD"

Type "echo $HELLO" Enter Sleep 1s

Bonus: change the prompt

Also thanks to @Delta456, you can now change the prompt by setting PROMPT in the environment:

For details see: #469.

Changelog

New!

Fixed

Docs

Other stuff

Verifying the artifacts

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/vhs/releases/download/v0.8.0/checksums.txt'

Then, verify it using cosign:

cosign verify-blob
--certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main'
--certificate-oidc-issuer 'https://token.actions.githubusercontent.com'
--cert 'https://github.com/charmbracelet/vhs/releases/download/v0.8.0/checksums.txt.pem'
--signature 'https://github.com/charmbracelet/vhs/releases/download/v0.8.0/checksums.txt.sig'
./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

The Charm logo

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v0.7.2

Changelog

Bug fixes

Other work

Verifying the artifacts

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/vhs/releases/download/v0.7.2/checksums.txt'

Then, verify it using cosign:

cosign verify-blob
--certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main'
--certificate-oidc-issuer 'https://token.actions.githubusercontent.com'
--cert 'https://github.com/charmbracelet/vhs/releases/download/v0.7.2/checksums.txt.pem'
--signature 'https://github.com/charmbracelet/vhs/releases/download/v0.7.2/checksums.txt.sig'
./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

The Charm logo

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v0.7.1

Freeze Frame ❄️ 📸

With VHS v0.7.0, you can capture the any moment during tape execution. Just add in Screenshot <filename>.png to your tapes:

Type ls Enter

Capture the output of 'ls'

Screenshot files.png

Now, continue as you normally would

Type 'cd ..' Enter

Your tape outputs a GIF, and outputs a file named files.png.

Copy-Paste Functionality!

VHS can now talk to your system clipboard. Please keep this in mind when executing tapes from unknown sources.

Warning

You should never curl pipe into VHS, it's similar to executing a bash script on your computer!

Copy "https://github.com/charmbracelet/huh"

Type 'curl '

Paste

Enter

New Modifiers + Keys Alert!

VHS v0.7.0 has some new additions: introducing the top level Shift+ modifier and the Insert + Delete keys!

Shift things up a bit!

Shift+A Shift+Tab Shift+Enter

Insert and delete to your hearts desire:

Insert Delete

The Charm logo

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or Discord.

v0.7.0

Freeze Frame ❄️ 📸

With VHS v0.7.0, you can capture the any moment during tape execution. Just add in Screenshot <filename>.png to your tapes:

Type ls Enter

Capture the output of 'ls'

Screenshot files.png

Now, continue as you normally would

Type 'cd ..' Enter

Your tape outputs a GIF, and outputs a file named files.png.

Copy-Paste Functionality!

VHS can now talk to your system clipboard. Please keep this in mind when executing tapes from unknown sources.

Warning

You should never curl pipe into VHS, it's similar to executing a bash script on your computer!

Copy "https://github.com/charmbracelet/huh"

Type 'curl '

Paste

Enter

New Modifiers + Keys Alert!

VHS v0.7.0 has some new additions: introducing the top level Shift+ modifier and the Insert + Delete keys!

Shift things up a bit!

Shift+A Shift+Tab Shift+Enter

Insert and delete to your hearts desire:

Insert Delete

The Charm logo

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or Discord.

v0.6.0

This release of VHS features 3 new additions as well as several small bug fixes to make sure everything runs smoothly.

New Features

Font Fallback

VHS now falls back to using Apple Symbols on MacOS to render braille characters without empty dots.

Alt + Shift modifiers

Ctrl[+Alt][+Shift]+<char>

Ctrl commands can now be modified with Alt or Shift characters to perform different key press combinations.

To avoid cursor blinking, simply use the CursorBlink setting (defaults to true).

The Charm logo

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v0.5.0

VHS Sorcery 🪄

This release of VHS includes a brand new Source command:
You can now include (Source) other tape files into other tape files to reuse collections of commands that you find yourself repeating. This allows you to build tape modules and compose parent tape files.

To get started, let's create two tape files:

touch source.tape touch demo.tape

In source.tape place any commands you repeat often

Type "I'm being summoned." Sleep 500ms Enter

Then, in demo.tape, you can Source source.tape which will execute all the commands found in the sourced tape file.

Output out.gif Set Height 1000 Source source.tape # this will execute all commands in ./source.tape Type "That's all folks" Enter

When you run vhs demo.tape it will perform all the commands within the tape file and when it reaches the Source invocation it will execute all the commands in type.tape:

Other features

Bug Fixes

This release of VHS fixes a bug that caused incorrect background rendering (#249).
In addition to using the latest version of VHS, you will also need to upgrade ttyd to use the latest commit on main.

New Contributors

Full Changelog: v0.4.0...v0.5.0

The Charm logo

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v0.4.0

Terminal Decorations 🎨

The latest version of VHS includes a ton of new settings for you to play around with! These settings allow you to decorate your GIFs and make them look even more like terminal emulators.

This release also includes a new Alt command, a --quiet flag for silent outputs, and bug fixes when starting up different shells.

New Settings

Set Margin 80 Set MarginFill "#674EFF" Set WindowBar "Colorful" Set WindowBarSize 40 Set BorderRadius 8

Launch with Shell

This version of VHS performs the Shell change upon launch, rather than switching shells after starting the ttyd process. This change should result in slightly faster recordings and reduce the occurrence of buggy flashes at the start of GIFs that appeared occasionally when shell switching was slow.

Alt command

VHS now supports pressing the Left Alt key with the newly introduced Alt command. It behaves similarly to pressing Ctrl along with another key.

Quiet Output

If you prefer to create your VHS GIFs without any output, simply add the -quiet flag. This will minimize any output to just the essentials.

The Charm logo

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.