Communitygithub.com

Beat-Motion-Graphics

Einen 15- oder 30-Sekunden-Spot im Takt aus Code erzeugen: prozedurales Canvas, Frames über headless Chrome und eine synthetisierte Spur, ohne Stock-Assets.

Was ist Beat-Motion-Graphics?

Eine reine Code-Pipeline für Promo, Erklärstück, Launch oder Showcase in 1080p60. Das Bild ist prozedurales HTML5-Canvas, die Frames kommen headless, und der Ton wird auf den Beat synthetisiert statt importiert. Keine Stockbibliothek und kein Schnittprogramm.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Beat-gesteuerte prozedurale Bewegungsgrafiken

Produzieren Sie Studio-Kinotypografie und prozedurale Bewegungsgrafiken mit einer vierstufigen Code-Pipeline:

index.html (HTML5 Canvas Beat-gesteuerter Renderer)
    ↓  Frame-für-Frame-Erfassung (10× Verschluss-Bewegungsunschärfe)
scripts/render.py (Headless Chrome CDP → ffmpeg H.264)
    ↓
make_audio.py (Prozedurale Wellenform & EDM-Synthese auf dem gleichen Beat-Raster)
    ↓
ffmpeg mux → final.mp4 (1920×1080, 60 fps, AAC Stereo)

Alles – Bilder, Übergänge, Kamera-Wackeln, Glitch-Effekte, Drums, Akkorde und Risers – wird durch Beat-Nummern auf einem einzigen gemeinsamen Tempo-Raster gesteuert (Standard 128 BPM). Keine manuelle Timeline-Ausrichtung, keine externen Stock-Footage, keine Drittanbieter-Python-Pakete.


Arbeitsablauf

Schritt 1 — Umgebungsprüfung

Überprüfen Sie vor dem Erstellen von Dateien die lokalen Voraussetzungen:

  1. ffmpeg / ffprobe (mit libx264 und aac Encodern).
  2. Headless Chrome / Chromium-Binärdatei (Google Chrome unter macOS, chromium / google-chrome unter Linux).
  3. Verfügbare Systemschriftarten, die zum Zieltext passen (z.B. fette geometrische Sans für Latein, PingFang / Hiragino / Noto Sans für CJK, Monospace für HUD/Code).

Schritt 2 — Beat-basiertes Storyboard

Konvertieren Sie das Thema des Benutzers in ein Beat-Blatt, bevor Sie Rendering-Code schreiben.

  • Wählen Sie die Dauer: 15 s = 32 Beats oder 30 s = 64 Beats bei 128 BPM (SPB = 60 / 128 = 0,46875 s/Beat).
  • Folgen Sie dem narrativen Bogen in storyboard-prompt-template.md: Hook → Spannung / Kontrast → Konzeptbilder (Graph / Tunnel / Morph / 3D) → Schneller Aufbau + Countdown → 0,1 s Stille Blackout → Partikel-End-Höhepunkt.
  • Halten Sie den Text auf dem Bildschirm extrem prägnant: 1–3 englische Heldenwörter (200–400 px) gepaart mit maximal einer kurzen Untertitelzeile (36–70 px). Schreiben Sie niemals Absätze.

Schritt 3 — Erstellen von index.html (Visual Engine)

Erstellen Sie einen eigenständigen Single-File HTML5 Canvas Renderer (1920×1080), der Folgendes bereitstellt:

  • window.READY === true nachdem Schriftarten, Offscreen-Sprites, Morph-Formen und Partikelziele die Initialisierung abgeschlossen haben.
  • window.TOTAL (ganzzahlige Gesamt-Frame-Anzahl, z.B. 900 oder 1800).
  • window.MB (konfigurierbare Anzahl von Bewegungsunschärfe-Sub-Samples, Standard 10 für End-Render, 1 für schnelle Vorschau).
  • window.frameData(frameIndex, quality) gibt eine JPEG Data URL für diesen genauen Frame zurück.

Befolgen Sie die visuellen Primitive und die Post-Processing-Pipeline in visual-style-guide.md.

Schritt 4 — Visuelle Standbild-Inspektion (Obligatorische Hürde)

Führen Sie niemals blind einen vollständigen Render mit 900–1800 Frames durch. Erfassen Sie immer zuerst 12–16 repräsentative Keyframes und inspizieren Sie diese als Kontaktabzug:

python3 scripts/render.py --html ./index.html --stills 60,200,330,420,560,780,920,1110,1280,1450,1560,1650,1760
ffmpeg -y -loglevel error -pattern_type glob -i 'preview/f*.jpg' -vf "scale=640:360,tile=4x4" -frames:v 1 preview/sheet.jpg

