HyperFrames CLI
Tout passe par npx hyperframes. Nécessite Node.js >= 22 et FFmpeg.
Flux de travail
- Créer —
npx hyperframes init my-video - Écrire — composer le HTML de la composition (voir le skill
hyperframes) - Analyser —
npx hyperframes lint(vérifications statiques) - Valider —
npx hyperframes validate(vérifications d'exécution basées navigateur + audit de contraste) - Prévisualiser —
npx hyperframes preview - Rendre —
npx hyperframes render
L'analyse détecte les problèmes statiques (data-composition-id manquant, pistes qui se chevauchent, timelines non enregistrées). La validation détecte les problèmes d'exécution/visuels en parcourant la composition en pause dans un navigateur réel (contraste, superpositions cassées, ressources manquantes). Exécutez les deux avant le rendu.
Validation
npx hyperframes validate # validation complète (statique + contraste + contrat)
npx hyperframes validate --no-contrast # ignorer l'audit de contraste WCAG pour itérer rapidement
npx hyperframes validate --json # sortie lisible par machine
La validation parcourt plusieurs horodatages de la composition en pause, capture la page en image, échantillonne les pixels derrière chaque élément de texte pour calculer les ratios de contraste WCAG, et vérifie les contrats d'exécution (enregistrement de window.__timelines, présence de class="clip", attributs data-* valides). Lancez-la avant chaque rendu — elle est peu coûteuse et détecte des problèmes que l'analyse ne voit pas.
Création
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 : 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 IA. Utilisez-la plutôt que de créer les fichiers à la main.
Analyse
npx hyperframes lint # répertoire courant
npx hyperframes lint ./my-project # projet spécifique
npx hyperframes lint --verbose # résultats au niveau info
npx hyperframes lint --json # sortie lisible par machine
Analyse index.html et tous les fichiers dans compositions/. Signale les erreurs (à corriger), les avertissements (à corriger de préférence) et les informations (avec --verbose).
Prévisualisation
npx hyperframes preview # servir le répertoire courant
npx hyperframes preview --port 4567 # port personnalisé (par défaut 3002)
Recharge à chaud lors des modifications de fichiers. Ouvre automatiquement le studio dans votre navigateur.
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
| Option | Options | Défaut | Notes |
|---|---|---|---|
--output | chemin | renders/nom_horodatage.mp4 | Chemin de sortie |
--fps | 24, 30, 60 | 30 | 60 ips double le temps de rendu |
--quality | draft, standard, high | standard | draft pour itérer |
--format | mp4, webm | mp4 | WebM prend en charge la transparence |
--workers | 1-8 ou auto | auto | Chacun lance Chrome |
--docker | drapeau | désactivé | Sortie reproductible |
--gpu | drapeau | désactivé | Encodage accéléré par GPU |
--strict | drapeau | désactivé | Échec en cas d'erreurs d'analyse |
--strict-all | drapeau | désactivé | Échec en cas d'erreurs ET d'avertissements |
Conseils de qualité : draft pour itérer, standard pour la revue, 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
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 # version et détails de l'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
npx hyperframes compositions # lister les compositions du projet
npx hyperframes docs # ouvrir la documentation
npx hyperframes benchmark . # évaluer les performances de rendu