Filmer un tutoriel d'installation et de configuration logicielle

Créez des tutoriels d'installation vraiment suivables : environnement propre, prérequis, messages d'erreur, différences de plateforme et vidéos qui durent.

Filmer un tutoriel d’installation et de configuration logicielle

L’installation est la première chose qu’un nouvel utilisateur fait avec votre logiciel, et l’étape où il risque le plus d’abandonner. Un guide écrit suppose que tout se passe bien. Une vidéo, elle, montre à quoi l’écran ressemble vraiment — y compris l’avertissement de sécurité dont personne ne l’avait prévenu et la boîte de dialogue qui n’apparaît que sur une machine neuve.

Les vidéos d’installation comptent aussi parmi les contenus les plus rentables qu’une équipe support ou documentation puisse produire. Chaque nouvel utilisateur les regarde, elles évitent durablement les trois mêmes tickets, et bien filmées, elles vieillissent lentement.

Pourquoi ces vidéos ne sont pas des tutoriels comme les autres

La plupart des tutoriels montrent quelqu’un en train d’utiliser un produit. Un tutoriel d’installation en diffère sur trois points qui changent la façon de filmer :

  • Le spectateur est inquiet. Il accorde des autorisations, saisit des mots de passe, modifie son système. Le moindre écart entre son écran et votre vidéo est interprété comme « quelque chose a mal tourné ».
  • Son environnement ne ressemble pas au vôtre. Versions d’OS différentes, dépendances déjà présentes, politiques de sécurité d’entreprise, installations précédentes inachevées : tout cela modifie le parcours.
  • L’échec est normal. Une part non négligeable des spectateurs rencontrera une erreur. Si votre vidéo fait comme si les erreurs n’existaient pas, elle devient inutile précisément quand on en a le plus besoin.

Concevez l’enregistrement autour de ces trois réalités et il surpassera n’importe quel guide écrit.

Partir d’un environnement réellement vierge

Le défaut le plus courant : la machine du présentateur est déjà configurée. Les dépendances sont en cache, les identifiants enregistrés, les boîtes de dialogue d’autorisation n’apparaissent jamais — le spectateur voit un déroulé fluide qu’il ne peut pas reproduire.

Avant de lancer l’enregistrement :

  • Utilisez une machine virtuelle neuve, un nouveau compte utilisateur ou un conteneur réinitialisé
  • Supprimez les versions précédentes, les caches de paquets et les identifiants enregistrés
  • Videz les sessions du navigateur si l’installation implique une connexion ou un téléchargement depuis un portail
  • Réinitialisez les autorisations système demandées par votre application (enregistrement d’écran, micro, accès disque, pare-feu)
  • Vérifiez que la version du système correspond à celle de votre public, pas à une bêta que vous testez

C’est un environnement propre qui fait apparaître à l’écran les demandes d’autorisation et les dialogues de premier lancement — et c’est précisément là que les utilisateurs bloquent.

Annoncer les prérequis dès le début

Rien ne fait perdre plus de temps que de découvrir au bout de sept minutes qu’il fallait un compte, une clé de licence ou un mot de passe administrateur. Énoncez les exigences avant le premier clic.

Ouvrez sur une liste courte et explicite :

  • Systèmes d’exploitation et versions pris en charge
  • Espace disque et configuration matérielle requise
  • Comptes, clés de licence ou jetons d’API nécessaires
  • Accès administrateur ou sudo requis ou non
  • Durée approximative de l’opération complète

Dites l’estimation à voix haute. « Comptez environ quatre minutes, dont l’essentiel est la copie des fichiers par l’installateur » cadre mieux les attentes que n’importe quelle barre de progression.

Filmer tout le parcours, puis couper les temps morts

Enregistrez en continu, du téléchargement au premier lancement réussi. N’assemblez pas des extraits issus de sessions différentes : des états de fenêtre incohérents et un curseur qui saute se voient immédiatement et minent la confiance.

Capturez chaque étape, y compris celles qui paraissent trop évidentes :

  1. Où se trouve réellement le lien de téléchargement sur la page
  2. L’avertissement de téléchargement du navigateur, s’il y en a un
  3. L’ouverture de l’installateur, y compris l’alerte « développeur non identifié » ou SmartScreen
  4. Chaque boîte de dialogue de l’installateur, même celles que vous validez machinalement
  5. Les demandes d’autorisation système au premier lancement
  6. L’écran de configuration initiale
  7. Une première action réussie qui prouve que l’installation fonctionne

Coupez ensuite les temps morts. Les longues copies de fichiers et les barres de progression n’ont pas besoin d’être en temps réel : accélérez-les ou coupez-les, mais laissez un battement visible pour que l’on comprenne qu’une attente est normale. Réduire une installation de trois minutes à un instant fait croire aux gens que la leur est bloquée.

