CLI HyperFrames
Tout passe par npx hyperframes. Nécessite Node.js >= 22 et FFmpeg.
Workflow
- Scaffold —
npx hyperframes init my-video - Écrire — composer une composition HTML (voir la compétence
hyperframes) - Linter —
npx hyperframes lint - Prévisualiser —
npx hyperframes preview - Rendre —
npx hyperframes render
Lintez avant de prévisualiser — détecte les data-composition-id manquants, les pistes qui se chevauchent, les timelines non enregistrées.
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 : 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. Utilisez-le plutôt que de créer les fichiers manuellement.
Linting
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 # lisible par machine
Linte index.html et tous les fichiers dans compositions/. Signale les erreurs (à corriger impérativement), les avertissements (devraient être corrigés) et les informations (avec --verbose).
Prévisualisation
npx hyperframes preview # servir le répertoire courant
npx hyperframes preview --port 4567 # port personnalisé (défaut 3002)
Rechargement à chaud lors des modifications de fichiers. Ouvre le studio dans votre navigateur automatiquement.
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 pour octet
| Option | Options | Défaut | Remarques |
|---|---|---|---|
--output | chemin | renders/nom_timestamp.mp4 | Chemin de sortie |
--fps | 24, 30, 60 | 30 | 60fps 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 | Chaque instance lance Chrome |
--docker | flag | désactivé | Sortie reproductible |
--gpu | flag | désactivé | Encodage accéléré GPU |
--strict | flag | désactivé | Échec sur erreurs de lint |
--strict-all | flag | désactivé | Échec 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 # 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 . # mesurer la performance du rendu