Communitygithub.com

Pulupulu Motion

Inszeniert einen Motion-Film als HTML- und GSAP-Timeline, fotografiert ihn bildweise in headless Chrome und mischt Sprache und Musik mit ffmpeg.

Was ist Pulupulu Motion?

Prüft Node, ffmpeg und die pulupulu-CLI, dann flache Vektoren, Schrift, Charts und Karten. Ein echtes Gesicht, Lippensync oder eine durchgehende Körperaktion wird abgelehnt und so gesagt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Alucard0x1/pulupulu-motion/tree/HEAD

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Pulupulu Motion?

Ein Film ist hier eine Timeline in HTML, die Chrome Frame für Frame rendert. Nichts ist ein Video-Editor: Du schreibst eine Seite, das CLI erstellt Screenshots bei einer festgelegten Bildrate, ffmpeg muxiert den Ton.

Diese Datei ist der Router. Sie beantwortet: Darf ich diesen Job machen, was führe ich zuerst aus, was muss bestehen, und welche Seite enthält die Details. Lade eine Referenzseite nur für den Teil, an dem du gerade arbeitest.

1. Bevor du etwas versprichst

python scripts/doctor.py                    # Nur-Lesen: python, node, ffmpeg, das CLI, Schlüssel, Festplatte
python scripts/doctor.py --project film/    # zusätzlich: der Seitenvertrag ist vorhanden

Exit 1 bedeutet, dass auf diesem Rechner kein Film erstellt werden kann. Entdecke das nicht erst, nachdem du Szenen geschrieben hast. Rufe niemals npx pro Befehl auf: Ein Netzwerk-Roundtrip bei jedem check, still und render ist die häufigste selbstverschuldete Verlangsamung in diesem Workflow.

Dieses Werkzeug ist die falsche Wahl, wenn die Geschichte Bildmaterial benötigt, das nicht vorhanden ist, das Gesicht oder Abbild einer echten Person, artikulierte menschliche oder tierische Anatomie, eine kontinuierlich ausgeführte physische Aktion oder Lippen-Synchronisation. Es rendert flache Vektorgeometrie, Schrift, Diagramme, Karten, Symbole und farbcodierte Objekte gut und die anderen Dinge schlecht. Sage dies, anstatt einen Nachahmer zu produzieren: Eine gezeichnete Vertretung für Archivmaterial ist ein Problem der Herkunft, keine Stilwahl.

2. Der Workflow, in der Reihenfolge

Ein Beat = ein Satz = eine Einstellung. Timing kommt von gemessener Sprache, niemals von Erfindung.

  1. Briefing. Thema, Zielgruppe, Plattform, Sprache, ob es eine Erzählung gibt. Frage nach einem fehlenden Thema; frage nicht, ob erzählt werden soll, wenn ein Video angefordert wurde.
  2. Storyboard vor HTML — references/narration-and-captions.md. Die Bildunterschrift sind die wörtlich gesprochenen Wörter, keine Zusammenfassung.
  3. Erzählen und messen. python scripts/deepseek_voice.py beats beats.json film/assets/voice.wav --voice stella --timeline timeline.json, dann gate, um jeden Satz per ASR zu überprüfen. Route, Stimmen und Grenzen: references/narration/deepseek-tts.md.
  4. Erstelle die Seite aus timeline.json, nicht aus dem Storyboard. Vertrag: references/cli.md. Wenn die Geschichte Objekte benötigt, die keine Symbolbibliothek hat, generiere sie zuerst als Druck-Panels – references/generated-assets.md – und setze diese zusammen; zeichne niemals einen Ersatz für ein Foto von Hand.
  5. Überprüfen, dann ansehen. pulupulu check ., dann pulupulu still . --at 2,12,24 --out .om/stills und öffne die Standbilder. Eine Seite, die check besteht, kann dennoch leer rendern.
  6. Rendern — pulupulu render . --format mp4 --fps 30. Stillstände, schwarze Frames und falsche Längen: references/render-traps.md.
  7. Mischen und muxen mit explizitem Stream-Mapping — scripts/deliver_check.py --video out/film-vN.mp4 --audio assets/mix.wav --out out/final.mp4 muxiert und validiert in einem Aufruf. Manuelles Rezept und die Ducking-Kette: references/workflow.md.
  8. Validiere die Datei, die du ausliefern wirst, nicht die neueste Ausgabe des Renderers: python scripts/deliver_check.py out/film.mp4 --timeline timeline.json.
  9. Liefere aus mit ehrlichen Einschränkungen: was gezeichnet statt bezogen wurde, und was der QA-Vermerk sagt.

