Como gravar sua sessão de terminal no Linux

Gravar uma sessão de terminal pode ser importante para ajudar alguém a aprender um processo, compartilhar informações de uma maneira compreensível e também apresentar uma série de comandos de forma adequada. Seja qual for o propósito, há muitas vezes em que copiar e colar texto do terminal não será muito útil, enquanto capturar um vídeo do processo é bastante complicado e pode não ser sempre possível. Neste guia rápido, vamos dar uma olhada na maneira mais fácil de gravar e compartilhar uma sessão de terminal no formato .gif.

Pré-requisitos

Se você só quer gravar suas sessões de terminal e ser capaz de reproduzir a gravação em seu terminal, ou compartilhá-las com pessoas que usarão um terminal para reprodução, então a única ferramenta que você precisará se chama “ttyrec”. Usuários do Ubuntu podem instalá-la inserindo o seguinte comando em um terminal:

sudo apt-get install ttyrec

Se você quiser produzir um arquivo .gif a partir da gravação e ser capaz de compartilhá-lo com pessoas que não usam o terminal, publicá-lo em sites, ou simplesmente manter um .gif à mão para quando precisar dele em vez de comandos escritos, você terá que instalar dois pacotes adicionais. O primeiro é “imagemagick” que você pode instalar com:

sudo apt-get install imagemagick

e o segundo é “tty2gif” que pode ser baixado daqui. Este último tem uma dependência que pode ser satisfeita com:

sudo apt-get install python-opster

Capturando

Para começar a capturar a sessão do terminal, tudo o que você precisa fazer é simplesmente começar com “ttyrec” + enter. Isso lançará a ferramenta de gravação em tempo real que funcionará em segundo plano até que entremos “exit” ou pressionemos “Ctrl+D”. Por padrão, o ttyrec cria um arquivo chamado “ttyrecord” no destino da sessão do terminal que por padrão é “Home”.

Reproduzindo

Reproduzir o arquivo é tão simples quanto abrir um terminal no destino do arquivo “ttyrecord” e usar o comando “ttyplay” seguido pelo nome da gravação (no nosso caso é ttyrecord, mas você pode mudar isso para o que quiser).

Isso resultará na reprodução da sessão gravada, em tempo real, e com correções de digitação incluídas (todas as ações são gravadas). Isso parecerá uma sessão de terminal automatizada completamente normal, mas os comandos e sua aparente execução não são realmente aplicados ao sistema, pois são apenas reproduzidos como uma gravação.

É também importante notar que a reprodução da gravação da sessão do terminal é completamente controlável. Você pode dobrar a velocidade de reprodução pressionando o botão “+”, desacelerá-la com o botão “-“, pausá-la com “0” e retomar a velocidade normal com “1”.

Convertendo em um .gif

Por razões de conveniência, muitos de nós gostaríamos de converter a sessão gravada em um arquivo .gif, e isso é muito fácil de fazer. Veja como:

Primeiro, descompacte o “tty2gif.tar.bz2” baixado abrindo um terminal na localização do download e inserindo o seguinte comando:

tar xvfj tty2gif.tar.bz2

Em seguida, copie o arquivo resultante “tty2gif.py” para o destino do arquivo “ttyrecord” (ou qualquer que seja o nome que você especificou), e então abra um terminal nesse destino e digite o comando:

python tty2gif.py typing ttyrecord

Se você estiver recebendo erros nesta etapa, verifique se você instalou o pacote “python-opster”. Se os erros persistirem, dê os seguintes dois comandos consecutivamente:

sudo apt-get install xdotool  
export WINDOWID=$(xdotool getwindowfocus)

depois repita o “python tty2gif.py typing ttyrecord” e você deve agora ver uma série de arquivos gif que foram criados na localização do “ttyrecord”

O próximo passo é unificar todos esses gifs que correspondem a ações individuais da sessão do terminal em um único arquivo final .gif usando a utilidade imagemagick. Para fazer isso, abra um terminal no destino e insira o seguinte comando:

convert -delay 25 -loop 0 *.gif example.gif

Você pode nomear o arquivo resultante como quiser (eu usei “example.gif”), e você pode alterar as configurações de atraso e loop conforme necessário. Aqui está o arquivo resultante deste rápido tutorial: