Como gravar demos de terminal e CLI que dá para acompanhar

Demos de terminal estão entre os vídeos mais úteis que uma pessoa desenvolvedora pode fazer. Também estão entre os mais difíceis de assistir. Texto monoespaçado minúsculo, uma parede de saída rolando, um comando que some pelo topo da tela antes de alguém conseguir ler — e o espectador desiste em dois minutos.

A solução está quase toda na preparação. Uma gravação de terminal que funciona é construída antes de apertar Gravar, não resgatada depois. Veja o processo completo.

Por que gravações de terminal são difíceis de assistir

Gravações de interface gráfica têm âncoras visuais: botões, ícones, layout. O terminal não tem nenhuma. Tudo tem o mesmo tamanho, a mesma cor, e passa rápido. Os problemas são sempre os mesmos:

• Texto pequeno demais: uma fonte confortável à distância de um braço fica ilegível num vídeo 1080p reproduzido em uma janela pequena
• Temas de baixo contraste: cinza apagado sobre quase preto parece elegante no seu monitor e some depois da compressão de vídeo
• Saída que passa rolando: a linha interessante voa enquanto você ainda comenta o comando
• Entrada invisível: quem assiste não vê suas teclas, então uma flag digitada rápido parece mágica
• Tempo morto: instalações, builds e suítes de teste geram trinta segundos em que nada acontece

Cada um deles tem solução em menos de cinco minutos.

Configure o terminal antes de gravar

Trate seu terminal de demonstração como um ambiente separado do terminal de trabalho. A maioria dos apps de terminal aceita perfis: crie um chamado “Recording” e configure uma única vez.

• Fonte de 18 a 24 pt: mais ou menos o dobro do que você usa normalmente. Se parecer absurdo no seu monitor, provavelmente está certo para vídeo
• Tema de alto contraste: texto claro sobre fundo escuro sólido. Evite transparência e imagens de fundo por completo — comprimem mal e só acrescentam ruído visual
• Tamanho de janela, não tela cheia: um terminal em tela cheia grande demais encolhe o texto em relação ao quadro. Uma janela de 90–100 colunas preenche bem um quadro 16:9
• Desligue as ligaduras se confundirem: os glifos de seta para -> e != atrapalham quem tenta copiar seus comandos
• Aumente um pouco o espaçamento entre linhas: um respiro faz muita diferença numa saída densa

Limpe seu shell

Prompt e histórico carregam mais informação do que você imagina. Antes de gravar:

• Simplifique o prompt: um prompt longo com branch do Git, versão do Node, timestamp e caminho em duas linhas come espaço horizontal e distrai. Um curto ~/project $ é o ideal
• Esconda usuário e hostname: eles identificam você e sua máquina num vídeo que talvez seja publicado
• Limpe o buffer de rolagem e o histórico: comandos anteriores podem revelar nomes de clientes, hosts internos ou trabalhos alheios
• Confira suas variáveis de ambiente: a saída de env em vídeo já vazou mais chaves de API do que qualquer trecho de código
• Use um diretório descartável: uma pasta de projeto limpa evita arquivos aleatórios na saída do ls
• Desative notificações: o bipe do terminal e os pop-ups do sistema estragam uma tomada

Se a demo envolve credenciais reais, use valores fictícios. Censurar na pós-produção dá muito mais trabalho do que definir API_KEY=demo-key-1234 antes.

Planeje a sequência de comandos

Escreva os comandos antes de gravar — num arquivo de rascunho, não de cabeça. Um roteiro curto com exatamente o que você vai digitar, na ordem, faz três coisas: evita erros de digitação sob pressão, mantém a demo em linha reta e vira o esboço da sua narração.

Depois faça um ensaio completo, sem gravar. É aí que aparecem as surpresas: um cache já aquecido, uma dependência que falta instalar, uma confirmação que você tinha esquecido. Ao terminar, restaure o diretório para que a gravação comece do mesmo estado.

Configurações de gravação para trabalho no terminal

O conteúdo do terminal é quase todo texto estático, o que o torna tolerante em alguns aspectos e exigente em outros.

• Capture a janela, não a tela inteira: a captura de janela mantém o enquadramento no terminal e esconde o resto da área de trabalho
• 30fps bastam: texto não precisa de 60fps. Taxas menores ainda deixam o texto mais nítido com o mesmo bitrate
• Grave na resolução nativa do monitor: ampliar o texto depois é justamente o que causa o borrão
• Dispense a webcam, ou deixe-a pequena: numa demo de terminal o assunto é a saída. Um PiP grande cobre o canto inferior, exatamente onde surge o texto novo

