# Install asciinema with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper Record and share terminal sessions. Version 3.2.1 via Homebrew; verified 2026-06-16. ## Install ```sh sudo av install brew:asciinema ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install asciinema ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install asciinema ``` Evidence: MacPorts ports tree: sysutils/asciinema/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add asciinema ``` Evidence: Alpine Linux edge package indexes: asciinema from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install asciinema ``` Evidence: Debian stable package indexes: asciinema from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - dnf (92%): ```sh sudo dnf install asciinema ``` Evidence: Fedora Rawhide package metadata: asciinema from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#asciinema ``` Evidence: nixpkgs package indexes: pkgs/by-name/as/asciinema/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S asciinema ``` Evidence: Arch Linux sync databases: asciinema from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install asciinema ``` Evidence: openSUSE Tumbleweed package metadata: asciinema from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:asciinema - **Package manager:** Homebrew - **Package manager page:** - **Version:** 3.2.1 - **Source summary:** Record and share terminal sessions - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-3.0-only - **Source archive:** - **Last updated:** 2026-06-16T19:14:11Z - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - asciinema (cli) - asciinema (alias) ## Build dependencies - rust ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 3.2.1 - Package-manager updated: 2026-06-16 - Local data: ok - Upstream repository: https://github.com/asciinema/asciinema - Upstream latest detected: v3.2.1 (current) ## Project history and usage asciinema is a terminal-session recorder, streamer, and player built around lightweight terminal event captures rather than conventional video files. It became a standard CLI/package-manager tool for sharing reproducible terminal demos, bug reports, tutorials, and command-line workflows. ### Project history The GitHub repository was created in 2011 and the project identifies Marcin Kulik as copyright holder from that year. The early release stream reached v0.1 in 2012 and v1.0.0 in March 2015, establishing asciinema as a small command-line recorder tied to the asciinema.org sharing service. The project evolved from a Python implementation to a Rust implementation. The current README says active development happens on the `develop` branch, that the current 3.x generation is written in Rust, and that the previous 2.x generation written in Python remains available on the `python` branch. ### Adoption history asciinema spread because it solved a packaging-era problem: terminal sessions are text streams, not pixels, so they can be captured, replayed, embedded, uploaded, and versioned more naturally than screen recordings. Its official README emphasizes `.cast` files, terminal replay, web embedding, server upload, and live streaming. The input package facts show broad distribution across Alpine, Homebrew, Debian, Fedora, MacPorts, Nix, Arch, Ubuntu, and openSUSE packaging. That breadth matches actual usage: developers install it from the system package manager, run `asciinema rec`, then share the resulting recording locally, on asciinema.org, or on a self-hosted server. ### How it is used Common usage is `asciinema rec demo.cast` to capture a shell session, replaying recordings in a terminal, embedding them on a web page with asciinema-player, or uploading/streaming them through an asciinema server. CLI 3.x adds TOML configuration at the user and system level for server URL, recording behavior, playback, notifications, and hotkeys. ### Why package nerds care asciinema is a classic terminal-culture package: tiny command, durable text-like artifact, easy package-manager install, and excellent demos in READMEs and bug reports. It also has a notable implementation migration from Python to Rust, which affects downstream packagers, dependency closure, generated man pages, and shell completions. ### Timeline - 2011: GitHub repository created; project copyright line starts at 2011. - 2012: v0.1 tag commit in the repository. - 2015: v1.0.0 release published. - 2018: v2.0.0 release published. - 2025: v3.0.0 release published, marking the Rust 3.x generation. - 2026: v3.2.1 release published. ### Related projects - asciinema-player embeds recordings on web pages. - asciinema-server, including asciinema.org, hosts uploads and relay streaming. - The asciicast file format is the recording format used by the CLI and player. ### Sources - - - - - source_facts.package-manager ## Security Notes broad file, network, media, or database tool signal. - **Geiger risk:** blue / medium - broad file, network, media, or database tool signal ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.config/asciinema/config.toml, /etc/asciinema/config.toml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** asciinema - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - asciinema - 2.4.0-1: normalized package name match | Debian stable package indexes: asciinema from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Record and share your terminal sessions, the right way | https://asciinema.org - Nix - asciinema: normalized package name match | nixpkgs package indexes: pkgs/by-name/as/asciinema/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - asciinema - 2.4.0-1: normalized package name match | Ubuntu 24.04 LTS package indexes: asciinema from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Record and share your terminal sessions, the right way | https://asciinema.org - apk - asciinema - 3.2.0-r0: normalized package name match | Alpine Linux edge package indexes: asciinema from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Command line recorder for the asciinema.org service | https://github.com/asciinema/asciinema - apk - asciinema-bash-completion - 3.2.0-r0: normalized package name match | Alpine Linux edge package indexes: asciinema-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for asciinema | https://github.com/asciinema/asciinema - apk - asciinema-doc - 3.2.0-r0: normalized package name match | Alpine Linux edge package indexes: asciinema-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Command line recorder for the asciinema.org service (documentation) | https://github.com/asciinema/asciinema - apk - asciinema-fish-completion - 3.2.0-r0: normalized package name match | Alpine Linux edge package indexes: asciinema-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fish completions for asciinema | https://github.com/asciinema/asciinema - apk - asciinema-zsh-completion - 3.2.0-r0: normalized package name match | Alpine Linux edge package indexes: asciinema-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for asciinema | https://github.com/asciinema/asciinema - dnf - asciinema - 3.2.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: asciinema from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Terminal session recorder, streamer and player | https://asciinema.org - pacman - asciinema - 3.2.0-1: normalized package name match | Arch Linux sync databases: asciinema from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Record and share terminal sessions | https://asciinema.org - zypper - asciinema - 3.2.0-2.1: normalized package name match | openSUSE Tumbleweed package metadata: asciinema from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Terminal session recorder | https://asciinema.org - MacPorts - asciinema: normalized package name match | MacPorts ports tree: sysutils/asciinema/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [termrec](https://www.automicvault.com/pkg/brew/termrec/) - Shares av.db curated category or tags: cli, developer-tools, recording, terminal. - [vhs](https://www.automicvault.com/pkg/brew/vhs/) - Shares av.db curated category or tags: cli, developer-tools, recording, terminal. - [aha](https://www.automicvault.com/pkg/brew/aha/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [amtterm](https://www.automicvault.com/pkg/brew/amtterm/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [ansifilter](https://www.automicvault.com/pkg/brew/ansifilter/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [aoe](https://www.automicvault.com/pkg/brew/aoe/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [aurora](https://www.automicvault.com/pkg/brew/aurora/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [bitwise](https://www.automicvault.com/pkg/brew/bitwise/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [termsvg](https://www.automicvault.com/pkg/brew/termsvg/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, record, recording. ## Combined YAML source View the package source record on GitHub. [combined/asciinema.yml](https://github.com/automic-vault/db/blob/main/combined/asciinema.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph