Playback with audio?

Posted Jan 13, 2026 19:42 UTC (Tue) by JonathanMatthews (subscriber, #179908)
Parent article: Asciinema: making movies at the command-line

It’d be lovely to be able to use asciinema to record a terminal session whilst (separately but simultaneously) also recording a voiceover to explain what’s being done.

Has anyone seen this being done? The audio recording seems like it would be pretty simple - just trigger a discrete recorder and trim any unnecessary preamble after the fact. The part I’ve not seen working in anger is the sync’d playback; either in a web browser, or by combining the audio and terminal into a single video file.

Playback with audio?

Posted Jan 13, 2026 20:48 UTC (Tue) by jzb (editor, #7867) [Link] (1 responses)

If you host a cast using the asciinema web server, there is an option to add an audio URL that will be sync'ed with playback of the terminal recording. If there's a way to do this with the CLI player, I have not found it.

Playback with audio?

Posted Jan 13, 2026 21:07 UTC (Tue) by JonathanMatthews (subscriber, #179908) [Link]

Oh, thank you for prompting me to recheck it’s built-in capabilities!

The JS API allows for an audio stream URL parameter: https://docs.asciinema.org/manual/player/options/#audiourl. This achieves the main thing I wanted to do - narrating a demo on a webpage :-)