Ritmo: a parte que quase todo mundo erra

O ritmo de uma boa demo de terminal não é o ritmo com que você trabalha.

1. Diga o que vai fazer antes de digitar: “Agora vou instalar a CLI globalmente”
2. Digite num ritmo constante e deliberado — mais devagar que o normal, mas sem exagero
3. Pause um instante antes do Enter para que o comando completo fique visível e legível
4. Fique em silêncio enquanto a saída aparece e comente depois
5. Aponte o que importa em vez de ler a saída inteira em voz alta

Para comandos longos, digite-os em duas etapas visíveis — primeiro o comando base, depois as flags — explicando o que cada flag faz. É muito mais fácil de acompanhar do que uma linha de quarenta caracteres surgindo de uma vez.

Lidando com comandos demorados

Ninguém quer assistir a um npm install de noventa segundos. Você tem três boas opções:

• Rampa de velocidade: mantenha o comando visível e passe a espera em 4x–10x, mostrando que aconteceu sem obrigar ninguém a esperar
• Corte a espera: corte do início do comando até pouco antes do resultado. Corte numa linha de prompt e a edição fica invisível
• Aqueça o cache: rode o comando uma vez antes de gravar e, na tomada, ele termina naturalmente em poucos segundos

Seja qual for a escolha, diga em voz alta quanto tempo leva de verdade — “isso costuma levar uns dois minutos” — para ninguém se surpreender ao tentar sozinho.

Torne a saída legível no editor

É na edição que uma gravação razoável de terminal vira uma boa gravação.

• Dê zoom na saída importante: aproximar das três linhas que interessam funciona muito melhor do que pedir que apertem os olhos diante de uma tela de logs
• Adicione sobreposições de texto para comandos-chave: colocar o comando na tela como legenda dá algo para ler enquanto você narra
• Anote mensagens de erro: quando mostrar uma falha de propósito, destaque a linha que a explica
• Adicione capítulos: Instalação, Configuração, Primeira execução, Solução de problemas — demos de terminal são seguidas na prática, e as pessoas voltam atrás
• Remova os silêncios: a remoção automática de silêncio aperta os intervalos ao redor dos comandos sem mexer na sua fala

Misturando o terminal com outras janelas

Poucas demos reais são só terminal. Você roda um comando, confere o navegador e edita um arquivo de configuração.

• Defina o layout antes de gravar: terminal e navegador lado a lado, ou alternância em tela cheia — escolha um e mantenha
• Se trocar de janela, pause antes: dê meio segundo para registrarem a mudança antes de continuar falando
• Mantenha os tamanhos de fonte coerentes: uma fonte grande no terminal ao lado de uma minúscula no editor deixa o editor ilegível
• Considere captura de área: com um layout fixo de duas janelas, capturar essa região mantém o enquadramento estável no vídeo todo

Checklist antes de gravar

[ ] Perfil de gravação ativo: fonte grande, tema de alto contraste, sem transparência
[ ] Prompt simplificado, usuário e hostname escondidos
[ ] Buffer de rolagem e histórico limpos
[ ] Segredos substituídos por valores fictícios
[ ] Sequência de comandos escrita e ensaiada uma vez
[ ] Diretório de trabalho restaurado para um estado limpo
[ ] Notificações e bipe do terminal desativados
[ ] Captura de janela selecionada, 30fps, resolução nativa
[ ] Teste de dez segundos verificado quanto à legibilidade

Esse último item é o mais importante. Grave dez segundos, reproduza no tamanho em que seu público realmente vai assistir e pergunte se dá para ler com conforto. Se não der, aumente a fonte e teste de novo antes de encarar uma tomada de doze minutos.

Erros comuns

• Gravar em tela cheia num monitor 4K: o texto fica microscópico no vídeo exportado
• Limpar a tela o tempo todo: quem assiste perde o contexto do que acabou de acontecer
• Redimensionar o terminal durante a gravação: o texto se reorganiza e o efeito é desagradável
• Ler a saída palavra por palavra: resuma — “todos os doze testes passam”
• Deixar o cursor piscando num quadro parado: corte essas pontas, elas fazem o vídeo parecer travado
• Supor que conhecem seus aliases: se você digita gs, diga que é git status

Conclusão

Uma demo de terminal se sustenta na legibilidade. Fonte grande, tema de alto contraste, prompt limpo, sequência ensaiada e uma batida de pausa antes de cada Enter. Depois, no editor, zoom e rampas de velocidade mantêm a atenção onde a saída importa. Com isso, seus passo a passo de linha de comando deixam de ser algo que se suporta e passam a ser algo que as pessoas acompanham com o próprio terminal aberto ao lado.