# asciinema/asciinema

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/asciinema-asciinema).**

16,852 stars · 1,004 forks · Rust · gpl-3.0

## Links

- GitHub: https://github.com/asciinema/asciinema
- Homepage: https://asciinema.org
- awesome-repositories: https://awesome-repositories.com/repository/asciinema-asciinema.md

## Topics

`asciicast` `asciinema` `cli` `recording` `rust` `streaming` `terminal`

## Description

Asciinema is a platform for capturing, replaying, and sharing command-line sessions. It provides a comprehensive suite of tools to record terminal activity into lightweight, text-based files that preserve ANSI escape sequences, allowing users to document technical workflows, troubleshooting steps, and software demonstrations with high fidelity.

The project distinguishes itself through its versatile playback and distribution capabilities. It features a web-based player that renders interactive terminal sessions directly in the browser, supporting features like seeking, playback speed control, and custom visual themes. Beyond interactive playback, it includes utilities for converting recordings into animated images or videos, and provides infrastructure for self-hosting recording servers to maintain full control over data storage and security.

The platform supports a wide range of integration and automation needs, including embedding interactive sessions into technical documentation, broadcasting live terminal activity to remote viewers, and programmatically generating recordings via scripts. It also offers robust management tools for indexing, searching, and organizing historical session data.

The software is designed for flexible deployment, with server and storage components packaged into containerized units for independent hosting.

## Tags

### Development Tools & Productivity

