GNU/Linux >> Tutoriales Linux >  >> Linux

Graba tu sesión de terminal con Asciinema

Las llamadas de soporte son importantes y, a menudo, satisfactorias al final, pero el acto de una comunicación clara puede ser arduo para todos los involucrados. Si alguna vez ha estado en una llamada de soporte, probablemente haya pasado varios minutos deletreando incluso los comandos más breves y explicando en detalle dónde caen los espacios y los retornos. Si bien a menudo es más fácil simplemente tomar el control de la computadora de un usuario, esa no es realmente la mejor manera de educar. Lo que podría intentar en su lugar es enviar a un usuario una grabación de pantalla, pero una de la que pueda copiar comandos y pegarlos en su propia terminal.

Asciinema es un grabador de sesión de terminal de código abierto. Similar al script y scriptreplay comandos, Asciinema registra exactamente lo que muestra su terminal. Guarda la grabación de su "película" en un archivo de texto y luego la reproduce a pedido. Puede cargar su película en Asciinema.org y compartirla como lo haría con cualquier otro video en Internet, e incluso puede incrustar su película en una página web.

Instalar Ascinema

En Linux, puede instalar Asciinema usando su administrador de paquetes.

En Fedora, CentOS, Mageia o similar:

$ sudo dnf install asciinema

En Debian, Linux Mint o similar:

$ sudo apt install asciinema

En macOS, puede instalar usando Homebrew:

$ sudo brew install asciinema

En BSD y cualquier otra plataforma que use Pkgsrc:

$ cd /usr/pkgsrc/misc/py-asciinema

$ sudo bmake install clean

Hacer películas a partir de texto

Para comenzar a grabar con Asciinema, usa el rec subcomando:

$ asciinema rec mymovie.cast

asciinema: recording asciicast to mymovie.cast

asciinema: press <ctrl-d> or type "exit" when you're done

Algunas salidas amigables te avisan que estás grabando y te dicen cómo parar:Presiona Ctrl+D o simplemente escriba exit .

Todo lo que haces en tu terminal mientras Asciinema está activo queda registrado. Esto incluye entrada, salida, errores, pausas incómodas, errores o éxitos. Si lo ve en su terminal durante la grabación, hace el corte.

Cuando haya terminado de demostrar cómo funciona la terminal, presione Ctrl+D o escribe exit para detener la grabación.

En este ejemplo, el archivo resultante, mymovie.cast es una colección de marcas de tiempo y acciones que sirven como guión (en el sentido de un guión de película) para el mecanismo de reproducción.

{"version": 2, "width": 139, "height": 36, "timestamp": 1641457358, "env": {"SHELL": "/bin/bash", "TERM": "xterm-256color"}}

[0.05351, "o", "\u001b]0;seth:~\u0007"]

[0.05393, "o", "\u001b[1;31m$ \u001b[00m"]

[1.380059, "o", "e"]

[1.443823, "o", "c"]

[1.514674, "o", "h"]

[1.595238, "o", "o"]

[1.789562, "o", " "]

[2.09658, "o", "\""]

[2.19683, "o", "h"]

[2.403994, "o", "e"]

[2.466784, "o", "l"]

[2.711183, "o", "lo"]

[3.120852, "o", "\""]

[3.427886, "o", "\r\nhello\r\n"]

[...]

Si ha cometido un error, puede eliminar el error eliminando las líneas que recrean el error. Si te encuentras haciendo muchas ediciones o haciendo largas pausas durante la grabación, puedes instalar y usar la utilidad de edición de asciinema, que puede recortar bloques de "metraje" por marcas de tiempo de tu definición, o eliminando el tiempo de inactividad.

Reproducción de una película de Asciinema

Puedes reproducir tu Asciinema usando el play subcomando:

$ asciinema play mymovie.cast

Esto se hace cargo de la sesión de su terminal y la convierte en el equivalente más cercano a la pantalla plateada que probablemente sea (aparte de la vez que vio Star Wars en ASCII a través de telnet). ). Se reproduce su película basada en texto, demostrando a sus usuarios exactamente cómo se realiza una tarea compleja. Por supuesto, el real los comandos que se reproducen en realidad no se ejecutan. Este no es un script de shell en acción, por lo que aunque haya creado un archivo hello.txt en su película, no habrá un nuevo hello.txt después de la reproducción. Esto es solo para mostrar.

Y, sin embargo, es más que un espectáculo. Puede pausar las películas de Asciinema, seleccionar el texto que ve en la pantalla y pegarlo en una terminal activa para ejecutar el comando. Asciinema es una documentación útil. Muestra a los usuarios cómo realizar una tarea y les permite copiar y pegar para garantizar la precisión.

Sube tu película Asciinema 

Ninguna película de Asciinema ha alcanzado aún el estatus de éxito de taquilla, pero puedes subir la tuya a Asciinema.org y compartirla con el mundo de todos modos.

$ asciinema upload mymovie.cast

Más recursos de Linux

  • Hoja de trucos de los comandos de Linux
  • Hoja de trucos de comandos avanzados de Linux
  • Curso en línea gratuito:Descripción general técnica de RHEL
  • Hoja de trucos de red de Linux
  • Hoja de trucos de SELinux
  • Hoja de trucos de los comandos comunes de Linux
  • ¿Qué son los contenedores de Linux?
  • Nuestros últimos artículos sobre Linux

Si está acostumbrado a los tiempos de carga de YouTube, se sorprenderá gratamente de la rapidez con la que se transfieren las películas de Asciinema. Un .cast El archivo suele tener solo unos pocos kilobytes, o como máximo unos pocos megabytes, por lo que la carga es casi instantánea. No necesita una cuenta para compartir su película, pero todas las películas no reclamadas se eliminan después de siete días. Para conservar su obra maestra, puede abrir una cuenta en Asciinema y luego sentarse y esperar a que llame la Academia.

Ascinema como documentación

Asciinema es una excelente manera de demostrar incluso los conceptos más básicos. Debido a que conserva la capacidad de copiar y pegar el código de la grabación, brinda la capacidad de pausar y reproducir a pedido, y es completamente preciso en lo que representa, no es tan bueno como una grabación de pantalla. Es mucho, mucho mejor. Ya sea que lo use para mostrar sus habilidades con la terminal a sus amigos o para educar a colegas y estudiantes, Asciinema es una herramienta invaluable, social y accesible.


Linux
  1. Supervise su sistema Linux en su terminal con procps-ng

  2. Encienda su editor de texto de terminal Linux con ed

  3. Embárcate en una aventura en tu terminal Linux

  4. Compartir sesiones de terminal de Linux con Tmux y Screen

  5. Cómo grabar tu terminal Linux usando asciinema

Grabar sesión de escritorio con Kazam en Ubuntu / Linux Mint

Cómo grabar su sesión de terminal en Linux

Grabar sesiones de terminal usando Asciinema en Linux

Cómo grabar sesiones de terminal de Linux usando Asciinema

Cómo grabar tu pantalla en Ubuntu con SimpleScreenRecorder

tmate:Comparta instantáneamente la sesión de terminal con otros usuarios de Linux