Video-Engine (Hyperframes v0.8.77 & Brag)
HyperFrames rendert Videos aus HTML – eine Komposition ist ein HTML-Dokument, dessen DOM mit data-*-Attributen (data-start, data-duration) das Timing deklariert, dessen Animationslaufzeit durchsuchbar ist und dessen Medienwiedergabe vom Framework gesteuert wird.
1. Projekterkennung
Bevor Maßnahmen ergriffen werden, ist der Projektstatus in folgender Reihenfolge zu bewerten:
| Status | Aktion |
|---|---|
| Remotion zu HyperFrames portieren | Lese workflows/remotion-to-hyperframes/SKILL.md und führe direkt aus. Überspringe die Intent-Ebene. |
| Inspizieren, Diagnostizieren, Vorschau oder Rendern | Führe den entsprechenden CLI-Befehl aus (npx hyperframes check, preview, render). Keine erneute Aufnahme durchführen. |
| Existierendes Projekt bearbeiten | Führe npx hyperframes timeline [--json] aus, um Tracks, Clips und Timing zu inspizieren; führe gezielte Bearbeitung durch. |
BRIEF.md existiert | Lese workflow und flow aus dem Brief; führe diesen Workflow sofort aus. |
hyperframes.json oder STORYBOARD.md existieren | Setze mit vorhandenen Projektdateien und gespeicherten Präferenzen fort. |
| Neue Erstellungsanfrage | Führe Intent-Aufnahme durch und leite anhand der Routing-Matrix weiter (siehe unten). |
CLI-Versionsverwaltung
Bei der Wiederaufnahme eines bestehenden Projekts mit festgelegten Abhängigkeiten in package.json:
npx hyperframes@latest upgrade --project . --check
Wenn ein Update verfügbar und verifiziert ist, wende es mit npx hyperframes@latest upgrade --project . an und führe npx hyperframes check aus.
2. Intent-Routing-Matrix
Leite neue Erstellungsanfragen an den ersten passenden Workflow weiter:
| Priorität | Anfragetyp | Ziel-Workflow |
|---|---|---|
| 1 | Expliziter Port von Remotion-Code | workflows/remotion-to-hyperframes |
| 2 | Präsentation, Pitch-Deck oder interaktive Diashow | workflows/slideshow |
| 3 | Einfache wort-synchrone Untertitel auf Filmmaterial | workflows/embedded-captions |
| 4 | Grafische Overlays bei Talking-Head, Interview oder Podcast | workflows/talking-head-recut |
| 5 | Beat-synchrone Motion durch Musiktrack (keine Sprache) | workflows/music-to-video |
| 6 | Kurze, bewegungsorientierte kinetische Visualisierung (<10s) | workflows/motion-graphics |
| 7 | GitHub Pull Request oder Code-Änderungserklärung | workflows/pr-to-video |
| 8 | Produkteinführung, Website-Showcase, SaaS-Promo, /brag | workflows/product-launch-video (oder Modus 1) |
| 9 | Konzeptionelles Thema oder Dokumentationserklärung | workflows/faceless-explainer |
| 10 | Jedes andere benutzerdefinierte Video oder Multi-Track-Komposition | workflows/general-video |
3. Betriebsmodi
Modus 1: Produkteinführung & Showcase (/brag & product-launch-video)
Verwendet für Website-Launches, Produkt-Showcases, SaaS-Promos und /brag.
- Aufnahme & Inspektion:
- Optionen parsen:
--tone(default, polished, yc-parody, chaotic, cinematic, deadpan, app-store inreferences/brag/tones.md),--format(16:9, 9:16, 1:1),--duration(15–25s). - Bei Angabe einer URL die Live-Site-Assets erfassen:
npx hyperframes capture "<URL>" -o ./capture --json
- Optionen parsen:
- Designsystem & Voreinstellungen:
- Design-Preset aus
references/creative/frame-presets/auswählen (capsule, cobalt-grid, daisy-days, etc.) und Marken-Tokens remixen:node workflows/product-launch-video/scripts/build-frame.mjs --preset <preset-name> --hyperframes .
- Design-Preset aus
- Storyboard & Audio-Mix:
STORYBOARD.mdundSCRIPT.mdschreiben.- Audio: Musikbett aus
assets/music/auswählen oder/media-useverwenden, um Tracks und TTS-Voiceover aufzulösen (references/audio/). - Beat-Cue-Analyse durchführen:
python3 scripts/analyze_music_cues.py --audio <path> --output audio_cues.json.
- Validierung & Ausgabe:
- Layout und Timing überprüfen:
npx hyperframes check. - Finales Video kompilieren:
npx hyperframes render --output brag.mp4. - Poster Frame 0 als
brag.jpgspeichern und Freigabetext inshare-copy.txtablegen.
- Layout und Timing überprüfen:
Modus 2: Narrative & Technische Erklärfilme (faceless-explainer, pr-to-video)
Verwendet, um Code-Diffs, technische Dokumentationen oder komplexe Themen in klare Video-Erzählungen zu verwandeln.
- Erzählstrang: Befolge
references/creative/references/story-spine.md(Aufhänger, Problemstellung, Architektur/Lösung, Auswirkung). - Einstellungsformen: Wähle Blaupausen aus
references/animation/blueprints-index.md(code-editor, split-comparison, stat-callout, flow-diagram). - Frame-Worker-Pakete: Erstelle begrenzte Sub-Agent-Pakete mit
workflows/faceless-explainer/scripts/frame-packets.mjs. Jeder Frame wird isoliert erstellt (compositions/frames/NN-*.html). - Montage & Audio: Verknüpfe Frames in der root
index.html, mische Voiceover-Track mit Ducking-Hüllkurven und rendere.
Modus 3: Kinetische Motion Graphics & Laufzeiten (motion-graphics, music-to-video)
Verwendet für eigenständige Motion Graphics, animierte UI-Komponenten, Beat-Raster und Loops.
- Laufzeit-Adapter (
references/animation/adapters/):- GSAP: Präzise Multi-Property-Tweens und suchsichere Timelines.
- Three.js: 3D-Räumliche Ansichtsfenster, Partikelsysteme und Modelle (
references/animation/adapters/three.md). - Lottie: Vektoranimations-Player (
references/animation/adapters/lottie.md). - Anime.js / WAAPI: Kompakte DOM-Morphs und Keyframes.
- CSS-Keyframes: Hardwarebeschleunigte Transformationen.
- Kameraübergänge & Morphs (
references/keyframes/):- Ken-Burns-Schwenks, Punch-In-Zooms, SVG-Pfad-Morphs und Tiefeneffekte.
- Registry-Blöcke & Shader (
references/registry/):- Suche und installiere vorgefertigte Effektblöcke (CRT-Scanlines, Glitch, Filmkörnung, Schimmer-Wisch, Konfetti).
Modus 4: Benutzerdefinierte Kompositionen & Multi-Track-Schnitt (general-video, slideshow)
Verwendet für interaktive Pitch-Decks, Multi-Track-Timeline-Schnitt und benutzerdefinierte HTML-Videos.
- Studio-Konventionen (
references/studio/studio-conventions.md):- Jede Szene ist eine Unterkomposition (
data-composition-src). - Eine Untertitelspur (
data-track-kind="captions"). - Ein Elementtyp pro Spur (Video, Grafiken, Untertitel, Audio).
- Sicherheitszonen-Konformität (Premiere Titel/Aktion-Safe-Boxen).
- Jede Szene ist eine Unterkomposition (
- Domainübergreifende Creator-Rezepte:
- Trimmen & Schnitte: Aktualisiere
data-start,data-durationunddata-media-start(references/core/tracks-and-clips.md). - Sanfte Zooms: Animiere den inneren Crop-Wrapper mit CSS/GSAP, während das Clip-Timing stabil bleibt (
references/keyframes/). - Audio-Gain & Ducking: Wende Lautstärkehüllkurven und Bus-Kompression an (
references/audio/).
- Trimmen & Schnitte: Aktualisiere
4. Validierung & CLI-Toolchain
Führe vor der Auslieferung immer Validierungs-Gates durch:
# Neues Hyperframes-Projekt mit Workflow-Gerüst initialisieren
npx hyperframes init "videos/<project>" --skill=<workflow-name>
# Live-Web-Assets, Screenshots und Marken-Tokens erfassen
npx hyperframes capture "<URL>" -o ./capture --json
# Kompositions-Timeline, Tracks und Clips inspizieren
npx hyperframes timeline [--json]
# Timing-Attribute, Sicherheitszonen und fehlende Assets validieren
npx hyperframes check
# Interaktiven lokalen Player starten
npx hyperframes preview
# Finales MP4 rendern
npx hyperframes render --output output.mp4
5. Verzeichniszuordnung
| Pfad | Zweck |
|---|---|
workflows/ | Alle 11 Upstream-Workflows (product-launch-video, faceless-explainer, pr-to-video, motion-graphics, etc.) |
engine/ | Kanonische Hyperframes v0.8.77 Upstream-Paketsuites |
references/core/ | Timing-Attribute, Deterministische Regeln, Track-Modelle, Unterkompositionen |
references/animation/ | GSAP, Three.js, Lottie, Anime.js, CSS-Adapter, Blaupausen, Bewegungsunschärfe |
references/keyframes/ | 2D/3D-Kameraübergänge, Zooms, SVG-Morphs, Tiefeneffekte |
references/audio/ | EQ, Ducking, Kompression, Submix-Bus-Automationshüllkurven |
references/creative/ | Design-Spezifikationen, Typografie, Paletten, Frame-Voreinstellungen, Story-Spine |
references/registry/ | Visuelle Blöcke, Shader-Komponenten, Installation und Verdrahtung |
references/studio/ | Studio-Timeline-Layout, Untertitelspuren, Sicherheitszonen |
references/brag/ | Kuratierte /brag Schritt-für-Schritt-Anleitungen, Töne und Musik-Cues |
assets/music/ | Kuratierte Musikbetten in den Genres Cinematic, Hype, Indie, Calm |
scripts/ | analyze_music_cues.py, Frame-Packet-Kern und Audio-Extraktoren |