VHS Language Cheat Sheet09 Nov 2022
Many developers who are constantly writing blog posts or giving a presentation at conferences may want a tool to record their terminal screenshots easily like me. In addition, you may wish to be free from the burden of re-recording or editing the demo video many times to adjust the content and format.
I found VHS allows us to do that work in a programmable manner. Moreover, it provides a simple programming language to write the scenario shown in the terminal.
For instance, this program can quickly generate the following footage recording the terminal.
Output hello.gif Set FontSize 32 Set Width 1200 Set Height 600 Type "echo 'Hello, World'" Sleep 500ms Enter Sleep 5s
This tool is so easy to use that I want to write here the basic usage of VHS as a sort of cheat sheet.
First, you write the program in an ordinal text file with the extension
.tape. After that, you can use any text editor you like. Then
vhs executes the program and outputs the final artifact in the specified format.
$ vim hello.tape $ vhs < hello.tape # You will get `hello.gif` file
Specify file output file. Usable formats are
.webm, or a collection of
Set recording configuration to control the appearance of the terminal. Available subcommands are:
TypingSpeed controls the global configuration to set the typing speed. A command-based configuration can overwrite it with
Set TypingSpeed 0.1 Type "100ms delay per character" [email protected] "500ms delay per character"
You can choose any theme available here.
Emulate typing. You can launch any other program available in the
$PATH in the terminal you are running the
vhs. This feature makes me even happier because there is no need to remember other special commands or syntax. Just typing like I usually do is sufficient. For example, the following tape writes the executable python program in the REPL.
Output python_add.gif Set FontSize 32 Set Width 1200 Set Height 600 Type "python3" Sleep 500ms Enter Type "def add(x, y):" Enter Tab Type "return x + y" Enter 2 Sleep 500ms Type "result = add(1, 3)" Enter Type "print(result)" Enter Sleep 2s
Down respectively. You can set the number of types of these cursor movements following the command. The same rule applies to the following special keys as well.
Output cursor.gif Set FontSize 32 Set Width 1200 Set Height 600 Type "echo 'Hello, World'" Sleep 500ms Left 10 Right 8 Left 5 Sleep 5s
Space special keys are also available. They are especially critical to write the program in the VHS environment.
Wait for a certain amount of time.
Showing/Hiding Type Movement
Hide is helpful to keep the typing command from being recorded. This type of command may include some prerequisites or cleanup commands in this category. Note that the final thing we type is shown with
Hide but not capturing frames. Exiting from the non-capturing mode, we can use
VHS is just a programming language, so we can build up some valuable tools running on top of it. That will accelerate our blog writing or demo preparation significantly.