Cet outil Linux facilite l'enregistrement des terminaux

Vous cherchez un moyen rapide d'enregistrer votre terminal Linux sans passer par les tracas d'utiliser des enregistreurs d'écran à part entière? Asciinema est ce que vous recherchez, et je vais vous montrer comment commencer avec.

Qu'est-ce que l'asciinema?

Asciinema est un outil de ligne de commande pour enregistrer votre terminal. Contrairement aux enregistreurs d'écran traditionnels, qui ont besoin d'une configuration initiale pour enregistrer l'écran de votre appareil, Asciinema le fait différemment. Il enregistre votre session terminale dans un format spécial. Vous pouvez rejouer l'enregistrement directement sur le terminal et le partager avec d'autres.

Quelque chose qui me semblait assez intéressant, c'est que l'enregistrement que vous enregistrez n'est pas une vidéo. Au lieu de cela, lorsque vous le jouez, Asciinema reproduit ce que vous avez fait sur le terminal avec du texte. Ainsi, par exemple, si vous exécutez un ensemble spécifique de commandes, ces commandes seront tapées et exécutées automatiquement dans le terminal, reproduisant vos actions.

Cependant, ce n'est qu'une réplication visuelle. Ces commandes ne seront plus exécutées sur le système. Il vous apparaîtra simplement que ces commandes sont exécutées.

Une autre chose importante à savoir est qu'Asciinema ne produit aucun fichier vidéo. L'intérêt de l'asciinema est d'éviter les fichiers vidéo lourds. Au lieu de cela, il produit des fichiers asciicast se terminant par une extension .cast. Si vous avez vraiment besoin d'une vidéo, vous pouvez soit utiliser un enregistreur d'écran traditionnel comme SimplScreenRecorder ou convertir le fichier .cast en un format GIF ou vidéo.

Installation de l'asciinema sur Linux

La façon la plus simple d'installer Asciinema sur Linux consiste à utiliser le gestionnaire de package Python Pipx. C'est également la manière recommandée car elle installera toujours la dernière version publiée. Pour cette méthode, vous devrez d'abord installer PIPX sur votre système Linux. Après cela, exécutez simplement cette commande:

pipx install asciinema

Une fois installé, essayez de vérifier sa version pour confirmer l'installation.

asciinema --version

Si vous ne souhaitez pas installer PIPX, vous pouvez également utiliser d'autres gestionnaires de packages. Par exemple, sur Debian, Ubuntu et leurs distros dérivés, courez:

sudo apt install asciinema

Vous pouvez également utiliser le PPA entretenu par David Adam pour Ubuntu.

        sudo apt-add-repository ppa:zanchey/asciinema
sudo apt update
sudo apt install asciinema
    

Sur Arch et Manjaro, vous devez courir:

sudo pacman -S asciinema

Sur Fedora, utilisation:

sudo dnf install asciinema

Si vous utilisez Gentoo, courez:

sudo emerge -av asciinema

Pour les utilisateurs OpenSuse, la commande est:

sudo zypper install asciinema

Si vous préférez créer des logiciels à partir de Source, vous pouvez également le faire. Tout ce que vous avez à faire est de cloner le référentiel GitHub et d'exécuter Asciinema à partir de là.

        git clone https:
cd asciinema
git checkout main
python3 -m asciinema 
    

Enregistrement d'une session terminale de base à l'aide d'Asciinema

Pour enregistrer une session terminale rapide à l'aide d'Asciinema, exécutez:

asciinema rec test.cast

Nous avons utilisé la commande REC avec le nom du fichier d'enregistrement dans lequel la session sera enregistrée. Cela commencera l'enregistrement. Ainsi, après avoir exécuté la commande ci-dessus, commencez à faire quoi que ce soit sur le terminal pour qu'il soit enregistré. Une fois que vous avez terminé l'enregistrement, vous pouvez soit appuyer sur Ctrl + D ou taper Exit et appuyer sur Entrée pour terminer l'enregistrement.

Après avoir terminé l'enregistrement, vous trouverez Test.cast ou n'importe quel nom de fichier que vous avez utilisé dans le répertoire actuel.

Une fois que vous avez terminé l'enregistrement, vous pouvez le jouer sur votre terminal à l'aide d'Asciinema. Courir:

asciinema play test.cast

Comme vous pouvez le voir, les commandes que vous avez exécutées pendant l'enregistrement seront visuellement redimensionnées sur le terminal. Pendant que la rediffusion est en cours d'exécution, vous pouvez faire une pause et reprendre l'enregistrement à l'aide de l'espace. Vous pouvez également contrôler la vitesse de lecture à l'aide de l'option –Peed ou -s. Pour jouer le casting en deux fois la vitesse, courez:

asciinema play -s 2 test.cast

Si vous souhaitez arrêter la lecture, appuyez sur Ctrl + C sur votre clavier. Une chose qui me tenait à moi sur Asciinema, c'est que vous pouvez également réduire le temps de ralenti de l'enregistrement. Vous pouvez le faire en jouant le casting ou avant de l'enregistrer. Cela rend l'enregistrement beaucoup plus agréable à regarder. Pour ce faire, nous passons l'option –idle-time-limit ou -i.

asciinema rec -i 2 demo.cast # For recording
asciinema play -i 2 demo.cast # For playing the recording

