Enregistrer des démos terminal et CLI que l’on peut vraiment suivre

Les démos en terminal comptent parmi les vidéos les plus utiles qu’un développeur puisse produire. Elles comptent aussi parmi les plus pénibles à regarder. Police à chasse fixe minuscule, mur de sortie qui défile, commande qui disparaît en haut de l’écran avant que quiconque ait pu la lire — et le spectateur abandonne au bout de deux minutes.

La solution tient presque entièrement à la préparation. Un enregistrement de terminal réussi se construit avant d’appuyer sur Enregistrer, pas en réparation après coup. Voici la méthode complète.

Pourquoi les enregistrements de terminal sont difficiles à suivre

Une capture d’interface graphique offre des repères visuels : boutons, icônes, mise en page. Un terminal n’en a aucun. Tout est de la même taille, de la même couleur, et tout défile vite. Les problèmes sont toujours les mêmes :

• Texte trop petit : une taille confortable à bout de bras devient illisible dans une vidéo 1080p lue dans une petite fenêtre
• Thèmes peu contrastés : du gris terne sur un fond presque noir est élégant sur votre écran et disparaît après la compression vidéo
• Sortie qui défile : la ligne intéressante file pendant que vous commentez encore la commande
• Saisie invisible : le spectateur ne voit pas vos touches, une option tapée vite ressemble à de la magie
• Temps morts : installations, builds et suites de tests produisent trente secondes où rien ne se passe

Chacun de ces points se corrige en moins de cinq minutes.

Préparer le terminal avant d’enregistrer

Traitez votre terminal de démo comme un environnement distinct de votre terminal de travail. La plupart des applications de terminal gèrent les profils : créez-en un nommé « Recording » et configurez-le une bonne fois.

• Police de 18 à 24 pt : environ le double de votre taille habituelle. Si cela paraît absurde sur votre écran, c’est sans doute la bonne taille pour la vidéo
• Thème très contrasté : texte clair sur fond sombre uni. Bannissez transparence et images de fond : elles se compressent mal et ajoutent du bruit visuel
• Une fenêtre, pas le plein écran : un terminal plein écran surdimensionné réduit le texte par rapport au cadre. Une fenêtre de 90 à 100 colonnes remplit joliment un cadre 16:9
• Désactiver les ligatures si elles gênent : les glyphes fléchés pour -> et != déroutent ceux qui recopient vos commandes
• Augmenter légèrement l’interligne : un peu d’air rend une sortie dense beaucoup plus lisible

Faire le ménage dans votre shell

Votre prompt et votre historique en disent plus que vous ne le pensez. Avant d’enregistrer :

• Simplifiez le prompt : branche Git, version de Node, horodatage et chemin sur deux lignes mangent la largeur et distraient. Un simple ~/project $ est idéal
• Masquez nom d’utilisateur et nom d’hôte : ils vous identifient, vous et votre machine, dans une vidéo que vous publierez peut-être
• Videz le tampon de défilement et l’historique : les commandes précédentes peuvent révéler des noms de clients, des hôtes internes ou des travaux sans rapport
• Vérifiez vos variables d’environnement : une sortie env en vidéo a fait fuiter plus de clés d’API que n’importe quel extrait de code
• Utilisez un répertoire jetable : un dossier de projet propre évite les fichiers parasites dans la sortie de ls
• Coupez les notifications : cloche du terminal et pop-ups de bureau ruinent une prise

Si votre démo touche à de vrais identifiants, utilisez des valeurs factices. Masquer en post-production demande bien plus de travail que de définir API_KEY=demo-key-1234 en amont.

Planifier la séquence de commandes

Écrivez vos commandes avant d’enregistrer — dans un fichier de notes, pas de mémoire. Un court script de ce que vous allez taper, dans l’ordre, fait trois choses : il évite les fautes de frappe sous pression, il garde la démo en ligne droite, et il devient le plan de votre narration.

Faites ensuite un passage complet sans enregistrer. C’est là que surgissent les surprises : un cache déjà chaud, une dépendance à installer, une confirmation que vous aviez oubliée. Réinitialisez le répertoire ensuite, pour que la prise enregistrée parte du même état.

Réglages d’enregistrement pour le terminal

Le contenu d’un terminal est essentiellement du texte statique : indulgent sur certains points, exigeant sur d’autres.

• Capturez la fenêtre, pas tout l’écran : la capture de fenêtre serre le cadre sur le terminal et masque le reste du bureau
• 30 ips suffisent : le texte n’a pas besoin de 60 ips. Une fréquence plus basse donne aussi un texte plus net à débit égal
• Enregistrez à la résolution native de l’écran : agrandir le texte après coup, c’est l’origine du flou
• Pas de webcam, ou alors petite : dans une démo terminal, la sortie est le sujet. Une grande incrustation couvre le coin inférieur, précisément là où apparaît le nouveau texte

Le rythme : ce que presque tout le monde rate

