asciinema (aka asciinema CLI or asciinema recorder) is a command-line tool for recording terminal sessions.
Unlike typical screen recording software, which records visual output of a
screen into a heavyweight video files (.mp4, .mov), asciinema recorder runs
inside a terminal, capturing terminal session output into a lightweight
recording files in the
asciicast format (.cast).
The recordings can be replayed in a terminal, embedded on a web page with the asciinema player, or published to an asciinema server, such as asciinema.org, for further sharing.
Notable features:
- recording and replaying of sessions inside a terminal,
- live streaming of terminal sessions, with local HTTP server mode, and a relay forwarding mode,
- light-weight recording
format, which is highly
compressible (down to 15% of the original size e.g. with
zstdorgzip), - integration with asciinema server, e.g. asciinema.org, for easy recording hosting.
To record a session run this command in your shell:
asciinema rec demo.castTo stream a session via built-in HTTP server run:
asciinema stream --serveTo stream a session via a relay (asciinema server) run:
asciinema stream --relayCheck out the Getting started guide for installation and usage overview.
Building asciinema from source requires the Rust compiler (1.70 or later), and the Cargo package manager. If they are not available via your system package manager then use rustup.
To download the source code, build the asciinema binary, and install it in
$HOME/.cargo/bin run:
cargo install --locked --git https://github.com/asciinema/asciinemaThen, ensure $HOME/.cargo/bin is in your shell's $PATH.
Alternatively, you can manually download the source code and build the asciinema binary with:
git clone https://github.com/asciinema/asciinema
cd asciinema
cargo build --releaseThis produces the binary in release mode (--release) at
target/release/asciinema. You can just copy the binary to a directory in your
$PATH.
To generate man pages and shell completion files, set ASCIINEMA_GEN_DIR to the
path where these artifacts should be stored. For example:
ASCIINEMA_GEN_DIR=/foo cargo build --releaseThe above command will build the binary and place the man pages in /foo/man/,
and the shell completion files in the /foo/completion/ directory.
Note
Windows is currently not supported. (See #467)
This branch contains the next generation of the asciinema CLI, written in Rust (about the rewrite). It is still in a work-in-progress stage, so if you wish to propose any code changes, please first reach out to the team via forum, Matrix or IRC.
The previous generation of the asciinema CLI, written in Python, can be found in
the main branch.
Sustainability of asciinema development relies on donations and sponsorships.
Please help the software project you use and love. Become a supporter or a corporate sponsor.
asciinema is sponsored by:
If you're interested in integration or customization of asciinema to suit your needs, check asciinema consulting services.
© 2011 Marcin Kulik.
All code is licensed under the GPL, v3 or later. See LICENSE file for details.
