Communitygithub.com

govindgoel2001/video-editing-toolkit

HyperFrames CLI-Werkzeug — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Verwenden zum Einrichten eines Projekts, Linten, Validieren, Inspizieren des visuellen Layouts in Kompositionen, Vorschau im Studio, Rendern zu Video, Transkribieren von Audio, Generieren von TTS oder Debugging der HyperFrames-Umgebung.

Was ist video-editing-toolkit?

HyperFrames CLI ist ein leistungsstarkes Befehlszeilenwerkzeug für die KI-gestützte Videoproduktion. Es wird über `npx hyperframes` ausgeführt und benötigt Node.js >= 22 sowie FFmpeg. Das Tool bietet einen vollständigen Workflow zum Erstellen, Linten, Inspizieren, Vorschauen und Rendern von HTML-basierten Videokompositionen. Es unterstützt das Transkribieren von Audio mit Whisper sowie die Text-to-Speech-Generierung. Die Plattform hilft Entwicklern und KI-Agenten dabei, Videoinhalte programmatisch zu erstellen und zu verfeinern. Das Tool läuft auf jeder Plattform mit Node.js und ist besonders nützlich für die Automatisierung von Video-Pipelines durch Cursor, Claude Code, Codex oder ähnliche KI-Entwicklungsumgebungen. Es ermöglicht schnelle Iterationen durch `--quality draft` für Entwürfe und stellt die endgültige Ausgabe in hoher Qualität bereit. Zu den wichtigsten Funktionen gehören: - Linting von HTML-Kompositionen auf fehlende Attribute und Layout-Probleme - Visuelle Inspektion mit Headless Chrome zur Erkennung von Überlauf-Fehlern - Hot-Reloading-Vorschau im Studio - Rendern in MP4 oder WebM mit anpassbaren FPS, Qualität und GPU-Beschleunigung - Umgebungsdiagnose mit `doctor`, um häufige Probleme schnell zu beheben.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/govindgoel2001/video-editing-toolkit/tree/HEAD/vendor/hyperframes-skills/hyperframes-cli

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames CLI

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

Arbeitsablauf

  1. Gerüst erstellen — npx hyperframes init my-video
  2. Schreiben — HTML-Komposition verfassen (siehe Skill hyperframes)
  3. Linten — npx hyperframes lint
  4. Visuell inspizieren — npx hyperframes inspect
  5. Vorschau — npx hyperframes preview
  6. Rendern — npx hyperframes render

Vor der Vorschau linten und inspizieren. lint erkennt fehlende data-composition-id, überlappende Tracks und nicht registrierte Zeitleisten. inspect öffnet die gerenderte Komposition in Headless Chrome, durchläuft die Zeitleiste und meldet Text, der aus Blasen/Containern herausragt oder den Canvas verlässt.

Gerüst erstellen

npx hyperframes init my-video                        # interaktiver Assistent
npx hyperframes init my-video --example warm-grain   # 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-Codierungs-Skills. Es verwenden, anstatt Dateien von Hand zu erstellen.

Linting

npx hyperframes lint                  # aktuelles Verzeichnis
npx hyperframes lint ./my-project     # bestimmtes Projekt
npx hyperframes lint --verbose        # Info-Level-Ergebnisse
npx hyperframes lint --json           # maschinenlesbar

Lintet index.html und alle Dateien in compositions/. Meldet Fehler (muss behoben werden), Warnungen (sollte behoben werden) und Informationen (mit --verbose).

Visuelle Inspektion

npx hyperframes inspect                 # inspiziert gerendertes Layout über die Zeitleiste
npx hyperframes inspect ./my-project    # bestimmtes Projekt
npx hyperframes inspect --json          # für Agenten lesbare Ergebnisse
npx hyperframes inspect --samples 15    # dichtere Zeitleistenabtastung
npx hyperframes inspect --at 1.5,4,7.25 # explizite Zeitstempel für Hauptbilder

Dies nach lint und validate verwenden, besonders bei Kompositionen mit Sprechblasen, Karten, Untertiteln oder enger Typografie. Es meldet:

  • Text, der außerhalb des nächsten visuellen Containers oder der Blase liegt
  • Text, der durch eigene feste Breite/Höhe abgeschnitten ist
  • Text, der außerhalb des Kompositions-Canvas liegt
  • Kindelemente, die aus abschneidenden Containern entkommen

Fehler sollten vor dem Rendern behoben werden. Warnungen werden zur Überprüfung durch den Agenten angezeigt; --strict hinzufügen, um auch bei Warnungen fehlzuschlagen. Wiederholte statische Probleme werden standardmäßig zusammengefasst, sodass die JSON-Ausgabe kompakt für LLM-Kontextfenster bleibt. Wenn ein Überlauf für eine Ein-/Ausgangsanimation beabsichtigt ist, das Element oder den Vorfahren mit data-layout-allow-overflow markieren. Wenn ein dekoratives Element niemals geprüft werden soll, mit data-layout-ignore markieren.

npx hyperframes layout bleibt als Kompatibilitätsalias für denselben visuellen Inspektionsdurchlauf verfügbar.

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.

Wenn ein Projekt an den Benutzer übergeben wird, die Studio-Projekt-URL und nicht den Quellpfad index.html verwenden:

http://localhost:<port>/#project/<projektname>

Den tatsächlichen Port aus der Vorschauausgabe und den Projektverzeichnisnamen verwenden. Zum Beispiel nach npx hyperframes preview --port 3017 in codex-openai-video http://localhost:3017/#project/codex-openai-video melden.

index.html nur als Quellcode-Kontext behandeln. Es ist in Ordnung, es als Implementierungsdatei zu verlinken, aber es nicht als Projekt oder Vorschauoberfläche zu bezeichnen.

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        # endgültige 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 zum Iterieren
--formatmp4, webmmp4WebM unterstützt Transparenz
--workers1-8 oder autoautoJeder startet Chrome
--dockerFlagausReproduzierbare Ausgabe
--gpuFlagausGPU-beschleunigte Codierung
--strictFlagausFehler bei Lint-Fehlern
--strict-allFlagausFehler bei Fehlern UND Warnungen

Qualitätsrichtlinie: draft beim Iterieren, standard zur Überprüfung, high für die endgültige 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, Arbeitsspeicher)
npx hyperframes browser      # gebündelten Chrome verwalten
npx hyperframes info         # Version und Umgebungsdetails
npx hyperframes upgrade      # nach Updates suchen

doctor zuerst ausführen, wenn das Rendern fehlschlägt. Häufige Probleme: fehlendes FFmpeg, fehlendes Chrome, niedriger Arbeitsspeicher.

Sonstiges

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

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

govindgoel2001/video-editing-toolkit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

govindgoel2001/video-editing-toolkit

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

govindgoel2001/video-editing-toolkit

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

govindgoel2001/video-editing-toolkit

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

govindgoel2001/video-editing-toolkit

Edit any video by conversation. Transcribe, cut, color grade, generate overlay animations, burn subtitles — for talking heads, montages, tutorials, travel, interviews. No presets, no menus. Ask questions, confirm the plan, execute, iterate, persist. Production-correctness rules are hard; everything else is artistic freedom.

govindgoel2001/video-editing-toolkit

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

Verwandte Skills