asciinema
Terminal session recorder
Decision gist · record as of 2026-08-14
Yes, if you need a lightweight, dependency-free terminal recorder for demos, documentation, or archival. The dormant maintenance status is a concern for long-term compatibility and security updates, but the package is stable and has no known vulnerabilities. Suitable for one-off or occasional use; not recommended if you require active maintenance or expect to rely on it in production workflows.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Low install friction with no runtime dependencies.
- Maintenance status is dormant—last release was in 2023—so expect no active bug fixes or feature updates, though the package is marked Production/Stable.
License · maintenance · safety
GNU GPLv3 (copyleft) — Licensed under GNU GPLv3 (copyleft). Any derivative work or distribution must also be open source under compatible terms; proprietary use is not permitted.
last release 2023-10-23 (1026 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 10,660,052 downloads/mo, #1,441 on PyPI
Alternatives
Verify before relying
pip install asciinema
asciinema rec demo.cast
# (record your terminal session, then exit)
asciinema play demo.cast- Whether dormant status affects compatibility with Python 3.10, 3.11 or modern terminal environments
- Current state of asciinema.org upload endpoint and whether it remains operational
- Long-term security implications of no active maintenance since 2023-10-23
What it is and what it does
asciinema is a command-line tool for recording terminal sessions and replaying them later. It captures everything that appears on screen—commands, output, timing—into a portable .cast file format that can be played back in a terminal at normal or adjusted speed, or uploaded to asciinema.org for sharing via a web browser. The tool runs as a standalone CLI with no external runtime dependencies, making it lightweight to install and use.
Typical workflow: run `asciinema rec filename.cast` to start recording your shell session, execute commands as normal, then exit to save the recording. Later, replay it with `asciinema play filename.cast`, optionally adjusting playback speed or limiting idle time. If you want to share, upload to asciinema.org with `asciinema upload filename.cast` or record directly to the web with `asciinema rec` (no filename). The package supports pausing capture mid-session and recording keyboard input if explicitly enabled.
Use it for
- Create shareable terminal demos or tutorials by recording a shell session and uploading to asciinema.org
- Document command-line workflows or bug reproductions by capturing terminal output with precise timing
- Replay recorded sessions at faster or slower speeds, or with idle time compressed, for training or review
- Archive terminal sessions locally as portable .cast files for later playback without needing the original environment
- Embed terminal recordings in documentation or blogs via asciinema.org's web player
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need a lightweight, dependency-free terminal recorder for demos, documentation, or archival.
The dormant maintenance status is a concern for long-term compatibility and security updates, but the package is stable and has no known vulnerabilities. Suitable for one-off or occasional use; not recommended if you require active maintenance or expect to rely on it in production workflows.
Install
asciinema on PyPI
Before you install
Low install friction with no runtime dependencies. Maintenance status is dormant—last release was in 2023—so expect no active bug fixes or feature updates, though the package is marked Production/Stable.
License in practice
Licensed under GNU GPLv3 (copyleft). Any derivative work or distribution must also be open source under compatible terms; proprietary use is not permitted.
Quickstart
pip install asciinema
asciinema rec demo.cast
# (record your terminal session, then exit)
asciinema play demo.castVerify before relying
- Whether dormant status affects compatibility with Python 3.10, 3.11 or modern terminal environments
- Current state of asciinema.org upload endpoint and whether it remains operational
- Long-term security implications of no active maintenance since 2023-10-23
Package facts
| License | GNU GPLv3 copyleft |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Dormant 1,026 days since the last release |
| First released | |
| Downloads | 10,660,052 / month, #1,441 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleIntended Audience :: DevelopersIntended Audience :: System AdministratorsLicense :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)Natural Language :: EnglishProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: System :: ShellsTopic :: TerminalsTopic :: Utilities |
Evidence: asciinema-2.4.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “terminal session recorder”
- asciinemaRecords and replays terminal sessions, saving them as timestamped…
- tmuxptmuxp saves and loads tmux sessions from YAML or JSON configuration…
- iterm2Provides a Python scripting interface to iTerm2's automation and…
Give your agent the search over MCP, or paste the wish link into any chat.
More Utilities packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Pygments is a syntax highlighter that colorizes source code and text in over 500 languages and formats, outputting to HTML, LaTeX, RTF, SVG, images, or ANSI terminal sequences.
Install it if you need to display or transform source code.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
See also keboola.vcr · pytest-vcr · otel-ci · pycowsay · DataRecorder · tuipet · bcsfe · placebo · SoundCard · vcrpy