asciinema
Capture and share terminal sessions with a lightweight, text-based approach. Forget blurry videos—easily embed recordings and copy-paste text directly.
Forget heavy screen recording apps and blurry videos. This free and open-source solution offers a lightweight, text-based approach to recording terminal sessions and sharing them on the web. Because the recordings capture actual terminal output rather than pixels, viewers can pause the playback and copy-paste the text directly from the player.
Recording is incredibly simple and happens right where you work. Just run a simple command in your terminal to start capturing, and exit when you are done.
Key benefits include:
- Text-based playback: Enjoy crisp, clear terminal sessions without the massive file sizes of traditional video.
- Copy and paste functionality: Pause any recording to select and copy the exact code or commands you need.
- Seamless embedding: Easily integrate the player into your blog posts, project documentation, or conference talk slides.
- Open-source: Completely free to use and supported by a community of developers.
Directory Structure
asciinema
data
.env
docker-compose.yml
docker-compose.yml
services:
postgres:
image: postgres:15-alpine
restart: unless-stopped
environment:
POSTGRES_USER: postgres
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
POSTGRES_DB: asciinema
volumes:
- ./data/postgres:/var/lib/postgresql/data
asciinema:
image: ghcr.io/asciinema/asciinema-server:latest
restart: unless-stopped
depends_on:
- postgres
ports:
- "4000:4000"
environment:
DATABASE_URL: postgres://postgres:${POSTGRES_PASSWORD}@postgres/asciinema
SECRET_KEY_BASE: ${SECRET_KEY_BASE}
# Optional: Configure these if running behind a reverse proxy or on a specific domain
# URL_HOST: localhost
# URL_SCHEME: http
# URL_PORT: 4000
volumes:
- ./data/uploads:/opt/app/uploads
- ./data/config:/opt/app/config.env
POSTGRES_PASSWORD=secure_postgres_password
SECRET_KEY_BASE=generate_a_secure_random_string_here_openssl_rand_base64_48Categories:
Ad
Similar to asciinema