Grabar y compartir vídeo de la terminal con Asciinema

Si queremos compartir las acciones en una terminal y su salida tenemos varias opciones, la más simple es ejecutar el comando y copiar la salida en un archivo de texto, correo electrónico o artículo de una bitácora. Sin embargo, con esta opción solo tenemos el contenido final del comando y a veces en donde se usan varios comandos o que limpian la terminal (como por ejemplo con ssh) es difícil seguir en esa foto final la salida que se ha ido produciendo en la terminal. Otra opción es crear un vídeo tradicional de imágenes que podamos reproducir con VLC para ver la evolución de la salida tal y como se produce, sin embargo, en esta opción perdemos el poder copiar y pegar texto, es habitual que tengamos que parar el vídeo y escribir el comando o la salida que vemos en el vídeo, esto es lento y propenso a errores ya que podemos confundirnos varias veces al teclear lo que vemos en el vídeo. Otra opción mejor es usar Asciinema que captura el texto de la terminal y crea un vídeo de texto que representa la sesión de terminal que hemos tenido.

Asciinema es como un vídeo pero de texto que además podemos compartir para que otras personas lo vean y que podemos incrustar en páginas web como artículos de bitácoras. Además permite seleccionar y copiar texto y seguro que necesita mucho menos ancho de banda que un vídeo de YouTube. Empezar a crear vídeos de texto es tan sencillo como descargar el binario de Asciinema o instalarlo con el gestor de paquetes de la distribución GNU/Linux que usemos, también se puede usar en Mac OS y FreeBSD.

Una vez instalado, podemos iniciar una grabación de la terminal, esto creará un archivo video.asciinema. Podremos parar la grabación con la combinación de teclas ctrl+d o tecleando el comando exit:

1
2

$ asciinema rec --max-wait=2 video.asciinema

Reproducir el vídeo creado con:

1
2

$ asciinema play video.asciinema

Y compartirlo con:

1
2

$ asciinema upload video.asciinema

Para compartir los vídeos solo necesitaremos una cuenta de correo, no necesitaremos una clave ya que la autenticación en Asciinema se hace mediante un enlace que se nos envían a nuestra cuenta de correo cada vez que queremos acceder a nuestra cuenta. Si instalamos Asciinema por segunda vez o en otro ordenador y queremos asociarlo con la cuenta que ya tenemos podemos hacerlo con:

1
2

$ asciinema auth

En la documentación de Asciinema están las opciones completas que podemos usar por ejemplo para añadir un título al vídeo o para ejecutar un comando directamente. Una vez que tenemos subido el vídeo a la web de Asciinema podemos compartirlo ya sea enviando en enlace del vídeo o con un reproductor embebido en una página web o artículo de un blog. Para esto último deberemos incluir un script de JavaScript para el reproductor de la siguiente forma, con el atributo id indicamos el vídeo que queremos reproducir, en la documentación de las opciones para embeber los vídeos podemos ver las opciones completas que podemos emplear:

1
2

<script type="text/javascript" src="https://asciinema.org/a/17648.js" id="asciicast-17648" async></script>

Y este es el resultado de un vídeo en el que muestro un Script para instalar Arch Linux fácil, rápido, desatendido, automatizado y personalizable.