- [Terminal Session Recorders](https://awesome-repositories.com/f/development-tools-productivity/terminal-shell-cli/terminal-cli-enhancements/shell-terminal-utilities/general-enhancements-tooling/terminal-utilities/appearance-sessions/terminal-session-recorders.md) — Captures terminal input and output into lightweight files for recording shell sessions. ([source](https://docs.asciinema.org/manual/cli/shortcuts/))
- [Web-Based Recorders](https://awesome-repositories.com/f/development-tools-productivity/terminal-shell-cli/terminal-cli-enhancements/shell-terminal-utilities/general-enhancements-tooling/terminal-utilities/appearance-sessions/terminal-session-recorders/web-based-recorders.md) — Renders interactive terminal sessions directly in the browser with playback controls and custom themes.
- [Session Servers](https://awesome-repositories.com/f/development-tools-productivity/terminal-shell-cli/terminal-cli-enhancements/shell-terminal-utilities/general-enhancements-tooling/terminal-utilities/appearance-sessions/terminal-session-recorders/session-servers.md) — Provides self-hosted infrastructure for storing, managing, and broadcasting live or recorded command-line sessions.
- [Terminal Escape Sequence Parsers](https://awesome-repositories.com/f/development-tools-productivity/terminal-escape-sequence-parsers.md) — "Parses raw terminal output streams to accurately reconstruct text, color, and cursor movements within diverse rendering environments."
- [Animation Converters](https://awesome-repositories.com/f/development-tools-productivity/terminal-shell-cli/terminal-cli-enhancements/shell-terminal-utilities/general-enhancements-tooling/terminal-utilities/appearance-sessions/terminal-session-recorders/animation-converters.md) — Transforms recorded terminal sessions into animated GIF or video files for embedding in documentation and presentations.
- [Terminal Playback Engines](https://awesome-repositories.com/f/development-tools-productivity/event-driven-engines/terminal-playback-engines.md) — "Manages the temporal progression of terminal sessions by processing event buffers and synchronizing visual updates with playback controls."
- [Recording Converters](https://awesome-repositories.com/f/development-tools-productivity/terminal-shell-cli/terminal-cli-enhancements/shell-terminal-utilities/general-enhancements-tooling/terminal-utilities/appearance-sessions/terminal-session-recorders/recording-converters.md) — Transforming text-based command-line logs into animated images or videos for easy sharing on platforms that do not support interactive players.

### Operating Systems & Systems Programming

- [ANSI Escape Sequence Renderers](https://awesome-repositories.com/f/operating-systems-systems-programming/terminal-command-line-environments/terminal-management/output-rendering-engines/ansi-escape-sequence-renderers.md) — Interprets ANSI escape sequences to accurately replicate terminal text, colors, and cursor movements in web browsers. ([source](https://docs.asciinema.org/how-it-works/))
- [Terminal Customization](https://awesome-repositories.com/f/operating-systems-systems-programming/terminal-command-line-environments/terminal-customization-tools/terminal-customization.md) — Provides configuration for terminal themes, font families, and rendering backends to control aesthetic output. ([source](https://docs.asciinema.org/manual/agg/usage/))
- [Session Media Renderers](https://awesome-repositories.com/f/operating-systems-systems-programming/terminal-command-line-environments/terminal-management/terminal-session-managers/session-media-renderers.md) — The platform renders terminal session recordings into animated image files or videos, supporting various input sources and output formats. ([source](https://docs.asciinema.org/manual/agg/usage/))

### User Interface & Experience

- [Playback Controllers](https://awesome-repositories.com/f/user-interface-experience/playback-controllers.md) — Provides interactive controls for pausing, resuming, and seeking through recorded terminal sessions. ([source](https://docs.asciinema.org/manual/cli/shortcuts/))
- [Component Embedding](https://awesome-repositories.com/f/user-interface-experience/component-embedding.md) — The platform generates portable player components and preview images for embedding interactive terminal recordings into external websites and documentation. ([source](https://docs.asciinema.org/manual/cli/quick-start/))
- [Session Recording](https://awesome-repositories.com/f/user-interface-experience/session-recording.md) — Provides tools for modifying session files, including trimming content and adjusting playback speed. ([source](https://docs.asciinema.org/integrations/))
- [Session Recording Management](https://awesome-repositories.com/f/user-interface-experience/session-recording-management.md) — The platform offers API access to upload, organize, and retrieve terminal session recordings for historical auditing and review. ([source](https://docs.asciinema.org/manual/server/api/))
- [oEmbed Providers](https://awesome-repositories.com/f/user-interface-experience/media-embeds/oembed-providers.md) — The platform provides oEmbed endpoints that allow external platforms to automatically fetch and render recording previews using standard web protocols. ([source](https://docs.asciinema.org/manual/server/embedding/))
- [Lifecycle Managers](https://awesome-repositories.com/f/user-interface-experience/session-recording-management/lifecycle-managers.md) — Enforces upload size limits, defines custom storage paths, and automates the removal of unclaimed recordings. ([source](https://docs.asciinema.org/manual/server/self-hosting/configuration/))

### Web Development

- [Browser-Based Terminal Players](https://awesome-repositories.com/f/web-development/terminal-rendering-engines/browser-based-terminal-players.md) — "Replicates the terminal display layer within a web browser to enable interactive playback and text selection of recorded sessions."

### DevOps & Infrastructure

- [Self-Hosted Infrastructure](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-infrastructure.md) — Deploying private server instances to store, manage, and share terminal session data while maintaining full control over security and storage.
- [Self-Hosted Deployment Infrastructure](https://awesome-repositories.com/f/devops-infrastructure/deployment-management/self-hosted-infrastructure-management/self-hosted-deployment-infrastructure.md) — "Packages the server and storage components into portable units to allow independent deployment and full data ownership."
- [Self-Hosted Backend Configurations](https://awesome-repositories.com/f/devops-infrastructure/infrastructure/private-enterprise-management/self-hosted-services/self-hosted-backend-configurations.md) — Supports directing terminal recordings to custom or self-hosted server instances via configuration. ([source](https://docs.asciinema.org/manual/cli/configuration/))

### Data & Databases

- [Terminal Session Serializers](https://awesome-repositories.com/f/data-databases/data-processing-pipelines/data-serialization/json-serializers/terminal-session-serializers.md) — "Encodes terminal activity into a stream of time-stamped events and metadata for efficient storage and sequential playback." ([source](https://docs.asciinema.org/manual/asciicast/v1/))
- [Terminal Session Broadcasters](https://awesome-repositories.com/f/data-databases/record-updating/live-update-subscriptions/event-stream-broadcasters/terminal-session-broadcasters.md) — Streaming real-time command-line sessions to remote viewers for collaborative debugging, pair programming, or live technical presentations.
- [Search & Indexing Engines](https://awesome-repositories.com/f/data-databases/search-indexing-engines.md) — Indexes the full text of recorded terminal sessions to enable rapid discovery of specific commands or output. ([source](https://docs.asciinema.org/manual/server/))

### Graphics & Multimedia

- [Terminal Format Parsers](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-manipulation/image-processing/format-support-extensions/terminal-format-parsers.md) — Supports native and legacy terminal recording formats through an extensible parsing architecture. ([source](https://docs.asciinema.org/manual/player/parsers/))
- [Streaming and Broadcasting](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting.md) — Broadcasts terminal activity in real-time to remote viewers using network protocols. ([source](https://docs.asciinema.org/manual/server/streaming/))
- [Playback Event Hooks](https://awesome-repositories.com/f/graphics-multimedia/audio-music/audio-playback/playback-engine-integration/playback-event-hooks.md) — Allows developers to register custom handlers for specific actions or state changes during terminal session playback. ([source](https://docs.asciinema.org/manual/player/api/))

### Education & Learning Resources

- [Interactive Terminal Embeds](https://awesome-repositories.com/f/education-learning-resources/learning-platforms-infrastructure/educational-infrastructure/educational-platforms/interactive-coding-environments/interactive-technical-documentation/interactive-terminal-embeds.md) — Embedding interactive terminal sessions into websites and documentation to provide clear, copyable, and reproducible command-line examples.

### Networking & Communication

- [Real-Time Data Streams](https://awesome-repositories.com/f/networking-communication/real-time-data-streams.md) — "Facilitates low-latency broadcasting of terminal sessions by pushing event streams directly from the host to connected remote viewers."
- [Streaming APIs](https://awesome-repositories.com/f/networking-communication/streaming-apis.md) — The platform provides API endpoints to create, update, and manage real-time streaming sessions for collaborative troubleshooting or live demonstrations. ([source](https://docs.asciinema.org/manual/server/api/))

### Artificial Intelligence & ML

- [Terminal Transcripts](https://awesome-repositories.com/f/artificial-intelligence-ml/audio-transcription/transcription-exporters/terminal-transcripts.md) — Converts recorded terminal sessions into plain text files for raw command-line output extraction and analysis. ([source](https://docs.asciinema.org/manual/server/))

### System Administration & Monitoring

- [Server Management Interfaces](https://awesome-repositories.com/f/system-administration-monitoring/server-management-interfaces.md) — Provides an administrative interface for overseeing server operations, configuration, and service management. ([source](https://docs.asciinema.org/manual/server/self-hosting/admin/))
