2024-01-03           COMBINING EMACS AND ASCIINEMA

How to record an Emacs demo using Asciinema.

Asciinema[1] [as-kee-nuh-muh] is a free and open source solution for
recording terminal sessions and sharing them on the web.

However

*That is not as easy as it looks.*

Emacs special keys
-----------------

  Most terminals don't know about Meta or Ctrl, so I run

  ,----
  | xterm -fa 'Monospace' -fs 12
  `----

  because unlike Gnome-terminal, Xterm recognises the Ctrl Key. And for
  meta, I temporarily switch to using the ESC key.

  I then run Asciinema and emacsclient to connect to the running Emacs.


  ,----
  | asciinema rec -c "emacsclient -nw" -i 2 -t "Emacs Recording" \
  | /tmp/emacs-session.cast
  `----


  This command creates a local file, it does not upload it to the public
  [asciinema] server. You can replay it:

  ,----
  |  asciinema play /tmp/emacs-session.cast
  `----

[1]: https://asciinema.org/