CasTTY is a program similar to ttyrec and
asciinema that makes it easy to
create audio-enabled, terminal-based screencasts for publication on webpages.
It was originally a fork of ttyrec, but has since effectively been
rewritten from scratch.
There may be bugs. Feel free to contribute patches or file an issue!
You probably want to see what you get after you use this.
I've tested CasTTY on macOS Sierra and Linux. It should work on other systems, but if not, please feel free to send a patch. It probably can't record if you don't have a microphone, unless you have some weird audio mixing setup.
It depends on PortAudio (for recording audio) and Concurrency Kit.
There are no UI build dependencies because I find that idea a little silly.
To build, simply run make once dependencies have been installed. If they were
installed to a location other than /usr/local/, you will have to edit the
Makefile.
To use:
% castty
or
% castty -a audio.raw
or
% castty -a audio.raw termevents.js
You may set the rows and columns to capture with the -r and -c options. If
either or both are unset, the value will be the current number in the active
terminal. Resizing isn't currently supported. This is particularly useful if
you like to have a large terminal window, but would like to record for a
smaller screen size (like mobile devices). Do note that larger numbers of rows
and columns can present accessibility challenges for smaller screens.
CasTTY chooses the system's default audio input device. If you wish to use a different device, set it to the default. outputs 16-bit LPCM audio at 44.1kHz. Utilities like sox may be used to convert the audio into more useful formats for web publication.
% sox -D -r 44100 -e signed -b 16 -c 2 -L audio.raw audio.wav
You may of course wish to compress further. There are numerous utilities to help here, but that's a bit out of scope.
By default, castty does not record audio and sends its terminal event output
to a file called events.js.
CasTTY contains a runtime command interface. Commands are entered by first
pressing ^a and then typing the command. All commands begin with a colon. To
send a literal ^a to your shell, you can either type ^a^a or ^aa (in
case you're using screen or emacs or tmux with screen keybindings). Currently
supported commands include:
-
:mute: A toggle to mute or unmute audio input. This literally writes empty audio to the output; it does not stop recording. -
:pause: A toggle to pause or unpause recording entirely. This stops audio recording and recording events in the shell. You may continue to use the shell until you unpause, but if you unpause with the terminal in a different state, things will probably get wacky.
The ui directory of the repository is a self-contained implementation of a
CasTTY player. Utilities used include:
Licenses for all these utilities can be found in their respective repositories and in the LICENSE file in this repository.
To create a cast, simply modify ui/index.html to point to the correct audio
file and events.js output from castty.