3.1 KiB
Installation
There are several ways to get asciinema recorder:
- Installing via Pip
- Installing on Linux
- Installing on Linux as snap (universal Linux package)
- Installing on macOS
- Installing on FreeBSD
- Installing on OpenBSD
- Running in Docker container
- Running from source
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
{: #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
{: #installing-on-linux}
Arch Linux
pacman -S asciinema
Debian
sudo apt-get install asciinema
Fedora
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
openSUSE
zypper in asciinema
Ubuntu
sudo apt-add-repository ppa:zanchey/asciinema
sudo apt-get update
sudo apt-get install asciinema
Installing on Linux as snap
{: #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
{: #installing-on-macos}
Homebrew
brew install asciinema
MacPorts
sudo port selfupdate && sudo port install asciinema
Nix
nix-env -i asciinema
Installing on FreeBSD
{: #installing-on-freebsd}
Ports
cd /usr/ports/textproc/asciinema && make install
Packages
pkg install asciinema
Installing on OpenBSD
{: #installing-on-openbsd}
pkg_add asciinema
Running in Docker container
{: #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
{: #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 https://github.com/asciinema/asciinema.git
cd asciinema
python3 -m asciinema --version