asciinema est un petit utilitaire disponible pour Linux et Mac, qui permet d’enregistrer le terminal de manière légère (format texte) contrairement à la vidéo.
Une fois l’enregistrement terminé vous avez la possibilité de l’envoyer sur leurs serveurs en créant un compte gratuit ou bien de façon anonyme.
A partir de là il est possible de le partager via lien ou sur n’importe quel site en incluant un petit snippet de code.
Installation
La documentation est disponible ici : https://asciinema.org/docs/how-it-works
Pour installer asciinema sur Ubuntu, voici la procédure
sudo apt-add-repository ppa:zanchey/asciinema
sudo apt-get update
sudo apt-get install asciinema
Enregistrement
Pour lancer l’enregistrement, il suffit d’utiliser la commande asciinema rec
, et de quitter une fois terminé avec la commande exit
ou avec le raccourci Ctrl-D
.
Par défaut le fichier sera enregistré dans le dossier /tmp/
au format .cast.
Le fichier peut être ouvert avec un éditeur de texte pour les curieux qui veulent voir comment est stocké la session.
Visionnage
Pour visionner la séquence dans le terminal, il faut utiliser la commande play
asciinema play /tmp/ma-session.cast
Upload
L’envoie de l’enregistrement permet d’inclure une “visionneuse” dans n’importe quel site web.
Il n’est pas nécessaire de se créer un compte, mais si vous souhaitez répertorier tous vos enregistrements c’est plus pratique.
La commande asciinema auth
va permettre de s’authentifier pour les prochains upload.
asciinema upload /tmp/ma-session.cast
Partage
Inclure l’enregistrement sur votre site est très simple, cela se fait via l’inclusion d’un script JavaScript dans votre page, avec éventuellement quelques options supplémentaires (autoplay, loop, size, etc.)
<script src="https://asciinema.org/a/clef-de-mon-enregistrement.js" id="asciicast-clef-de-mon-enregistrement" async data-cols="110" data-rows="30" data-t="7"></script>