Communitygithub.com

HyperFrames CLI — Kit de montage vidéo

Outil en ligne de commande HyperFrames : hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. À utiliser pour lancer un projet, le linting, la validation, l'inspection visuelle des compositions, la prévisualisation dans le studio, le rendu vidéo, la transcription audio, la synthèse vocale ou le diagnostic de l'environnement HyperFrames.

Qu'est-ce que HyperFrames CLI — Kit de montage vidéo ?

Le skill **HyperFrames CLI** est un outil en ligne de commande qui permet d'orchestrer l'ensemble du flux de production vidéo — de l'initialisation d'un projet jusqu'au rendu final. Il s'appuie sur `npx hyperframes` et nécessite Node.js >= 22 ainsi que FFmpeg. Ce skill guide l'utilisateur à travers les étapes : création du projet, rédaction des compositions HTML, linting, inspection visuelle, prévisualisation, rendu MP4/WebM, transcription Whisper, synthèse vocale (TTS) et diagnostic de l'environnement. Il est conçu pour les développeurs et les agents IA (comme Claude Code, Cursor, Codex) qui souhaitent automatiser la production de vidéos animées. Les commandes distinctes permettent une intégration fine : `lint` détecte les erreurs de structure, `inspect` vérifie le dépassement de texte dans les bulles ou conteneurs, `preview` lance un serveur avec rechargement à chaud, et `render` exporte en haute qualité avec options de parallélisation. Le skill supporte également la transcription audio et la génération de voix, ainsi que des diagnostics `doctor` pour s'assurer que Chrome, FFmpeg et la mémoire sont disponibles. L'ensemble des commandes est documenté dans un fichier SKILL.md détaillé, traduit ici en français.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

CLI HyperFrames

Tout s'exécute via npx hyperframes. Nécessite Node.js >= 22 et FFmpeg.

Flux de travail

  1. Scaffolding — npx hyperframes init my-video
  2. Rédaction — composer le code HTML (voir le skill hyperframes)
  3. Linting — npx hyperframes lint
  4. Inspection visuelle — npx hyperframes inspect
  5. Prévisualisation — npx hyperframes preview
  6. Rendu — npx hyperframes render

Effectuez le linting et l'inspection avant la prévisualisation. lint détecte les data-composition-id manquants, les pistes qui se chevauchent et les timelines non enregistrées. inspect ouvre la composition rendue dans Chrome sans tête, parcourt la timeline et signale le texte qui déborde des bulles/conteneurs ou du canevas.

Scaffolding

npx hyperframes init my-video                        # assistant interactif
npx hyperframes init my-video --example warm-grain   # choisir un exemple
npx hyperframes init my-video --video clip.mp4        # avec fichier vidéo
npx hyperframes init my-video --audio track.mp3       # avec fichier audio
npx hyperframes init my-video --non-interactive       # ignorer les invites (CI/agents)

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

init crée la structure de fichiers appropriée, copie les médias, transcrit l'audio avec Whisper et installe les compétences de codage IA. À utiliser plutôt que de créer les fichiers à la main.

Linting

npx hyperframes lint                  # répertoire courant
npx hyperframes lint ./my-project     # projet spécifique
npx hyperframes lint --verbose        # résultats au niveau information
npx hyperframes lint --json           # lisible par machine

Analyse index.html et tous les fichiers dans compositions/. Signale les erreurs (à corriger impérativement), les avertissements (à corriger si possible) et les informations (avec --verbose).

Inspection visuelle

npx hyperframes inspect                 # inspecte la mise en page rendue sur la timeline
npx hyperframes inspect ./my-project    # projet spécifique
npx hyperframes inspect --json          # résultats lisibles par agent
npx hyperframes inspect --samples 15    # balayage plus dense de la timeline
npx hyperframes inspect --at 1.5,4,7.25 # horodatages explicites des images clés

À utiliser après lint et validate, surtout pour les compositions avec bulles de dialogue, cartes, légendes ou typographie serrée. Il signale :

  • Le texte qui s'étend en dehors du conteneur visuel ou de la bulle le plus proche
  • Le texte coupé par sa propre boîte à largeur/hauteur fixe
  • Le texte qui s'étend en dehors du canevas de la composition
  • Les enfants qui s'échappent des conteneurs de coupure

Les erreurs doivent être corrigées avant le rendu. Les avertissements sont remontés pour examen par l'agent ; ajoutez --strict pour échouer également sur les avertissements. Les problèmes statiques répétés sont regroupés par défaut afin que la sortie JSON reste compacte pour les fenêtres de contexte des LLM. Si un débordement est intentionnel (animation d'entrée/sortie), marquez l'élément ou son ancêtre avec data-layout-allow-overflow. Si un élément décoratif ne doit jamais être audité, marquez-le avec data-layout-ignore.

npx hyperframes layout reste disponible comme alias de compatibilité pour la même passe d'inspection visuelle.

Prévisualisation

npx hyperframes preview                   # sert le répertoire courant
npx hyperframes preview --port 4567       # port personnalisé (par défaut 3002)

Rechargement à chaud sur les modifications de fichiers. Ouvre le studio dans votre navigateur automatiquement.

Lorsque vous remettez un projet à l'utilisateur, utilisez l'URL du projet Studio, pas le chemin source index.html :

http://localhost:<port>/#project/<project-name>

Utilisez le port réel indiqué par la sortie de prévisualisation et le nom du répertoire du projet. Par exemple, après npx hyperframes preview --port 3017 dans codex-openai-video, signalez http://localhost:3017/#project/codex-openai-video.

Considérez index.html uniquement comme contexte de code source. Il est acceptable de le lier en tant que fichier d'implémentation, mais ne le qualifiez pas de projet ou de surface de prévisualisation.

Rendu

npx hyperframes render                                # MP4 standard
npx hyperframes render --output final.mp4             # sortie nommée
npx hyperframes render --quality draft                # itération rapide
npx hyperframes render --fps 60 --quality high        # livraison finale
npx hyperframes render --format webm                  # WebM transparent
npx hyperframes render --docker                       # sortie identique octet par octet
OptionOptions possiblesPar défautNotes
--outputcheminrenders/nom_timestamp.mp4Chemin de sortie
--fps24, 30, 603060 ips double le temps de rendu
--qualitydraft, standard, highstandarddraft pour itérer
--formatmp4, webmmp4WebM supporte la transparence
--workers1-8 ou autoautoChacun lance Chrome
--dockerdrapeaudésactivéSortie reproductible
--gpudrapeaudésactivéEncodage accéléré par GPU
--strictdrapeaudésactivéÉchouer sur les erreurs de lint
--strict-alldrapeaudésactivéÉchouer sur erreurs ET avertissements

Conseils de qualité : draft pendant l'itération, standard pour la révision, high pour la livraison finale.

Transcription

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

Synthèse vocale (TTS)

npx hyperframes tts "Texte ici" --voice af_nova --output narration.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # afficher toutes les voix

Dépannage

npx hyperframes doctor       # vérifier l'environnement (Chrome, FFmpeg, Node, mémoire)
npx hyperframes browser      # gérer le Chrome intégré
npx hyperframes info         # détails de version et d'environnement
npx hyperframes upgrade      # vérifier les mises à jour

Exécutez doctor en premier si le rendu échoue. Problèmes courants : FFmpeg manquant, Chrome manquant, mémoire insuffisante.

Autres commandes

npx hyperframes compositions   # lister les compositions du projet
npx hyperframes docs           # ouvrir la documentation
npx hyperframes benchmark .    # évaluer les performances de rendu

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.

Skills associés