Que fait screen-demo ?
Transforme une URL en vidéo de démonstration. Vous êtes le réalisateur : vous regardez la page, écrivez le parcours en JSON, et le script le joue, capture les images de la page (jamais le bureau) et monte la vidéo. Les défilements, le glissement du curseur et la frappe sont capturés image par image à 30 ips, donc ils sont fluides même sur une page lourde ; ce que la page fait d'elle-même après un clic ou un chargement provient du screencast en direct.
Configuration (une fois)
- Python 3.10+ avec Pillow et un Playwright récent :
python -m pip install -U playwright pillow, puispython -m playwright install chromium. - ffmpeg dans le PATH (
winget install ffmpeg,brew install ffmpeg).
Vérifiez avec python tests/selftest.py (une page locale, sans réseau, environ une minute).
Processus
- Demandez à quoi sert la vidéo : l'URL, les 2 à 4 choses à montrer (le héros, une fonctionnalité, le prix, un flux d'inscription), le format (
landscape16:9 pour YouTube et les README,vertical9:16 pour les Shorts et Reels,square), et s'ils veulent un GIF. Uniquement leur propre site ou application, ou une page publique qu'ils sont autorisés à montrer. - Regardez la page :
python scripts/demo.py inspect URL REPERTOIRE [--format vertical]. Lisez chaqueREPERTOIRE/page-N.jpg(la page en tranches de la taille de la fenêtre, chaque élément cliquable encadré avec un numéro rouge) etREPERTOIRE/elements.txt. Une bannière de cookies ou une popup apparaît ici : la première étape du parcours la ferme (le bouton « Refuser » ou « Fermer »). - Écrivez
REPERTOIRE/tour.json(format dans references/tour-format.md) : une carte de titre, puis de courtes étapes. Un bon parcours : une légende qui dit ce que fait le produit, un défilement jusqu'à la première chose qui vaut le coup d'être vue, un zoom dessus, un clic ou de la frappe qui montre le produit en action, une surbrillance sur le résultat, une légende par idée. 15 à 40 secondes. Les cibles sont les numéros de l'inspection (#12), oucss=...outext=.... - Enregistrez :
python scripts/demo.py record REPERTOIRE/tour.json SORTIE [--gif]. Il joue le parcours, affiche chaque étape qui a échoué, et produitSORTIE/demo.mp4(etSORTIE/demo.gif). - Regardez
SORTIE/keys.jpg(une image de chaque étape) avant de déclarer terminé : un zoom au mauvais endroit, une légende qui recouvre le point de l'image, une étape qui a échoué (l'élément a bougé ou était masqué), une bannière encore gênante. Pour ne changer que les légendes, les zooms ou la carte de titre, éditezSORTIE/tour.jsonet lancezpython scripts/demo.py render SORTIE [--gif](pas de nouvel enregistrement) ; sinon, enregistrez à nouveau. - Livrez : le chemin de
demo.mp4(et du GIF), sa durée, et une ligne par idée qu'il montre.
Règles
- Ne jamais se connecter avec un mot de passe, ne jamais taper un mot de passe ou un numéro de carte (le script refuse les champs de mot de passe et de paiement), ne jamais acheter, envoyer, publier ou supprimer quoi que ce soit, ne jamais soumettre un formulaire avec les données personnelles de quelqu'un. Une démonstration d'une zone connectée nécessite que l'utilisateur fournisse lui-même une page de compte de test.
- Refusez les bannières de cookies (le moins de données) sauf si l'utilisateur dit le contraire.
- Gardez les légendes courtes (3 à 8 mots) ; une idée par légende ; le mouvement de la vidéo fait le reste.
- Respectez le site : pas de parcours d'une page que l'utilisateur n'est pas autorisé à montrer.
Exemple
Utilisateur : « fais une démo de 20 secondes de ma landing page https://example.com pour le README, montre l'inscription »
Vous lancez inspect, lisez les 3 tranches, voyez une bannière de cookies (#2 « Refuser tout »), le héros, un champ « Essayez-le » (#9) et une carte de tarification (#21) ; vous écrivez un parcours : une carte de titre, cliquez #2, légende « Des notes qui s'écrivent toutes seules », tapez dans #9, cliquez #10, surbrillance du résultat, légende « Gratuit pour toujours », défilez jusqu'à #21, zoom ; enregistrez avec --gif, ouvrez keys.jpg, voyez que le zoom a bien cadré le prix, et répondez avec demo.mp4 (21 s), demo.gif (3 Mo) et les quatre idées.