asciinema

asciinema rec|play|cat|convert|upload|stream|session|auth [options] [file]

asciinema records and replays terminal sessions. It captures terminal output with timing information, creating lightweight recordings that can be shared or embedded on websites.Unlike video screen recording, asciinema recordings are text-based, allowing copy-paste from playback and producing small file sizes.

rec file

Record terminal session. In 3.0+ the filename is required, and rec no longer uploads (use the upload command).

Playback recorded session

Concatenate two or more recordings into one (3.0+).

Convert a recording to another asciicast format (3.0+).

Upload recording to asciinema.org

Live stream the terminal session (3.0+).

Generic session that can record, stream, or both (3.0+).

Authenticate this install with your asciinema server account

Recording title

Command to record (default: $SHELL)

Maximum idle time between frames

Shorthand for --idle-time-limit

Playback speed multiplier

Override terminal dimensions

~/.config/asciinema/config.toml

User configuration file (TOML) in CLI 3.0+ for default recording settings, server URL, and authentication. Earlier 2.x releases used ~/.config/asciinema/config.

Recordings capture exactly what appears in terminal, including sensitive data. Review before uploading. Playback requires terminal with same capabilities as recording.

asciinema was created by Marcin Kulik, with the first version released around 2011. It has become the standard tool for terminal recording and sharing.

script(1), ttyrec(1), agg(1)

Source code · Homepage · Documentation