3. Tore (Gates)

Nur diese blockieren. Alles andere, was ein Werkzeug ausgibt, ist ein Lesehinweis: Beantworte es mit einem Argument oder behebe es, aber melde es niemals als bestanden, wenn es nicht bestanden wurde.

TorBefehlWas es beweistBei Fehlschlag
Preflightpython scripts/doctor.pydie Maschine kann rendernStoppe, melde, was fehlt
Kompositionpulupulu check .Seitenvertrag, keine fehlende DateiBehebe vor dem Rendern
Sprachepython scripts/lang-audit.py film/index.html --lang enKein Text in der anderen Sprache, einschließlich String-Literalen innerhalb von <script>Übersetze das Literal, führe erneut aus
Sprachepython scripts/deepseek_voice.py gate beats.json --voice stellaJeder Satz wird zurück in seine eigenen Worte transkribiertSchreibe den Satz um; versende niemals ein Fragment
Dateipython scripts/deliver_check.py out/film.mp4 --timeline timeline.json (oder --video/--audio/--out zum Muxen)Bildgröße, Bildrate, Audio vorhanden und lang genug, wahrer Peak, LiefergrößeNeu muxen oder neu encodieren
Popspulupulu qa out/film.mp4keine Einzel-Frame-PopsFinde das Ein-Frame-Element

pulupulu qa meldet auch Bewegung pro Sekunde, Standbild ≥ 1 s und flacher Anfang. Das sind Urteile über das Tempo, gemessen an einem 96×54 Graustufenvergleich, sodass eine kontrastarme, langsame Bewegung als Standbild gelesen werden kann. Nutze sie als Grund zum Nachsehen, nicht als zu befolgendes Urteil.

Was kein Tor beweist: dass der Film gut ist, dass ASR die richtige Zahl gehört hat (überprüfe Ziffern und Eigennamen als Tokens), oder dass sich eine Bildunterschrift dort befindet, wo die Benutzeroberfläche einer Plattform sie nicht abdeckt.

4. Fallen, die einen Render kosten

Vollständige Details und Korrekturen in references/render-traps.md. Diejenigen, die einen Render sofort stoppen:

  • Roh-<g>/<rect>/<path>, das in ein <div> geschrieben wird, rendert nichts und warnt nichts. Wickle jedes Szenenfragment in seinen eigenen <svg viewBox>-Container.
  • Eine Webschriftart innerhalb von Inline-SVG <text> rastert diese Ebene bei jedem Frame neu. Setze Text in HTML oder zeichne ihn als Formen.
  • feTurbulence als Frame-für-Frame-Filter – ob Inline-SVG oder CSS-Hintergrund – blockiert den Renderer. Backe das Rauschen einmal in ein PNG-Kachelbild.
  • Eine Vollbild-GSAP-Skalierung auf einem Inline-SVG rastert die Platte neu; Translationen werden gut komponiert, und eine Bitmap-Ebene kann skaliert werden. Wenn ein Push unmöglich ist, animiere kleine innere Gruppen.
  • repeat: -1 macht die Timeline unendlich: Ein 87-Sekunden-Film wird stillschweigend zu 117 Sekunden. Berechne endliche Durchläufe.
  • Töte nach einem fehlgeschlagenen Rendern nur den headless Chrome, den es hinterlassen hat. taskkill //IM chrome.exe schließt den eigenen Browser des Benutzers.

5. Wo die Details leben

