Was macht screen-demo?
Verwandelt eine URL in ein Demovideo. Du bist der Regisseur: Du schaust dir die Seite an, schreibst die Tour als JSON, und das Skript führt sie aus, erfasst die eigenen Frames der Seite (niemals den Desktop) und bearbeitet das Video. Scrollen, das Gleiten des Cursors und Tippen werden Frame für Frame bei 30 fps aufgezeichnet, also sind sie selbst auf einer schweren Seite flüssig; was die Seite nach einem Klick oder Laden selbst tut, stammt aus dem Live-Screencast.
Einrichtung (einmalig)
- Python 3.10+ mit Pillow und einem aktuellen Playwright:
python -m pip install -U playwright pillow, dannpython -m playwright install chromium. - ffmpeg im PATH (
winget install ffmpeg,brew install ffmpeg).
Überprüfung mit python tests/selftest.py (eine lokale Seite, kein Netzwerk, ca. eine Minute).
Arbeitsablauf
- Fragen, wofür das Video ist: die URL, die 2 bis 4 Dinge, die gezeigt werden sollen (der Hero, eine Funktion, der Preis, ein Anmeldevorgang), das Format
(
landscape16:9 für YouTube und READMEs,vertical9:16 für Shorts und Reels,square) und ob sie ein GIF möchten. Nur die eigene Seite oder App des Nutzers, oder eine öffentliche Seite, die er zeigen darf. - Die Seite ansehen:
python scripts/demo.py inspect URL WORK [--format vertical]. Lies jedesWORK/page-N.jpg(die Seite in viewport-großen Ausschnitten, jedes klickbare Element mit einer roten Nummer versehen) undWORK/elements.txt. Ein Cookie-Banner oder ein Pop-up erscheint hier: Der erste Schritt der Tour schließt es (der „Ablehnen“- oder „Schließen“-Button). WORK/tour.jsonschreiben (Format in references/tour-format.md): ein Titelbild, dann kurze Schritte. Eine gute Tour: eine Bildunterschrift, die sagt, was das Produkt tut, ein Scrollen zum ersten sehenswerten Element, ein Zoom darauf, ein Klick oder etwas Tippen, das die Funktionsweise des Produkts zeigt, eine Hervorhebung des Ergebnisses, eine Bildunterschrift pro Idee. 15 bis 40 Sekunden. Ziele sind die Nummern der Inspektion (#12), odercss=...odertext=....- Aufnehmen:
python scripts/demo.py record WORK/tour.json OUT [--gif]. Es spielt die Tour ab, gibt jeden fehlgeschlagenen Schritt aus und rendertOUT/demo.mp4(undOUT/demo.gif). OUT/keys.jpgansehen (ein Bild von jedem Schritt), bevor du es als erledigt betrachtest: ein Zoom auf die falsche Sache, eine Bildunterschrift über dem Kernpunkt des Bildes, ein fehlgeschlagener Schritt (das Element wurde verschoben oder war versteckt), ein Banner, das noch im Weg ist. Um nur die Bildunterschriften, Zooms oder das Titelbild zu ändern, bearbeiteOUT/tour.jsonund führepython scripts/demo.py render OUT [--gif]aus (keine neue Aufnahme); bei allem anderen nimm erneut auf.- Ausliefern: den Pfad von
demo.mp4(und des GIFs), seine Länge und eine Zeile pro darin gezeigter Idee.
Regeln
- Niemals mit einem Passwort anmelden, niemals ein Passwort oder eine Kartennummer eingeben (das Skript lehnt Passwort- und Zahlungsfelder ab), niemals kaufen, senden, posten oder löschen, niemals ein Formular mit persönlichen Daten einer anderen Person absenden. Eine Demo eines angemeldeten Bereichs erfordert, dass der Nutzer selbst eine Seite eines Testkontos bereitstellt.
- Cookie-Banner ablehnen (die geringsten Daten), es sei denn, der Nutzer sagt etwas anderes.
- Bildunterschriften kurz halten (3 bis 8 Wörter); eine Idee pro Bildunterschrift; die Bewegung des Videos selbst erledigt den Rest.
- Die Seite respektieren: keine Tour einer Seite, die der Nutzer möglicherweise nicht zeigen darf.
Beispiel
Nutzer: „Mach ein 20-Sekunden-Demo-Video von meiner Landingpage https://example.com für die README, zeig die Anmeldung.“
Du führst inspect aus, liest die 3 Ausschnitte, siehst ein Cookie-Banner (#2 „Alle ablehnen“), den Hero, ein „Probier es aus“-Feld (#9) und eine Preiskarte (#21); du schreibst eine Tour: ein Titelbild, klick #2, Bildunterschrift „Notizen, die sich selbst schreiben“, tippe in #9, klick #10, hebe das Ergebnis hervor, Bildunterschrift „Für immer kostenlos“, scrolle zu #21, zoom; nimm mit --gif auf, öffne keys.jpg, siehst, dass der Zoom den Preis gut eingerahmt hat, und antworte mit demo.mp4 (21 s), demo.gif (3 MB) und den vier Ideen.