VHS Action
Keep your GIFs up to date with VHS + GitHub actions π½οΈ
The above GIF is automatically generated on CI with GitHub actions and VHS.
Getting Started
To get started with GitHub actions you can read the documentation.
To add vhs-action to your project you will need to:
- Create
.github/workflows/vhs.ymlin your project directory. - Copy one of the
examples/into yourvhs.yml. - Create your tape files with the instructions to perform (See VHS instructions on
.tapefiles) - Trigger your action by creating a pull request or making a commit depending on your
vhs.ymlfile.
That's all! Anytime the action is triggered, GitHub actions and VHS will regenerate the GIF from your .tape file on CI.
This is useful for keeping demos updated and performing integration testing to catch errors in your PRs.
Inputs
| Name | Description | Default |
|---|---|---|
path |
Path of the VHS .tape file |
"" (install VHS without running it) |
version |
Version of VHS to use | "latest" |
token |
GitHub token to use | "${{ github.token }}" |
install-fonts |
Whether to install extra fonts | "false" |
The action provides JetBrains Mono by default. Extra fonts (and their
nerd font variations) can be installed by setting install-fonts
to true.
Extra fonts
- Bitstream Vera Sans Mono
- DejaVu
- Fira Code
- Hack
- IBM Plex Mono
- Inconsolata
- Liberation
- Roboto Mono
- Source Code Pro
- Ubuntu Mono
Examples
- Auto-commit latest generated GIF file (example)
- Upload GIF to host and comment generated GIF on a pull request (example)
Feedback
Weβd love to hear your thoughts on this project. Feel free to drop us a note!
License
Part of Charm.
Charmηη±εΌζΊ β’ Charm loves open source