Woran du arbeitestSeite
Befehle, Seitenvertrag, Installationreferences/cli.md
Die neun Schritte, Projektvertrag, Muxreferences/workflow.md
Storyboard, Bildunterschriften, Ein-Sprachen-Torreferences/narration-and-captions.md
Palette, Element-Budget, Persönlichkeit, Rhythmusreferences/design-taste.md
Bewegungssprachen, Techniken, 3D-Ebenereferences/motion-library.md
Verbesserung, Produktdemo, Sprecher, Grammatikenreferences/workflows-specialized.md
Musikwelten, Komponist, Soundeffekte, Erzählungssynthesereferences/audio-and-music.md, references/narration/deepseek-tts.md
Ein leerer, blockierter oder falsch langer Renderreferences/render-traps.md
Was zu überprüfen ist, und in welcher Reihenfolgereferences/verification.md
Stilrezepte, Kamerasprachereferences/art-motion/INDEX.md
Beschaffung von Symbolen und Vektoren, Lizenzenreferences/asset-sourcing.md
Von einem Bildmodell generierte Kunst, Zuschneiden von Drucken, Montierenreferences/generated-assets.md
Flachvektor-Handwerk, scrollende Weltenreferences/2d-vector-motion.md
Welche Themen dieser Renderer tragen kannreferences/topic-fit.md
Timing und Easing auf sub-Sekunden-Ebenereferences/ui-motion/
Veröffentlichen dieser Fähigkeit (ein Commit, v1.0)references/publishing-skills.md, references/publishing.md

Der Stilrezept-Pfad (scripts/art-motion/engine/) ist eine 20 MB große, vendorisierte Laufzeitumgebung, die bewusst nicht in diesem Repository ist: Eine Fähigkeit sollte nicht jeden Agenten zwingen, eine Engine herunterzuladen, die er vielleicht nie nutzt, und ein 37 MB großer Baum kann nicht überprüft werden. Sie installiert sich festgepinnt und prüfsummenverifiziert auf die exakten Pfade, die die obigen Seiten zitieren:

python scripts/install_art_motion.py --check                   # Ist es da?
python scripts/install_art_motion.py                           # Kern: lib + Demos + Szenen, 20 MB
python scripts/install_art_motion.py --with-reference-films    # + Studienmaterial, 14 MB mehr

Alles andere – die Python-Tore, die Clip-Spezifikationen, die Dokumentation – ist im Repository und benötigt keine Installation. Committe niemals den geholten Baum zurück: .gitignore deckt ihn bereits ab.

6. Skripte

SkriptFunktion
scripts/doctor.pyPreflight, Nur-Lesen
scripts/deepseek_voice.pyprobe · speak · cost · lay · beats · asr · gate — Erzählung und ihre gemessene Timeline
scripts/deliver_check.pyValidiert die ausgelieferte Datei: Größe, Rate, Audio, Peak, Dauer gegen die Timeline
scripts/lang-audit.pyEin-Sprachen-Tor über Markup und Skript-Literale
scripts/art-motion/icon_audit.pySymbolfamilien, Farbanzahl, Kontaktbogen
scripts/art-motion/qa.pyTempound Pop-Heuristiken auf einer gerenderten Datei
scripts/stamp_credit.pyFügt die Zeile by Alucard0x1 zu Textdateien hinzu

7. Zusammenarbeit mit einer Person

Zeige Frames, keine Adjektive. Ein Helden-Frame pro Akt tötet eine Woche falscher Arbeit. Wenn sie dich korrigieren, übertrage die Korrektur in diese Fähigkeit, nicht in eine Chat-Antwort.

Übergaben: Erzählungs-Timing und Prosodie → Skill tts-intonation · Zusammenführen oder Übersetzen einer anderen Bibliothek → Skill agent-skill-sourcing · Rechte und Abbildung vor der Veröffentlichung → Skill media-content-safety · Beschaffung eines Referenzvideos → Skill streaming-mirror-extraction · 3D- oder Footage-basierte Aufnahmen → Skills headless-three-video-render und cinetic · Typ-lastige Filme → Skill kinetic-typography.

Verwandte Skills