RC Logr 20200818 132712

Tuesday, 18 Aug, 2020

Learned about the sweet free and open source «@Asciinema» service today, which lets you record your terminal sessions for sharing. Read on for a few tips. 🤩

• Create an account at https://asciinema.org by supplying an email, click on the link in an email you will receive to create an account, then give yourself a username. This creates a profile URL like: https://asciinema.org/~rickcogley
• 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:

1
2
3

Recorder tokens
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:

1
2
3
4
5
6
7

asciinema: recording finished
asciinema: press <enter> to upload to asciinema.org, <ctrl-c> to save locally

View the recording at:
    https://asciinema.org/a/UzPY3BQvQ8NkBJffOEn7T6hYq

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.

1
2
3

 $ ll 345381.cast
 Permissions Size User    Group Date Modified    Name
 .rw-r--r--@  87k rcogley staff 2020-08-18 14:45 345381.cast