Inspizieren Sie preview/sheet.jpg und überprüfen Sie:

  • Kein Text kollidiert mit dem Corner-HUD (halten Sie den Hauptinhalt innerhalb y ∈ [100, 980], x ∈ [100, 1820]).
  • Alle Schriftarten wurden korrekt geladen (kein Tofu / Fallback-Serifen-Fehler).
  • Der Kontrast ist bei hellen und dunklen Szenen lesbar; der difference-Blend des HUD bleibt lesbar.
  • Bewegungsunschärfe, Glühen und Partikel-Konvergenz sehen sauber und zentriert aus. Beheben Sie Layout-Probleme und überprüfen Sie erneut, bevor Sie den vollständigen Render starten.

Schritt 5 — Erzeugen eines prozeduralen Soundtracks (make_audio.py)

Passen Sie make_audio_template.py an die genauen BPM, BEATS, SCENE_TRANSITIONS und DROP_BEAT an, die in index.html verwendet werden. Siehe audio-synthesis-guide.md für die Syntheseregeln.

Überprüfen Sie die generierte music.wav vor dem Multiplexen:

  • Die Dauer entspricht exakt BEATS * 60 / BPM.
  • Rendern Sie ein Spektrogramm (showspectrumpic) oder eine RMS-Prüfung pro Sekunde, um saubere Dynamik, klare Beat-Struktur und die ~0,1 s Stille-Lücke vor dem Drop zu bestätigen.

Schritt 6 — Vollständiger Render & Mux

  1. Rendern Sie alle Frames mit 60 fps und MB=10 Bewegungsunschärfe:
    python3 scripts/render.py --html ./index.html --out video.mp4 --mb 10
    
  2. Multiplexen Sie Video und Audio mit Stream-Kopie für das Video:
    ffmpeg -y -loglevel error -i video.mp4 -i music.wav \
      -c:v copy -c:a aac -b:a 256k -shortest final.mp4
    
  3. Führen Sie eine abschließende ffprobe- + 6-Frame-Kontaktabzug-Prüfung von final.mp4 durch, um 1920x1080, 60 fps, h264 + aac, genaue Dauer und saubere Ausgabe zu bestätigen.

Harte Einschränkungen & Engineering-Regeln

  1. Einheitlicher Beat-Takt: Sowohl index.html als auch make_audio.py müssen die Zeit streng aus beat = t / (60 / BPM) ableiten. Verwenden Sie niemals hartcodierte magische Millisekunden-Offsets, die von der Musik abweichen können.
  2. Deterministisches Rendering: Verwenden Sie einen gesetzten PRNG (z.B. mulberry32), der auf Frame/Element-Index basiert – niemals Math.random() innerhalb der Render-Schleife – damit 10× Bewegungsunschärfe-Sub-Samples kohärent bleiben ohne chaotisches Flackern.
  3. 10× Verschluss-Bewegungsunschärfe: Mitteln Sie 10 Sub-Frames über ein 0,75-Frame-Verschlussfenster (alpha = 1 / (k + 1) Akkumulation). Weniger als 8 Samples erzeugen stufenweise Geisterbilder bei schneller Kinotypografie.
  4. Zero-Dependency Python: render.py und make_audio.py dürfen nur die Python-Standardbibliothek verwenden (os, json, subprocess, base64, math, random, wave, array), damit sie überall ohne pip install oder numpy laufen.
  5. Vorberechnen von teuren Glüheffekten: Vermeiden Sie es, ctx.shadowBlur pro Frame über 10 Bewegungsunschärfe-Pässe bei komplexem Text/Karten aufzurufen. Rendern Sie glühende Helden-Sprites vorab auf Offscreen-Canvas während init() oder verwenden Sie gestapelte Niedrig-Alpha-Striche (glowStroke).
  6. Stille vor dem Drop: Fügen Sie ca. 0,10 s vollständige visuelle Schwarzblende und vollständige Audio-Stille unmittelbar vor dem Höhepunkt-Drop-Beat ein, um die wahrgenommene Wirkung zu maximieren.
  7. Faktentreue: Wenn das Video reale Produkt-/Technologiebehauptungen präsentiert, überprüfen Sie zuerst die Fakten und lassen Sie unbestätigte Zahlen weg (wie widersprüchliche Preise oder nicht verifizierte Benchmark-Prozentsätze).

Verwandte Skills