asciinema ENREGISTREZ LE TERMINAL ET JOUEZ LES REPLAYS ! (BONUS Export en GIF)

SYNTHÈSE STRUCTURÉE

Installation et disponibilité

L’outil s’installe via le gestionnaire de paquets de la distribution (sudo dnf install asciinema sur Fedora/RHEL, sudo apt install asciinema sur Debian/Ubuntu). Il pèse environ 7 Mo une fois installé. Si le paquet n’est pas disponible, une installation via pip install asciinema est possible, car l’outil est écrit en Python. Adrien précise : « Autant vous dire c’est très très léger », ce qui en fait un outil idéal pour les démonstrations sans infrastructure lourde.

Enregistrement d’une session

La commande asciinema rec demo.cast démarre un enregistrement dans un fichier .cast. La session se termine par exit ou Ctrl+D. L’enregistrement capture toutes les interactions clavier, les sorties et même les délais entre les commandes. Adrien illustre : « Au moment où je valide, on voit que la session est démarrée ». Le fichier résultant est très léger (moins de 50 Ko pour deux sessions).

Enregistrement d’une commande unique

L’option -t (ou --title) permet d’enregistrer une seule commande et de terminer automatiquement l’enregistrement quand celle-ci se termine. Par exemple : asciinema rec -t "Nmon demo" demo_cmd.cast nmon. Adrien explique : « Dès que la commande se termine, on voit que en arrière-plan, la session s’est terminée ». Cela évite de devoir quitter manuellement l’enregistrement.

Rejeu d’un enregistrement

La commande asciinema play demo.cast rejoue l’enregistrement à la même vitesse que la session originale. Le rejeu reproduit fidèlement les délais, les tabulations et même les sons du terminal (comme la « goutte d’eau de GNOME »). Adrien insiste : « Au terminal, l’enregistrement se poursuit et je ne tape strictement rien », ce qui montre la fiabilité du rejeu.

Accélération du rejeu

L’option -s (ou --speed) permet de jouer l’enregistrement plus rapidement. Par exemple, asciinema play -s 3.0 demo.cast joue la session trois fois plus vite. Adrien note : « Vous le voyez ici avec l’horloge, ça va trois fois plus vite que ce que j’ai fait ». Cela est utile pour des démonstrations longues ou pour éviter les temps morts.

Export en GIF animé

L’outil agg (Asciinema GIF Generator) permet de convertir un fichier .cast en GIF. Il faut le télécharger depuis GitHub (version agg-x86_64-unknown-linux-gnu pour Linux 64 bits), le placer dans /usr/local/bin et le rendre exécutable avec chmod +x /usr/local/bin/agg. La commande agg demo.cast demo.gif produit un GIF animé. Adrien précise : « Le GIF se joue en boucle automatiquement » et pèse environ 500 Ko, ce qui est « franchement pas très gros pour intégrer ça dans une présentation ».

Accélération de l’export GIF

Comme pour le rejeu, l’option -s fonctionne avec agg : agg -s 3.0 demo.cast demo.gif produit un GIF trois fois plus rapide. Cela permet de condenser une démonstration longue en une animation courte et percutante.

Avantages des fichiers `.cast`

Les fichiers .cast sont en texte, ce qui les rend extrêmement légers (quelques dizaines de Ko) et faciles à versionner ou à partager. Contrairement à une vidéo classique, ils ne nécessitent pas de codec et peuvent être lus uniquement avec asciinema. Adrien souligne : « Les enregistrements ne se font pas dans un fichier vidéo, mais dans un fichier un peu texte », ce qui explique leur légèreté.

Cas d’usage pédagogique

Adrien utilise Asciinema pour préparer des démos de commandes ou de services sans avoir besoin de l’infrastructure réelle. Il explique : « Ça m’évite d’avoir l’infrastructure avec moi ou les services que je veux illustrer ». L’outil est particulièrement adapté aux formations, aux présentations et aux documentations techniques.

CONCEPTS CLÉS

Asciinema : Outil d’enregistrement et de rejeu de sessions terminal, produisant des fichiers .cast en texte.
AGG (Asciinema GIF Generator) : Utilitaire externe pour convertir un fichier .cast en GIF animé.
Fichier .cast : Format texte contenant les timestamps et les sorties d’une session terminal, très léger et facile à partager.
Option -s (speed) : Paramètre permettant d’accélérer le rejeu ou l’export GIF (ex. -s 3.0 pour une vitesse triple).

CONCLUSION

Asciinema est un outil puissant et léger pour enregistrer, rejouer et partager des sessions terminal. Son format texte le rend idéal pour les formations, les démonstrations et les documentations techniques, tandis que l’export GIF permet une intégration facile dans des présentations ou des sites web. Adrien résume bien l’intérêt : « C’est super léger » et « très pratique dans le cadre des formations ». Pour tout administrateur système souhaitant illustrer des procédures sans alourdir ses supports, Asciinema est un choix judicieux.