Communitygithub.com

HyperFrames CLI

HyperFrames CLI-Tool — hyperframes init, lint, validate, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Verwenden Sie es beim Erstellen eines Projekts, Linten oder Validieren von Kompositionen, Vorschau im Studio, Rendern von Videos, Transkribieren von Audio, Generieren von TTS oder Fehlerbehebung in der HyperFrames-Umgebung.

Was ist HyperFrames CLI?

Das HyperFrames CLI-Tool (`npx hyperframes`) ist das zentrale Werkzeug für den Workflow mit HyperFrames, einem Framework zur programmatischen Videoproduktion. Es unterstützt alle wichtigen Schritte: Initialisierung von Projekten (`init`), statische Code-Analyse (`lint`), browserbasierte Validierung (`validate`), Live-Vorschau (`preview`), Video-Rendering (`render`), Audio-Transkription (`transcribe`), Text-to-Speech (`tts`) und Umgebungsdiagnose (`doctor`). Das Tool erfordert Node.js ≥22 und FFmpeg. Die `validate`-Funktion ist besonders nützlich, da sie Laufzeitfehler wie Kontrastprobleme oder fehlende Assets erkennt, die mit `lint` nicht sichtbar sind. Entwickler können es sowohl interaktiv als auch in CI/CD-Pipelines (`--non-interactive`, `--json`) nutzen. Es ist ideal für Agenten, die automatisiert Videoinhalte erstellen und überprüfen müssen.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/johnnyjclin/video-producer/tree/HEAD/.claude/skills/hyperframes-cli

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht HyperFrames CLI?

Alles läuft über npx hyperframes. Erfordert Node.js >= 22 und FFmpeg.

Workflow

  1. Erstellen — npx hyperframes init my-video
  2. Schreiben — HTML-Komposition erstellen (siehe das hyperframes-Skill)
  3. Linten — npx hyperframes lint (statische Prüfungen)
  4. Validieren — npx hyperframes validate (browserbasierte Laufzeitprüfungen + Kontrast-Audit)
  5. Vorschau — npx hyperframes preview
  6. Rendern — npx hyperframes render

lint findet statische Probleme (fehlende data-composition-id, überlappende Tracks, nicht registrierte Timelines). validate findet Laufzeit-/visuelle Probleme, indem es in einem echten Browser in die pausierte Komposition springt (Kontrast, defekte Overlays, fehlende Assets). Führen Sie beide vor dem Rendern aus.

Validierung

npx hyperframes validate                 # vollständige Validierung (statisch + Kontrast + Verträge)
npx hyperframes validate --no-contrast   # WCAG-Kontrastprüfung bei schnellen Iterationen überspringen
npx hyperframes validate --json          # maschinenlesbare Ausgabe

Die Validierung springt zu mehreren Zeitstempeln in der pausierten Komposition, macht Screenshots der Seite, sampelt Pixel hinter jedem Textelement, um WCAG-Kontrastverhältnisse zu berechnen, und überprüft Laufzeitverträge (window.__timelines-Registrierung, Vorhandensein von class="clip", gültige data-*-Attribute). Führen Sie sie vor jedem Rendern durch – sie ist günstig und fängt Fehler, die lint nicht sieht.

Projekterstellung

npx hyperframes init my-video                        # interaktiver Assistent
npx hyperframes init my-video --example warm-grain   # ein Beispiel auswählen
npx hyperframes init my-video --video clip.mp4        # mit Videodatei
npx hyperframes init my-video --audio track.mp3       # mit Audiodatei
npx hyperframes init my-video --non-interactive       # Eingabeaufforderungen überspringen (CI/Agenten)

Vorlagen: blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph.

init erstellt die richtige Dateistruktur, kopiert Medien, transkribiert Audio mit Whisper und installiert KI-Programmier-Skills. Verwenden Sie es, anstatt Dateien von Hand zu erstellen.

Linting

npx hyperframes lint                  # aktuelles Verzeichnis
npx hyperframes lint ./my-project     # spezifisches Projekt
npx hyperframes lint --verbose        # Informationsebene-Funde
npx hyperframes lint --json           # maschinenlesbar

Lintet index.html und alle Dateien in compositions/. Meldet Fehler (müssen behoben werden), Warnungen (sollten behoben werden) und Informationen (mit --verbose).

Vorschau

npx hyperframes preview                   # aktuelles Verzeichnis bereitstellen
npx hyperframes preview --port 4567       # benutzerdefinierter Port (Standard 3002)

Hot-Reload bei Dateiänderungen. Öffnet das Studio automatisch im Browser.

Rendern

npx hyperframes render                                # Standard-MP4
npx hyperframes render --output final.mp4             # benannte Ausgabe
npx hyperframes render --quality draft                # schnelle Iteration
npx hyperframes render --fps 60 --quality high        # finale Auslieferung
npx hyperframes render --format webm                  # transparentes WebM
npx hyperframes render --docker                       # byte-identisch
FlagOptionenStandardHinweise
--outputPfadrenders/name_timestamp.mp4Ausgabepfad
--fps24, 30, 603060fps verdoppelt Renderzeit
--qualitydraft, standard, highstandarddraft für Iterationen
--formatmp4, webmmp4WebM unterstützt Transparenz
--workers1-8 oder autoautoJeder startet Chrome
--dockerFlaggeausReproduzierbare Ausgabe
--gpuFlaggeausGPU-beschleunigte Kodierung
--strictFlaggeausBei Lint-Fehlern abbrechen
--strict-allFlaggeausBei Fehlern UND Warnungen abbrechen

Qualitätshinweis: draft während Iterationen, standard für Reviews, high für finale Auslieferung.

Transkription

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language en
npx hyperframes transcribe subtitles.srt   # vorhandene importieren
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

Text-to-Speech

npx hyperframes tts "Text hier" --voice af_nova --output narration.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # alle Stimmen anzeigen

Fehlerbehebung

npx hyperframes doctor       # Umgebung prüfen (Chrome, FFmpeg, Node, Speicher)
npx hyperframes browser      # gebündelten Chrome verwalten
npx hyperframes info         # Versions- und Umgebungsdetails
npx hyperframes upgrade      # auf Updates prüfen

Führen Sie zuerst doctor aus, wenn das Rendern fehlschlägt. Häufige Probleme: fehlendes FFmpeg, fehlendes Chrome, zu wenig Speicher.

Sonstiges

npx hyperframes compositions   # Kompositionen im Projekt auflisten
npx hyperframes docs           # Dokumentation öffnen
npx hyperframes benchmark .    # Renderleistung benchmarken

Verwandte Skills