snippetbashTip

asciinema — Record and replay terminal sessions, and optionally share them on <https://asciinema.org>. See also:

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

terminalcommandreplayandclisessionsrecordasciinema

Problem

How to use the asciinema command: Record and replay terminal sessions, and optionally share them on <https://asciinema.org>. See also: terminalizer. More information: <https://docs.asciinema.org/manual/cli/>.

Solution

asciinema — Record and replay terminal sessions, and optionally share them on <https://asciinema.org>. See also: terminalizer. More information: <https://docs.asciinema.org/manual/cli/>.

Associate the local install of asciinema with an asciinema.org account:

asciinema {{[a|auth]}}

Make a new recording and save it to a local file (finish it with <Ctrl d> or type exit):

asciinema {{[r|record]}} {{path/to/recording.cast}}

Replay a terminal recording from a local file:

asciinema {{[p|play]}} {{path/to/recording.cast}}

Replay a terminal recording hosted on <https://asciinema.org>:

asciinema {{[p|play]}} https://asciinema.org/a/{{cast_id}}

Make a new recording, limiting any idle time to at most 2.5 seconds:

asciinema {{[r|record]}} {{[-i|--idle-time-limit]}} 2.5

Print the full output of a locally saved recording:

asciinema {{[ca|cat]}} {{path/to/recording.cast}}

Upload a locally saved terminal session to asciinema.org:

asciinema {{[u|upload]}} {{path/to/recording.cast}}

Stream the current terminal on a local webpage:

asciinema {{[st|stream]}} --local

Code Snippets

Associate the local install of `asciinema` with an asciinema.org account

asciinema {{[a|auth]}}

Make a new recording and save it to a local file (finish it with `<Ctrl d>` or type `exit`)

asciinema {{[r|record]}} {{path/to/recording.cast}}

Replay a terminal recording from a local file

asciinema {{[p|play]}} {{path/to/recording.cast}}

Replay a terminal recording hosted on <https://asciinema.org>

asciinema {{[p|play]}} https://asciinema.org/a/{{cast_id}}

Make a new recording, limiting any idle time to at most 2.5 seconds

asciinema {{[r|record]}} {{[-i|--idle-time-limit]}} 2.5

Context

tldr-pages: common/asciinema

Revisions (0)

No revisions yet.