Aperçu
Cette compétence génère une vidéo qui visualise l'audio — formes d'onde ou éléments synchronisés sur le rythme — à partir d'un fichier musical via une composition HyperFrames. Utilisez-la lorsqu'un morceau a besoin d'un visuel d'accompagnement sans montage manuel. Elle rend le MP4 final à partir de la composition.
HyperFrames — Musique vers Vidéo
Un morceau de musique → une vidéo synchronisée sur le rythme. Paroles, diaporama ou promotion cinétique. La musique pilote le rythme.
Quand l'utiliser
- L'utilisateur fournit un fichier audio et souhaite une vidéo pour celui-ci
- L'utilisateur fournit une vidéo dont extraire l'audio (extraction musicale)
- L'utilisateur fournit un brief d'ambiance ("lofi dynamique pour lancement de produit")
- L'utilisateur souhaite une vidéo de paroles (mots synchronisés sur les voix)
- L'utilisateur souhaite un diaporama synchronisé sur le rythme (images changeant sur les temps)
- L'utilisateur souhaite une promotion cinétique (typographie pulsant avec le morceau)
Quand NE PAS l'utiliser
- L'utilisateur souhaite un lancement de produit à partir d'une URL (utilisez
hyperframes-product-launch-video) - L'utilisateur souhaite une vidéo tête parlante (utilisez
hyperframes-talking-head-recut) - L'utilisateur souhaite une narration/voix off (utilisez
hyperframes-faceless-explainer) - Pas de musique impliquée (utilisez
hyperframes-motion-graphics)
Flux de travail
1 · Résoudre l'audio
Trois chemins d'entrée :
- Fichier audio fourni : analysez avec
ffprobepour la durée, le BPM (estimation ou détection) - Vidéo fournie : extrayez avec
ffmpeg -i input.mp4 -vn -acodec libmp3lame audio.mp3 - Brief d'ambiance : générez via TTS/modèle musical, ou choisissez dans un catalogue BGM
2 · Cartographier la structure rythmique
Écoutez (ou analysez) pour les sections :
- Intro (0-8 s) → titre/établissement
- Couplet → contenu/diaporama
- Refrain/Chute → apogée/pic cinétique
- Outro → CTA/fondu
Écrivez une carte des temps : [{ time: 0, section: "intro" }, { time: 8, section: "couplet" }, ...]
3 · Planifier les scènes selon les sections
Chaque section musicale reçoit un traitement visuel :
- Intro : fondu d'entrée lent, mouvement minimal
- Couplet : révélations régulières, un élément toutes les 2 à 4 pulsations
- Refrain : énergie maximale — explosions d'échelle, changements de couleur, coupures rapides
- Pont : répit visuel — maintien statique ou panoramique lent
- Outro : résolution vers le carton de fin
4 · Construire la composition
Ancrez chaque début d'animation sur la carte des temps. Utilisez des keyframes CSS ou GSAP avec des temps absolus correspondant aux limites des sections.
<div id="main" data-composition-id="music-video"
data-start="0" data-duration="60" data-width="1080" data-height="1920" data-fps="30">
<div class="clip chorus-hit" data-start="32" data-duration="8" data-track-index="1">
<h1 class="lyric-line">TEXTE DU REFRAIN ICI</h1>
</div>
<audio data-start="0" data-duration="60" src="./track.mp3"></audio>
</div>
5 · Rendre
npx hyperframes render --output music-video.mp4
Vérifiez la synchronisation : échantillonnez les images aux limites des sections, confirmez que les changements visuels tombent sur les temps (tolérance de ±2 images).
Tableau Anti-Rationalisation
| Rationalisation | Réalité |
|---|---|
| "Je vais estimer le timing à l'œil" | Carte des temps d'abord — chaque scène ancrée aux temps des sections |
| "Je vais utiliser la même énergie partout" | Le refrain frappe plus fort que le couplet — la dynamique compte |
| "Je vais sauter la sonde audio" | Une discordance durée/BPM casse tout le rendu |
| "Je vais animer en temps réel" | Toutes les animations sont accessibles — temps absolus dans la composition |
Vérification
- Audio résolu (fichier, extrait ou généré)
- Carte des temps écrite avec les limites des sections
- Chaque section a un traitement visuel distinct
- Les temps d'animation correspondent à la carte des temps (±2 images)
- La durée de sortie correspond à la durée audio
- Le refrain/pic est visuellement distinct du couplet