Vidéo Verticale Courte (Hyperframes)
Format court = 1080x1920 vertical, 10–30 s, tête parlante + superpositions de scènes graphiques animées + sous-titres karaoké. Tout ce qui se trouve dans cette compétence est tiré de l'autopsie d'itération May Shorts 19 (v1 → v4) et doit être appliqué à chaque nouveau court.
Invoquez toujours /hyperframes en premier. Cette compétence se superpose à lui — elle ne remplace pas les règles du framework (attributs data-*, window.__timelines, structure de composition). Ceux-ci sont non négociables quel que soit le format.
Quand cette compétence se déclenche
- « Faire une vidéo courte », « publication TikTok », « Reels », « Shorts », « vidéo verticale »
- Toute création à partir d'un enregistrement de tête parlante + script/transcription destiné aux réseaux sociaux
- Réajustement, recoupage ou resynchronisation d'un court existant
- Ajout de sous-titres karaoké synchronisés avec une voix off
Le playbook (haut niveau)
- L'audio est la source de vérité. Montez l'audio EN PREMIER (supprimez les reprises, les pauses). Enregistrez sous
<nom>-edit.mp4. Mesurez la durée exacte avecffprobe— c'est ladata-durationde la composition. - Transcrivez l'audio monté avec
npx hyperframes transcribe <edit>.mp4 --model small.en --json, ou si vous réajustez une construction existante avec une fonctionshift()dans les sous-titres, conservez les sous-titres existants et décalez simplement les débuts de scène. - Définissez les limites des scènes dans le temps monté — NE mélangez JAMAIS les ancres de temps original et de temps monté dans le même fichier. Voir « Protocole de synchronisation audio » ci-dessous.
- Construisez l'échafaudage de la composition (4 couches : fond ambiant, traitement de jointure, sous-titres, visage) — voir « Échafaudage de composition » ci-dessous.
- Créez les scènes avec des décalages LOCAUX par rapport au
data-startde chaque scène. Chaque scène est sa propre sous-composition souscompositions/scene<N>-<label>.html. - Lint → rendu brouillon → vérification image par image au mot exact → rendu final. C'est la porte de vérification. Ne sautez jamais l'étape 3 (vérification des images).
Échafaudage de composition (les 4 couches toujours actives)
Chaque vidéo verticale courte a ces quatre sous-compositions sous compositions/, chargées sur des pistes partagées :
index.html (racine, 1080x1920, data-composition-id="main")
├── ambient-bg.html track-index="3" — dégradé radial + grille dérivante + particules + vignette
├── face-wrapper + <video> track-index="0" — tête parlante (voir chorégraphie du mode visage)
├── seam-treatment.html track-index="5" — plume à y=960 (scènes moitié inférieure uniquement)
├── scene1-<label>.html track-index="1" — superpositions de scènes (dos à dos, sans trous)
├── scene2-<label>.html track-index="1"
├── …
└── captions.html track-index="2" — sous-titres karaoké, synchronisés mot par mot
data-durationest identique pour la racine, ambient-bg, seam-treatment, face-video, face-audio, captions. Seules les superpositions de scènes changent avec le temps.<audio>pour le visage est un élément SÉPARÉ (le mélangeur en a besoin), n'utilisez jamais la piste audio de la vidéo elle-même.class="clip"va sur les divs minutés — JAMAIS sur<video>ou<audio>.
Chorégraphie du mode visage (le geste signature du format court)
Le visage se trouve dans un div wrapper dimensionné au paysage natif de la source (1920x1080). GSAP anime le WRAPPER (jamais l'élément vidéo — animer les dimensions de <video> fige les images).
Deux modes :
const BOTTOM = { x: 0, y: 1136, scale: 0.5625 }; // moitié inférieure, paysage complet visible
const FULLSCREEN = { x: -1166.5, y: 0, scale: 1.7778 }; // recadrage couvrant, remplit 1080x1920
const MODE_DUR = 0.32;
BOTTOM rend la source 1920x1080 à 1080x607.5 centrée dans les 960px inférieurs. FULLSCREEN recadre horizontalement pour remplir le cadre portrait.
Transition 0.15s AVANT que le contenu de la nouvelle scène n'arrive, en utilisant ease: "expo.inOut" :
[
{ t: <début-scène-4>, mode: FULLSCREEN },
{ t: <début-scène-5>, mode: BOTTOM },
…
].forEach(({ t, mode }) => {
mainTl.to("#face-wrapper", { ...mode, duration: MODE_DUR, ease: "expo.inOut" }, t - 0.15);
});
Un visage qui change de mode instantanément est la seule image la plus discordante dans une vidéo verticale. Interpolez toujours.
Gradation du visage (tous les courts, sans exception)
#face-video {
filter: contrast(1.08) saturate(1.08) brightness(0.97);
}
Plus un zoom Ken Burns subtil de 1,00 à 1,025 sur toute la durée (ease: "none") et un pseudo-élément ::after de vignette latérale pour que le visage s'enfonce dans le bleu marine environnant au lieu de buter contre un bord net.
Traitement de jointure (obligatoire pour les scènes moitié inférieure)
Une bande de dégradé marine→transparent (60–100px) à y=960 plus une ligne de balayage d'accent de 2px avec une lueur douce. Dessinez-la APRÈS le visage pour qu'elle se trouve au-dessus ; les scènes plein écran la couvriront lorsqu'elles prendront le relais. Les coupes nettes à y=960 sont le signe n°2 du contenu monté par IA (après la platitude de l'arrière-plan).
Protocole de synchronisation audio (NE PAS sauter)
Problème : si l'audio est monté (reprises/pauses supprimées), les horodatages dans la transcription source ne correspondent plus à la vidéo montée. Les débuts de scène créés dans le temps original se déclencheront en retard.
La règle : TOUT le timing vit dans le temps monté. Ne mélangez jamais.
Procédure de vérification pour tout réajustement de format court :
- Mesurez les deux fichiers audio :
La différence = temps total coupé.ffprobe -v error -show_entries format=duration -of csv=p=0 assets/original.mp4 ffprobe -v error -show_entries format=duration -of csv=p=0 assets/<nom>-edit.mp4 - Si vous utilisez une fonction
shift()danscaptions.htmlpour mapper les mots de la transcription, traitez-la comme la source de vérité. La carteshift(tempsOriginal) = tempsMontés'applique à TOUTdata-startde scène également. - Les décalages internes de scène (dans
compositions/sceneN.html) sont LOCAUX par rapport audata-startde la scène. Si ledata-startparent d'une scène est correct dans le temps monté, les décalages internes restent corrects SANS modification — SAUF si une scène chevauche une coupe, auquel cas la durée parent ET les décalages internes changent. - Les temps du tableau de transition du mode visage DOIVENT utiliser le temps monté. Ils ne sont PAS automatiquement décalés.
Format de plan pour les réajustements (utilisez cette structure de tableau à chaque fois) :
| Scène | Début actuel | Durée actuelle | Nouveau début | Nouvelle durée | Justification |
|---|---|---|---|---|---|
| ... | ... | ... | ... | ... | ... |
Puis le tableau du mode visage, puis tout changement de décalage interne, puis la liste de vérification des images.
Création de scène
Une scène = un fichier de sous-composition. Les scènes se situent sur le même data-track-index dos à dos (sans trous). À l'intérieur de chaque scène :
data-durationcorrespond exactement à l'emplacement parent- Toutes les ancres GSAP sont LOCALES (basées sur 0 à partir du début de la scène)
- Utilisez
tl.set({}, {}, <data-duration>)pour compléter la timeline afin quetl.duration()de GSAP corresponde àdata-duration
Règles de rythme des scènes (tirées des 10 principes)
- Pas d'images mortes. Chaque 100 ms a ≥1 élément en animation. Décalez la première entrée de 0,1 à 0,3 s, pas à t=0.
- Temps de révélation ≥ 1 s. La « grande révélation » de la scène (tampon, verrouillage numérique, punchline) doit avoir ≥1 s à l'écran, idéalement 1,5 s. Budgetisez les scènes par temps de révélation, pas par temps total.
- Mouvement sur toute la durée. Si les animations d'entrée atterrissent toutes au bout de 2 s locales sur une scène de 4 s, ajoutez un mouvement secondaire : balayages de soulignement, pops de coche, dérive ambiante sur les cartes, petites lueurs oscillantes sur les pilules. Un rythme mort = swipe vers le haut.
- Variez les easings. Au moins 3 easings différents par scène à travers les entrées.
- Un effet bluffant toutes les 5 s de durée. Slam typographique, révélation glitch/chromatique, whip-pan, slam audio-synchrone. Sans cela, la vidéo se lit comme « tête parlante étiquetée » — correct mais oubliable.
Sous-titres (style karaoké)
- Montserrat 900, 46–58px (pour une largeur 1080), base blanche 100 %
- Mot actif : pop scale-1.08 + changement de couleur vers l'accent (
#37bdf8pour AIS, adaptez à la marque) - Contour via
text-shadowen couches, JAMAIS-webkit-text-stroke(rendu incohérent dans le rendu Chromium) - Supprimez la pastille d'arrière-plan rgba — laissez le contour assurer la lisibilité. Les sous-titres doivent ressembler à du graffiti sur l'image, pas à une piste de sous-titres.
- Pour les réajustements, utilisez une fonction
shift()danscaptions.htmlpour mapper les horodatages des mots de la transcription → temps monté. Cela laisse le JSON de transcription intact et rend les réajustements mécaniques.
Voir references/captions.md sous /hyperframes pour l'implémentation complète du karaoké. En résumé : éléments <span> par mot avec data-word-start, tweens GSAP limités à chaque span, durées de pop serrées de 0,08–0,12 s.
Fond ambiant (ne jamais livrer un bleu marine plat)
Pile de fond minimale viable :
- Base de dégradé radial (centre plus clair que les bords de 15–20 %)
- Superposition de bruit/grain animé à 8–12 % d'opacité
- 4–8 points de particules dérivants ou traces de grille
- Vignette subtile
background: #07121c seul est un placeholder, pas un design. Pour une esthétique technique/salle de contrôle, utilisez la pile 6 couches de feedback_techy_background_layers.md (grille HUD masquée à la vignette + traces de circuit + nœuds d'impulsion + faisceau de balayage + téléscripteur télémétrique + étiquettes mono de coin).
Réactivité audio
- Les titres pulsent de 3 à 6 % sur le rythme. Les fonds peuvent aller de 10 à 30 % sur la basse.
- La réactivité du texte reste subtile (3–6 %) pour que les sous-titres restent lisibles ; les fonds peuvent pousser plus fort.
- Utilisez un analyseur HORS LIGNE avec GRAINE (pré-calculez la piste de caractéristiques audio) pour que les rendus soient déterministes. N'utilisez PAS
AnalyserNodedans le chemin de rendu —Math.random()et les nœuds audio en temps réel cassent le déterminisme.
Transitions
- Variez les types. Pas deux transitions consécutives du même type. Six coupes franches à la suite est le signe n°1 du montage IA.
- Les transitions du mode visage (
BOTTOM ↔ FULLSCREEN) servent également de transitions de scène lorsque le mode change entre les scènes. - Pour les transitions de superposition pure de scène à scène, installez depuis le registre :
push-up,flash-through-white,sdf-iris, ou le pack complet de shader-transitions.npx hyperframes catalog --type blockpour parcourir.
La porte de vérification (OBLIGATOIRE — ne livrez PAS sans)
Lint réussi ≠ design fonctionnel. Ne signalez jamais un rendu de format court terminé avant d'avoir extrait des images à des horodatages de mots exacts et LU chaque PNG.
Étape 1 — rendu brouillon
cd video-projects/<slug>
npx hyperframes lint
npx hyperframes render --quality draft --output renders/<slug>-vN-draft.mp4
Étape 2 — extraction d'images à des horodatages de mots exacts
Choisissez 8–15 horodatages qui correspondent chacun à un MOT PRONONCÉ où un visuel spécifique doit être à l'écran. Pas de nombres ronds. Pas de milieu de scène. Le mot exact.
mkdir -p renders/frames-vN
for pair in "<t>:<label>" "<t>:<label>" ...; do
t="${pair%%:*}"; label="${pair##*:}"
ffmpeg -y -ss "$t" -i renders/<slug>-vN-draft.mp4 \
-frames:v 1 -q:v 2 "renders/frames-vN/t${t}-${label}.png"
done
Étape 3 — Lire chaque PNG
Appelez Read sur chaque PNG pour que l'image se charge dans le contexte. Ne listez PAS seulement les noms de fichiers. Pour chaque image, confirmez :
- Le visuel attendu est à l'écran au moment attendu (pas 1 s en retard, pas en avance)
- Le visage de l'orateur n'est pas recadré dans aucune scène moitié inférieure
- Le mode visage plein écran vs moitié inférieure est correct pour cette scène
- Les sous-titres sont conformes à la marque, lisibles, ne débordent pas
- Pas d'images vides, pas de chevauchement involontaire, pas de texte hors écran
Étape 4 — si quelque chose échoue, corrigez + revérifiez. Ne livrez jamais défectueux.
Étape 5 — rendu final
npx hyperframes render --quality standard --output renders/<slug>-vN.mp4
Vérifiez ponctuellement 3–4 images du rendu final (mêmes horodatages, dossier différent frames-vN-final/) pour confirmer que l'encodage en qualité standard n'a rien changé.
Les 10 règles (checklist qualité — exécutez AVANT le premier brouillon)
Toute création de format court. Parcourez cette liste pendant la création, pas après.
- Pas d'images mortes. Chaque 100 ms a un élément en animation.
- Temps de révélation de scène ≥ 1 s. Budgetisez par temps de révélation, pas par temps total.
- Le visage est un personnage. Gradation + Ken Burns + vignette latérale.
- Pas de jointures dures. Plumez à y=960 avec dégradé + ligne de balayage.
- Un effet bluffant toutes les 5 s. Slam typographique, glitch, whip-pan, slam audio.
- Réactivité audio non négociable. 3–6 % texte, 10–30 % fond.
- Variez les types de transition. Pas deux consécutives identiques.
- Les sous-titres claquent, ne se contentent pas d'étiqueter poliment. Contour pas pastille. Échelle + couleur sur le mot actif.
- Mouvement sur toute la durée de la scène. Mouvement secondaire si les entrées atterrissent tôt.
- Le fond est une couche, pas une couleur. Dégradé + bruit + particules + vignette minimum.
- Les superpositions de slam/tampon atterrissent APRÈS que le texte cible est complètement visible. Logique de révélation > synchronisation des mots. Le
tdu tampon ≥tde visibilité cible + 0,10–0,25 s. Sinon, la punchline arrive avant la mise en place.
Structure du projet (toute création de format court)
video-projects/<slug>/
├── hyperframes.json
├── meta.json (id, name, dimensions 1080x1920, fps 30)
├── index.html (composition racine, l'échafaudage 4 couches)
├── compositions/
│ ├── ambient-bg.html
│ ├── seam-treatment.html
│ ├── captions.html (avec fonction shift() si réajustement)
│ ├── scene1-<label>.html
│ ├── scene2-<label>.html
│ └── ...
├── assets/
│ ├── <nom>.mp4 (enregistrement original)
│ ├── <nom>-edit.mp4 (monté — coupes supprimées — c'est ce qu'utilise la comp)
│ ├── transcript.json (sortie whisper)
│ └── actifs de marque (logo, brand-tokens.css, musique de fond)
└── renders/
├── <slug>-v1-draft.mp4
├── frames-v1/
├── <slug>-v1.mp4
└── ...
Protocole de réajustement (quand l'audio est ré-monté ou que les horodatages dérivent)
- Mesurez les durées audio montées anciennes et nouvelles avec
ffprobe. Delta = temps total coupé. - Identifiez la ou les fenêtres de coupe : quelles secondes ont été supprimées, d'où.
- Écrivez le tableau du Plan : chaque
data-startde scène,data-duration, chaque transition de mode visaget, toute scène dont les décalages internes chevauchent une coupe. - Pour chaque scène dont les décalages internes traversent une coupe, ajustez les deux : durée parent (pour tenir compte des secondes supprimées) ET décalages internes (pour que les animations ne sautent pas soudainement). Pour les scènes entièrement dans une fenêtre non coupée, aucun changement n'est nécessaire.
- Copiez
captions.htmldepuis la version précédente et ajoutez une fonctionshift()qui mappe les horodatages de la transcription originale vers le nouveau temps monté. La transcription JSON (de la version originale) n'est pas modifiée. - Mettez à jour le tableau du mode visage avec les nouveaux temps calculés.
- Exécutez la porte de vérification (étapes 1 à 5 ci-dessus) avec une attention particulière aux scènes modifiées.
Attribution et licence
Forked from et s'appuie sur /hyperframes (licence MIT). Le playbook est dérivé de la recherche d'itération May Shorts 19 par Nate et l'équipe (non publiée, usage interne). Tous les actifs et livrables créés par cette compétence appartiennent à l'utilisateur final.