Une autre option que vous avez est de partager votre casting via Asciinema. La commande de téléchargement dans Asciinema vous permet de le partager avec d'autres via le serveur asciinema.org.

asciinema upload demo.cast

Une fois que vous avez exécuté cette commande, vous obtiendrez un lien secret dans le terminal. Vous pouvez copier et coller le lien dans un navigateur Web pour afficher votre enregistrement terminal. Notez que vous aurez besoin d'un compte avec eux pour afficher la session. Vous devrez également lier votre compte avec l'outil Asciinema CLI pour préserver vos enregistrements sur le serveur. Sinon, ils seront automatiquement supprimés après 7 jours.

Exploration des fonctionnalités avancées

Nous avons vu les commandes de base que vous pouvez utiliser avec Asciinema. Il y a beaucoup plus que vous pouvez en faire. Plongeons un peu plus profondément dans les commandes que vous avez déjà vues.

Pour enregistrer une session, vous pouvez choisir une commande que vous souhaitez enregistrer au lieu de tout le terminal. Par exemple, disons que vous souhaitez enregistrer la commande htop. Pour cela, vous devez utiliser l'option – Command ou -C, comme ceci:

asciinema rec -c htop test.cast

Il commencera à enregistrer l'interface de commande HTOP au lieu de l'ensemble du shell. Pour terminer l'enregistrement, vous devez quitter HTOP en appuyant sur Q. Lors de l'enregistrement, vous pouvez faire une pause et reprendre l'enregistrement, tout comme vous le pouvez lors de l'enregistrement dans un vrai appareil photo. Pour cela, utilisez Ctrl + . Ceci est utile lorsque vous avez quelque chose de confidentiel sur le terminal que vous souhaitez sauter.

En plus de jouer une session, vous pouvez également vider toute la sortie de la session sur le terminal. Pour cela, vous avez l'option CAT. Ainsi, à partir de l'exemple précédent, lempons test.cast.

asciinema cat test.cast

Vous pouvez également enregistrer la séquence de commande dans un fichier de sortie.

asciinema cat existing.cast >output.txt # Or run
asciinema rec --raw output.txt

Vous pouvez également vider plusieurs enregistrements ensemble en utilisant une seule commande.

asciinema cat first.cast second.cast third.cast

Asciinema prend également en charge un système d'authentification. Si vous avez un compte sur asciinema.org, vous pouvez le lier avec votre CLI à l'aide de la commande AUTH.

asciinema auth

On vous donne un lien. Lorsque vous le visitez, vous êtes emmené sur un portail de connexion. Une fois que vous vous connectez avec succès, il authentifiera votre système local à l'aide de ce compte. Après cela, vous pouvez préserver tous vos enregistrements sur le serveur.

Asciinema a un fichier de configuration que vous pouvez utiliser pour modifier certains paramètres. Les raccourcis clavier sont l'un d'eux. Créez un fichier de configuration dans le répertoire $ home / .config / asciinema / config. Il y a beaucoup d'options à explorer. Voici un exemple de fichier que vous pouvez suivre:

        (api)
url = https:
(record)
command = /bin/bash -l
stdin = yes
env = SHELL,TERM,USER
idle_time_limit = 2
yes = true
quiet = true
pause_key = C-p
add_marker_key = C-x
prefix_key = C-a
(play)
speed = 2
idle_time_limit = 1
pause_key = p
step_key = s
next_marker_key = m
(notifications)
enabled = no
command = tmux display-message "$TEXT"
    

Vous pouvez également définir des variables d'environnement liées à l'asciinema. La variable ASCIINEMA_API_URL définit l'URL pour le serveur Asciinema. Par défaut, il est défini sur https://asciinema.org. Si vous hébergez votre serveur, vous pouvez définir l'URL de base sur votre propre serveur.

Une autre variable utile est asciinema_config_home. Celui-ci définit le chemin d'accès du fichier de configuration. La valeur par défaut est $ home / .config / asciinema. Cependant, si vous avez le jeu XDG_CONFIG_HOME, la valeur par défaut est $ xdg_config_home / asciinema.

Vous pouvez également intégrer des enregistrements Asciinema sur votre site Web. Une fois que vous avez téléchargé un casting sur le serveur Asciinema, vous pouvez l'intégrer sur le site Web à l'aide du javascript

La source est disponible sur le serveur où vous avez téléchargé l'enregistrement. Cliquez simplement sur le bouton « Partage » et copiez la ligne Embed JavaScript.

Quelques façons amusantes d'utiliser l'asciinema

Si vous allez sur la page Explorer sur le site officiel, vous verrez comment différentes personnes utilisent de manière créative Asciinema pour enregistrer des trucs amusants. Par exemple, il y a un exemple de Star Wars dans la documentation. Vous pouvez utiliser d'autres commandes Linux amusantes avec. Par exemple, pour rendre la session un peu plus colorée, vous pouvez utiliser lolcat. Vous pouvez faire de l'art ASCII et l'enregistrer. Le ciel est la limite lorsqu'il s'agit d'utiliser l'asciinema.

---

Il y a beaucoup plus à explorer sur l'asciinema. Si vous souhaitez voir ce que vous pouvez faire d'autre, consultez la documentation officielle. De plus, si vous recherchez un outil d'enregistrement d'écran, il existe de nombreux outils de script Linux disponibles.