Le rythme d’une bonne démo terminal n’est pas celui de votre travail réel.

1. Annoncez ce que vous allez faire avant de taper : « Je vais maintenant installer la CLI en global »
2. Tapez à un rythme régulier et posé — plus lentement que d’habitude, sans exagérer
3. Marquez un temps avant d’appuyer sur Entrée, pour que la commande complète soit visible et lisible
4. Taisez-vous pendant que la sortie s’affiche, puis commentez-la
5. Désignez ce qui compte au lieu de lire toute la sortie à voix haute

Pour les commandes longues, tapez-les en deux temps visibles — la commande de base, puis les options — en expliquant chaque option au passage. C’est bien plus facile à suivre qu’une ligne de quarante caractères surgie d’un coup.

Gérer les commandes longues

Personne n’a envie de regarder un npm install de quatre-vingt-dix secondes. Trois bonnes options :

• Accélération progressive : gardez la commande à l’écran et passez l’attente en 4x à 10x, pour montrer que ça a eu lieu sans l’imposer
• Coupez l’attente : coupez du lancement de la commande jusqu’à juste avant le résultat. Coupez sur une ligne de prompt, le raccord devient invisible
• Préchauffez le cache : lancez la commande une fois avant l’enregistrement, elle se terminera naturellement en quelques secondes pendant la prise

Quel que soit le choix, dites à voix haute la durée réelle — « cela prend généralement deux minutes » — pour que personne ne soit surpris en le refaisant.

Rendre la sortie lisible au montage

C’est au montage qu’un enregistrement correct devient un bon enregistrement.

• Zoomez sur la sortie importante : un zoom sur les trois lignes qui comptent est infiniment plus efficace que de demander au spectateur de plisser les yeux devant un écran de logs
• Ajoutez des incrustations de texte pour les commandes clés : afficher la commande en légende donne quelque chose à lire pendant votre narration
• Annotez les messages d’erreur : quand vous montrez volontairement un échec, surlignez la ligne qui l’explique
• Ajoutez des chapitres : Installation, Configuration, Premier lancement, Dépannage — une démo terminal se suit en pratiquant, et on y revient en arrière
• Supprimez les silences : la suppression automatique des silences resserre les blancs autour des commandes sans toucher à votre débit

Mélanger le terminal et d’autres fenêtres

Peu de démos réelles se limitent au terminal. Vous lancez une commande, vérifiez dans le navigateur, éditez un fichier de configuration.

• Fixez la disposition avant d’enregistrer : terminal et navigateur côte à côte, ou bascule en plein écran — choisissez et tenez-vous-y
• Si vous changez de fenêtre, marquez une pause : laissez une demi-seconde au spectateur pour enregistrer le changement avant de reprendre
• Gardez des tailles de police cohérentes : une grande police de terminal à côté d’une petite police d’éditeur rend l’éditeur illisible
• Pensez à la capture de zone : avec une disposition figée à deux fenêtres, capturer cette région stabilise le cadrage sur toute la vidéo

Check-list avant enregistrement

[ ] Profil d'enregistrement actif : grande police, thème contrasté, aucune transparence
[ ] Prompt simplifié, nom d'utilisateur et nom d'hôte masqués
[ ] Tampon de défilement et historique vidés
[ ] Secrets remplacés par des valeurs factices
[ ] Séquence de commandes écrite et répétée une fois
[ ] Répertoire de travail remis à zéro
[ ] Notifications et cloche du terminal désactivées
[ ] Capture de fenêtre sélectionnée, 30 ips, résolution native
[ ] Test de dix secondes vérifié pour la lisibilité

Le dernier point est le plus important. Enregistrez dix secondes, relisez-les à la taille où votre public regardera réellement, et demandez-vous si le texte se lit sans effort. Sinon, augmentez la police et recommencez avant de vous lancer dans une prise de douze minutes.

Erreurs fréquentes

• Enregistrer en plein écran sur un affichage 4K : le texte devient microscopique dans la vidéo exportée
• Effacer l’écran sans arrêt : le spectateur perd le contexte de ce qui vient de se passer
• Redimensionner le terminal en cours d’enregistrement : le texte se réagence et l’effet est brutal
• Lire la sortie mot à mot : résumez plutôt — « les douze tests passent »
• Laisser le curseur clignoter sur une image figée : coupez ces fins de plan, elles donnent l’impression que la vidéo est bloquée
• Supposer que vos alias sont connus : si vous tapez gs, précisez que c’est git status

Conclusion

Une démo terminal se joue sur la lisibilité. Grande police, thème contrasté, prompt épuré, séquence répétée, et un temps d’arrêt avant chaque Entrée. Ensuite, les effets de zoom et l’accélération au montage maintiennent l’attention là où la sortie compte. À ce prix, vos explications en ligne de commande cessent d’être quelque chose que l’on subit pour devenir quelque chose que l’on refait, terminal ouvert à côté.