ASCIInema

ASCIInema en una plataforma que permite registrar y almacenar el texto que aparece en la terminal. Funciona capturando la salida de texto ASCII del intérprete de comandos actual, y guardándola en un fichero .cast. Este fichero puede quedar local y reproducirlo mas tarde, y opcionalmente se lo puede subír a una plataforma de agregado de capturas de terminal, asciinema.org.

Las capturas subidas a ASCIInema.org pueden hacerse públicas, no listadas (para compartir con una URL específica) o bien dejarse privados.

Si deseas grabar la salida de la sesión de terminal a un fichero local, ingresa:

asciinema rec ~/archivo.cast

Esto iniciará un intérprete de comandos anidado, y comenzará a registrar la grabación en el fichero local ~/archivo.cast. Para detener la grabación, ingresa Ctrl+d: esto detendrá el intérprete anidado y guardará la salida de terminal en archivo.cast.

Si inicias una subida de una captura de terminal .cast a la plataforma, se te proveerá un URL que deberás introducir en un navegador. Esto te permitirá o bien asociar la grabación a un usuario de asciinema previamente existente (si lo tuviéses), o bien a un correo electrónico que desees asignar al usuario de asciinema para iniciar el proceso de registro en asciinema.org. En caso de ser la primera vez que lo h aces, debes aceptar el enlace que te llegue por correo electrónico, lo cual adosará un token a tu usuario. Entonces subirá la captura de terminal asociándolo al mismo. Podrás asociar o revocar tokens (lo cual útil en caso de tener varios dispositivos).

En texto-plano, podrás grabar el contenido de la sesión actual de terminal y subirlo a la plataforma asciinema.org con un título, mediante:

asciinema rec -t "Sesión de terminal de ~$USER en texto-plano.xyz"

…o bien no indicar título alguno (no recomendado):

asciinema rec

La grabación comenzará inmediatamente. Cuando desees interrumpir la grabación e iniciar la subida, deberás concluir la sesión del intérprete de comandos anidado, mediante Ctrl+d.

Una opción muy interesante que tiene ASCIInema es la de limitar el tiempo inactivo de la terminal, evitándolo si supera un período determinado. Por ejemplo, para limitar el tiempo máximo inactivo a 1,5 segundos, podríamos utilizar

asciinema rec -i 1.5 archivo.cast

Podrás usar asciinema para reproducir capturas de terminal realizadas con la plataforma. Por ejemplo, para reproducir el fichero ~/archivo.cast ingresa:

asciinema play ~/archivo.cast

Siempre podrás detener una reproducción con Ctrl+z.

Por otro lado, también podrías reproducir cualquier captura almacenada en la plataforma asciinema.org. Para ello ingresa su URL, de este modo:

asciinema play https://asciinema.org/a/444386

También es posible presentar en pantalla todo el archivo.cast mediante el comando cat, a fin de lograr la reproducción desde cualquier sistema tipo Unix. Para ello ingresa:

asciinema cat archivo.cast

Si ya tienes un usuario creado en la plataforma, podrás subir un fichero .cast a ASCIInema.org.

Para ello ingresa:

asciinema upload archivo.cast -t "Título de la Captura"

Una vez que hayas subido tu captura a la plataforma asciinema.org, podrás obtener un enlace para compartir para el registro en ASCII específica haciendo clic en el enlace “Share” en la página de la transmisión correspondiente en la plataforma ASCIInema.org

Cualquiera de las opciones listadas en la sección “Personalizando la reproducción” permite agregar la URL de la transmsión ASCII y una serie de parámetros opcionales. Por ejemplo:

https://asciinema.org/a/14?t=25&speed=2&theme=solarized-dark

De esta manera, al visitar este enlace se comenzará la reproducción a los 25 segundos y se reproducirá al doble de velocidad, utilizando el tema de terminal Solarized Dark.

En los lugares donde no se permiten los guiones, podrás pegar en enlace como si se tratara de un enlace de imagen. Por ejemplo, en un fichero README.

Podrás incluso incrustar fracciones de un asciicast específico presionando el botón “Share” en la página de ASCIIcast.

En caso de usar HTML, utiliza este formato:

<a href="https://asciinema.org/a/14"><img src="https://asciinema.org/a/14.png" width="836"/></a>

En caso de usar Markdown, recurre a este formato:

[![asciicast](https://asciinema.org/a/14.png)](https://asciinema.org/a/14)

A su vez, podrás pasar opciones extra (listadas en la sección “personalizar el reproductor”) a la URL enlazada como “parámetros”. Por ejemplo, para iniciar la reproducción automáticamente al abrir el enlace de asciicast, agrega la cadena ?autoplay=1 a la URL dentro del atributo href indicado, de esta forma:

<a href="https://asciinema.org/a/14?autoplay=1"><img src="https://asciinema.org/a/14.png" width="836"/></a>

Si deseas incrustar el widget del reproductor en tu propia página web o en un sitio que permite el etiquetado de guiones, podrás recurrir a hacer clic en el enlace “Embbed” de la página del asciicast.

Se te presentará un código con una apariencia similar a la siguiente:

<script src="https://asciinema.org/a/14.js" id="asciicast-14" async></script>