2.9 KiB
<% content_for(:title, 'Installation') %>
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
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
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
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
Homebrew
<%= render 'install_homebrew' %>
MacPorts
sudo port selfupdate && sudo port install asciinema
Nix
nix-env -i asciinema
Installing on FreeBSD
Ports
cd /usr/ports/textproc/asciinema && make install
Packages
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 https://github.com/asciinema/asciinema.git
cd asciinema
python3 -m asciinema --version