asciinema/asciinema

O que é?

Recursos principais

• 01Grava sessões de terminal em arquivos .cast leves, com opção de capturar a entrada do teclado.
• 02Reproduz gravações com controle de velocidade, loop, limites para tempos ociosos e pausas nos marcadores.
• 03Transmite sessões ao vivo para várias pessoas por meio de um servidor HTTP integrado ou de um servidor de retransmissão.
• 04Oferece suporte a gravações compactadas com zstd e converte entre versões do asciicast e texto simples.
• 05Concatena várias gravações e disponibiliza atalhos de teclado, arquivos de configuração e modo headless para scripts.

Casos de uso

• Documentar fluxos de trabalho de linha de comando ou reproduções de bugs em gravações fáceis de compartilhar e copiar e colar.
• Incorporar demonstrações de terminal à documentação de projetos ou a posts de blog usando o player web.
• Permitir que colegas de equipe ou estudantes assistam a uma sessão de terminal ao vivo pelo navegador.
• Gravar scripts automatizados ou execuções de CI preservando o status de saída.

Início rápido

1. 1

   Instale a CLI com Cargo (requer Rust 1.82 ou posterior).

   cargo install --locked --git https://github.com/asciinema/asciinema
2. 2

   Certifique-se de que $HOME/.cargo/bin esteja no PATH do seu shell.

3. 3

   Grave uma sessão do terminal em um arquivo.

   asciinema rec demo.cast

Antes de usar

• !O Windows não é compatível; o programa funciona em GNU/Linux, macOS e FreeBSD.
• !Licenciado sob GPL-3.0, uma licença copyleft que exige que obras derivadas continuem sendo de código aberto.
• !Para compilar a partir do código-fonte, é necessário ter a cadeia de ferramentas do Rust, versão 1.82 ou posterior.

Em coleções

Tópicos

Perguntas frequentes

O que é asciinema?

Ferramenta de linha de comando que grava, transmite ao vivo e reproduz sessões de terminal em arquivos asciicast leves, em vez de vídeos. asciinema é uma ferramenta de linha de comando para gravar sessões de terminal e transmiti-las ao vivo para quem estiver assistindo. Ela roda dentro de um terminal e captura a saída de texto em um arquivo asciicast (.cast), muito menor que uma gravação de tela. O arquivo pode ser reproduzido em um terminal, incorporado a uma página da web com o player do asciinema ou enviado para um servidor asciinema, como o asciinema.org.

asciinema é gratuito? Qual é a licença?

asciinema é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

asciinema ainda é mantido?

Manutenção ativa. O último commit de asciinema foi em 5 de nov. de 2026.

Para que posso usar asciinema?

Documentar fluxos de trabalho de linha de comando ou reproduções de bugs em gravações fáceis de compartilhar e copiar e colar. Incorporar demonstrações de terminal à documentação de projetos ou a posts de blog usando o player web. Permitir que colegas de equipe ou estudantes assistam a uma sessão de terminal ao vivo pelo navegador. Gravar scripts automatizados ou execuções de CI preservando o status de saída.

Como instalar asciinema?

Instale a CLI com Cargo (requer Rust 1.82 ou posterior).: cargo install --locked --git https://github.com/asciinema/asciinema Certifique-se de que $HOME/.cargo/bin esteja no PATH do seu shell. Grave uma sessão do terminal em um arquivo.: asciinema rec demo.cast

Onde consigo asciinema?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/asciinema/asciinema