There are several ways to get asciinema recorder:

If you use other operating system and you can build a native package for it then don’t hesitate, do it and let us know. We have Github issue where we track new releases and packaging progress.

Installing via Pip

asciinema is available on PyPI and can be installed with pip (Python 3 required):

sudo pip3 install asciinema

This is the universal installation method for all operating systems, which always provides the latest version.

Installing on Linux

Arch Linux

pacman -S asciinema


sudo apt-get install asciinema


For Fedora < 22:

sudo yum install asciinema

For Fedora >= 22:

sudo dnf install asciinema

Gentoo Linux

emerge -av asciinema

NixOS / Nix

nix-env -i asciinema


zypper in asciinema


sudo apt-add-repository ppa:zanchey/asciinema
sudo apt-get update
sudo apt-get install asciinema

Installing on Linux as snap

Install asciinema in seconds on Ubuntu and other snap supported Linux distributions with:

snap install asciinema --classic

Installing a snap is very quick. Snaps contain all necessary dependencies required to run. The snap will get automatically updated when a new version is pushed to the store.

Installing on macOS


brew install asciinema


sudo port selfupdate && sudo port install asciinema


nix-env -i asciinema

Installing on FreeBSD


cd /usr/ports/textproc/asciinema && make install


pkg install asciinema

Installing on OpenBSD

pkg_add asciinema

Running in Docker container

asciinema Docker image is based on Ubuntu 16.04 and has the latest version of asciinema recorder pre-installed.

docker pull asciinema/asciinema

When running it don’t forget to allocate a pseudo-TTY (-t), keep STDIN open (-i) and mount config directory volume (-v):

docker run --rm -ti -v "$HOME/.config/asciinema":/root/.config/asciinema asciinema/asciinema

Running from source

If none of the above works for you (or you want to help with development) just clone the repo and run latest version of asciinema straight from the master branch:

git clone
cd asciinema
python3 -m asciinema --version