Montrer les erreurs volontairement

Les quatre-vingt-dix secondes les plus précieuses d’une vidéo d’installation sont celles qui traitent de ce qui se passe quand ça ne marche pas. Choisissez les deux ou trois échecs les plus fréquents dans vos tickets et filmez-les délibérément.

Candidats classiques :

  • Les avertissements de sécurité qui bloquent l’exécution de l’installateur
  • Un runtime ou une dépendance manquante
  • Un conflit de port ou un service déjà en cours d’exécution
  • Les refus d’autorisation, et où les accorder dans les réglages système
  • Un proxy ou un pare-feu d’entreprise qui bloque le téléchargement

Filmez chaque état d’échec, puis la résolution. Gardez-les sous forme de courtes vidéos séparées liées depuis le tutoriel principal, ou de chapitres clairement identifiés : ceux qui ne sont pas bloqués les sautent, les autres y accèdent directement.

Traiter macOS et Windows séparément

Résistez à l’envie de filmer une seule vidéo censée couvrir les deux plateformes. Le téléchargement, l’apparence de l’installateur, les alertes de sécurité et l’emplacement des fichiers diffèrent, et tout décalage désoriente exactement le public qui a le plus besoin d’aide.

Enregistrez deux versions parallèles avec le même script et la même structure :

  • macOS : alertes Gatekeeper, glisser-déposer vers le dossier Applications, volets de confidentialité des Réglages Système et emplacement des autorisations
  • Windows : alertes SmartScreen, élévation UAC, choix du dossier d’installation, boîtes de dialogue Defender ou pare-feu

Alignez les titres de chapitres et le minutage dans les deux versions afin qu’une équipe puisse renvoyer à « l’étape 4 » quelle que soit la plateforme.

Faire une vidéo qui ne se périme pas

Les vidéos d’installation vieillissent plus vite que les autres, car les installateurs et les dialogues système évoluent. Quelques habitudes prolongent leur durée de vie :

  • Évitez d’annoncer des numéros de version précis s’ils n’ont pas d’importance : dites « la dernière version » plutôt que « la version 3.2.1 »
  • Ne vous attardez pas sur une interface dont vous savez qu’elle va être refondue
  • Gardez l’étape de téléchargement générique : pointez vers votre page de téléchargement plutôt qu’une URL versionnée
  • Filmez en résolution standard et au zoom par défaut pour qu’un nouvel enregistrement s’harmonise visuellement
  • Notez dans votre documentation quelle version de l’app et de l’OS chaque vidéo couvre

Programmez ensuite un rappel pour revérifier la vidéo après chaque grande mise à jour système. Refilmer une installation de quatre minutes coûte peu ; une vidéo montrant une fenêtre qui n’existe plus vous coûte des tickets.

Les choix de montage qui comptent ici

Quelques décisions de montage pèsent particulièrement lourd dans ce format :

  • Zoomer sur les boîtes de dialogue. Le texte des installateurs est petit et lourd de conséquences. Zoomez sur les cases à cocher, les chemins d’installation et les demandes d’autorisation pour qu’ils se lisent d’un coup d’œil.
  • Afficher les commandes en texte. Si la configuration passe par des commandes de terminal, incrustez-les à l’écran plutôt que de seulement les dicter : les spectateurs mettent en pause et copient.
  • Mettre le curseur en évidence aux clics. Dans une succession de dialogues quasi identiques, la mise en évidence des clics montre clairement quel bouton a été pressé.
  • Ajouter des chapitres. Prérequis, téléchargement, installation, autorisations, premier lancement, dépannage. La plupart des spectateurs arrivent déjà en cours de route.
  • Terminer par une vérification. Montrez la seule chose qui prouve que ça marche : l’app qui s’ouvre, une commande qui renvoie la version, un fichier de test qui s’affiche.

Où placer ces vidéos

Un tutoriel d’installation ne rapporte que s’il est trouvé au moment voulu. Liez-le depuis la page de téléchargement, l’e-mail de bienvenue, le README, l’article d’aide sur les échecs d’installation et la réponse type que votre support envoie en cas de problème de configuration. Gardez un lien stable pour pouvoir remplacer la vidéo sans casser toutes les références.

Conclusion

Un bon tutoriel d’installation est honnête sur les aspects pénibles : les alertes de sécurité, l’attente, les erreurs. Filmez depuis une machine vierge, annoncez les prérequis d’entrée, montrez les échecs volontairement et gardez des versions distinctes pour macOS et Windows. Faites-le une fois et, pendant un an, vous répondrez aux questions de configuration par un lien plutôt que par une longue explication.

Bon enregistrement !