GNU/Linux >> Tutoriels Linux >  >> Linux

Enregistrez votre session terminale avec Asciinema

Les appels d'assistance sont importants et souvent satisfaisants en fin de compte, mais l'acte de communication claire peut être ardu pour toutes les personnes impliquées. Si vous avez déjà participé à un appel d'assistance, vous avez probablement passé plusieurs minutes à épeler même les commandes les plus courtes et à expliquer en détail où se situent les espaces et les retours. Bien qu'il soit souvent plus facile de simplement prendre le contrôle de l'ordinateur d'un utilisateur, ce n'est pas vraiment la meilleure façon d'éduquer. Ce que vous pourriez essayer à la place, c'est d'envoyer à un utilisateur un enregistrement d'écran, mais un enregistrement à partir duquel il pourra copier des commandes et les coller dans son propre terminal.

Asciinema est un enregistreur de session de terminal open source. Similaire au script et scriptreplay commandes, Asciinema enregistre exactement ce que votre terminal affiche. Il enregistre votre enregistrement "film" dans un fichier texte, puis le rejoue à la demande. Vous pouvez télécharger votre film sur Asciinema.org et le partager comme vous le feriez pour n'importe quelle autre vidéo sur Internet, et vous pouvez même intégrer votre film dans une page Web.

Install Asciinema

Sous Linux, vous pouvez installer Asciinema en utilisant votre gestionnaire de packages.

Sur Fedora, CentOS, Mageia ou similaire :

$ sudo dnf install asciinema

Sur Debian, Linux Mint ou similaire :

$ sudo apt install asciinema

Sur macOS, vous pouvez installer en utilisant Homebrew :

$ sudo brew install asciinema

Sur BSD et toute autre plate-forme utilisant Pkgsrc :

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

$ sudo bmake install clean

Créer des films à partir de texte

Pour démarrer l'enregistrement avec Asciinema, vous utilisez le rec sous-commande :

$ asciinema rec mymovie.cast

asciinema: recording asciicast to mymovie.cast

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

Une sortie conviviale vous avertit que vous êtes en train d'enregistrer et vous indique comment arrêter :appuyez sur Ctrl+D ou tapez simplement exit .

Tout ce que vous faites dans votre terminal pendant qu'Asciinema est actif est enregistré. Cela inclut les entrées, les sorties, les erreurs, les pauses maladroites, les erreurs ou les réussites. Si vous le voyez dans votre terminal pendant l'enregistrement, il fait la coupe.

Lorsque vous avez terminé la démonstration du fonctionnement du terminal, appuyez sur Ctrl+D ou tapez exit pour arrêter l'enregistrement.

Dans cet exemple, le fichier résultant, mymovie.cast est une collection d'horodatages et d'actions qui servent de script (au sens de script de film) pour le mécanisme de lecture.

{"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 vous avez fait une erreur, vous pouvez couper l'erreur en supprimant les lignes recréant l'erreur. Si vous vous retrouvez à effectuer de nombreuses modifications ou à faire de longues pauses pendant l'enregistrement, vous pouvez installer et utiliser l'utilitaire asciinema-edit, qui peut découper des blocs de "métrage" en horodatant votre définition ou en éliminant le temps d'inactivité.

Lecture d'un film Asciinema

Vous pouvez lire votre Asciinema en utilisant le play sous-commande :

$ asciinema play mymovie.cast

Cela prend en charge votre session de terminal et en fait l'équivalent le plus proche de l'écran d'argent tel qu'il est susceptible de l'être (à part le moment où vous avez regardé Star Wars en ASCII sur telnet ). Votre film textuel est lu, montrant à vos utilisateurs exactement comment une tâche complexe est effectuée. Bien sûr, le réel les commandes jouées ne s'exécutent pas réellement. Ce n'est pas un script shell en action, donc même si vous avez créé un fichier hello.txt dans votre film, il n'y aura pas de nouveau hello.txt après la lecture. C'est juste pour le spectacle.

Et pourtant, c'est plus qu'un simple spectacle. Vous pouvez mettre en pause les films Asciinema, sélectionner le texte que vous voyez à l'écran et le coller dans un terminal actif pour exécuter la commande. Asciinema est une documentation utile. Il montre aux utilisateurs comment effectuer une tâche et leur permet de copier et coller pour garantir l'exactitude.

Téléchargez votre film Asciinema 

Aucun film Asciinema n'a encore atteint le statut de blockbuster, mais vous pouvez néanmoins télécharger le vôtre sur Asciinema.org et le partager avec le monde.

$ asciinema upload mymovie.cast

Plus de ressources Linux

  • Aide-mémoire des commandes Linux
  • Aide-mémoire des commandes Linux avancées
  • Cours en ligne gratuit :Présentation technique de RHEL
  • Aide-mémoire sur le réseau Linux
  • Aide-mémoire SELinux
  • Aide-mémoire sur les commandes courantes de Linux
  • Que sont les conteneurs Linux ?
  • Nos derniers articles Linux

Si vous êtes habitué aux temps de téléchargement YouTube, vous serez agréablement surpris par la rapidité avec laquelle les films Asciinema sont transférés. Un .cast Le fichier ne fait généralement que quelques kilo-octets, ou tout au plus quelques mégaoctets, de sorte que le téléchargement est presque instantané. Vous n'avez pas besoin d'un compte pour partager votre film, mais tous les films non réclamés sont supprimés après sept jours. Pour préserver votre chef-d'œuvre, vous pouvez ouvrir un compte sur Asciinema, puis vous asseoir et attendre que l'Académie vous appelle.

Asciinema comme documentation

Asciinema est un excellent moyen de démontrer même les concepts les plus élémentaires. Parce qu'il conserve la possibilité de copier et coller le code de l'enregistrement, offre la possibilité de faire une pause et de jouer à la demande, et est complètement précis dans ce qu'il représente, ce n'est pas aussi bon qu'un enregistrement d'écran. C'est beaucoup, beaucoup mieux. Que vous l'utilisiez pour montrer vos compétences terminales à vos amis ou que vous l'utilisiez pour éduquer des collègues et des étudiants, Asciinema est un outil inestimable, social et accessible.


Linux
  1. Surveillez votre système Linux dans votre terminal avec procps-ng

  2. Alimentez votre éditeur de texte de terminal Linux avec ed

  3. Partez à l'aventure dans votre terminal Linux

  4. Partage de sessions de terminal Linux avec Tmux et Screen

  5. ttyrec - Enregistrer une session de terminal sous Linux

Enregistrer une session de bureau avec Kazam dans Ubuntu / Linux Mint

Comment enregistrer votre session de terminal sous Linux

Enregistrer des sessions de terminal à l'aide d'Asciinema sous Linux

Comment enregistrer des sessions de terminal Linux à l'aide d'Asciinema

Comment enregistrer votre écran dans Ubuntu avec SimpleScreenRecorder

tmate :partagez instantanément une session de terminal avec d'autres utilisateurs Linux