If you use macOS and brew, install with brew install asciinema. ASCII Cinema, get it?
Run asciinema auth and open the link that appears in the terminal, in the browser where you are logged into asciinema. This links your localhost with your account, so when you make a screen recording on that host, it will be linked and appear when you are logged in. You can see what localhosts are linked in the “recorder tokens” section in Settings in the web app:
The following recorder tokens have been associated with your account:
c06f7b2a-22af-4b05-9abb-e1c2345d4321 registered on Tue, 18 Aug 2020 04:19:44 Z - Revoke
Record a session by issuing asciinema rec -t "Title of the Session" changing the title to taste. Press ctrl-D to exit, and you’ll get a message like:
asciinema: recording finished
asciinema: press <enter> to upload to asciinema.org, <ctrl-c> to save locally
View the recording at:
user=86.94s system=68.94s cpu=69% total=3:44.77
You can download the “cast” files for sharing, as well. They are tiny, compared to video screencasts.
$ ll 345381.cast
Permissions Size User Group Date Modified Name
.rw-r--r--@ 87k rcogley staff 2020-08-18 14:45 345381.cast