Compétence : Vidéo Explicative Remotion (60-90s)
Cette compétence vous guide dans la création de vidéos explicatives courtes de haute qualité, de 60 à 90 secondes (format TikTok / YouTube Shorts / Reels : 1080x1920 à 30 ips) à partir de n'importe quel sujet.
Elle combine :
- Les meilleures pratiques visuelles de
remotion-dev/skills(ressorts précis aux trames, interpolations verrouillées, composition de séquences, hiérarchie typographique). - La synthèse vocale via
TTS_PROVIDERdans.env:edge(edge-tts-universal, en ligne, gratuit) oucit(CIT Voice Studio, voix studio vietnamiennes hors ligne - téléchargement sur github.com/Cuongyd196/cit-voice-studio, documentation API :docs/cit-voice-studio.md). - Une synchronisation temporelle exacte qui mappe les longueurs des voix off directement dans les séquences de trames Remotion.
1. Structure et Timing de la Vidéo (60-90s / 1800-2700 trames à 30 ips)
Une vidéo courte captivante suit le framework Hook-Problème-Solution-Valeur-Outro :
| Scène | Nom | Durée | Plage de trames (@ 30 ips) | Objectif et Visuels |
|---|---|---|---|---|
| 1 | Hook | 0s – 6s | ~180 trames | Promesse ou question intrigante avec un chiffre, dite dans les 2 premières secondes. Grand titre, effet d'accroche du video-style. |
| 2 | Contexte / Point de douleur | 6s – 17s | ~330 trames | Énonce le problème ou le contexte expliquant pourquoi ce sujet est important. Deux cartes opposées glissent depuis les côtés. |
| 3 | Concept Clé Partie 1 | 17s – 32s | ~450 trames | 1er principe fondamental : carte en verre dépoli, mots-clés en évidence. |
| 4 | Concept Clé Partie 2 | 32s – 48s | ~480 trames | Mécanisme de fonctionnement : processus en 3 étapes, lignes de connexion qui se dévoilent progressivement. |
| 5 | Impact dans le Monde Réel | 48s – 64s | ~480 trames | Application pratique, conseil ou compteur de données. |
| 6 | Outro et Appel à l'Action | 64s – 75s | ~330 trames | Une phrase puissante en guise de conclusion, bouton d'abonnement. |
Pour atteindre 90s, ajoutez 1 à 2 scènes supplémentaires (exemple concret, note importante) avant l'Outro. Toute scène de plus de 13s doit être divisée en deux.
Durée totale : 1800 à 2700 trames (environ 60 à 90 secondes).
2. Génération de la Voix Off TTS (edge | cit)
2.1 Configuration de la Voix via .env
Assurez-vous que le fichier .env est configuré (voir .env.example pour plus de détails) :
TTS_PROVIDER=edge # edge | cit
TTS_OUTPUT_DIR=public/audio
# Edge TTS (TTS_PROVIDER=edge)
EDGE_TTS_VOICE=vi-VN-HoaiMyNeural # ou vi-VN-NamMinhNeural, en-US-ChristopherNeural
EDGE_TTS_RATE=+10% # +10% à +15% pour un rythme rapide et engageant dans les vidéos courtes
# CIT Voice Studio (TTS_PROVIDER=cit)
CIT_TTS_BASE_URL=http://127.0.0.1:8001
CIT_TTS_VOICE=Hải Đăng # liste des voix : docs/cit-voice-studio.md ou GET /voices
CIT_TTS_SPEED=1.1 # 0.5 - 2.0
Lorsque TTS_PROVIDER=cit :
- L'application CIT Voice Studio doit être ouverte. Le script appelle automatiquement
GET /healthavant de générer l'audio ; s'il signale une absence de connexion, invitez l'utilisateur à ouvrir l'application (ou téléchargez-la sur github.com/Cuongyd196/cit-voice-studio). - Le dialogue peut inclure des balises émotionnelles
[crire],[soupir],[raclement de gorge]et la balise de pause[pause 0.5s](elles ne seront pas lues à voix haute). Ne pas abuser : maximum 1 balise par scène. - Erreur
400 Voice not found= nom de voix incorrect (respectez les accents). VérifiezCIT_TTS_VOICE.
2.2 Procédure de Génération des Fichiers Audio
Lorsque vous recevez un sujet, commencez par créer le dossier src/<NomDuSujet>/, car src/<NomDuSujet>/audioData.ts n'est généré que si ce dossier existe déjà. Ensuite, créez scripts/generate-<sujet>-audio.ts et exécutez-le pour générer l'audio :
import { generateTopicVoices } from "./generate-tts";
const scenes = [
{
id: "scene1_hook",
text: "Savez-vous ce qu'est Docker et pourquoi chaque développeur en a besoin ?",
},
{
id: "scene2_problem",
text: "Avant, la phrase 'ça marche sur ma machine' était un cauchemar lors de la livraison du produit.",
},
{
id: "scene3_concept1",
text: "Docker résout ce problème avec les conteneurs : empaqueter tout le code et l'environnement en un seul bloc.",
},
{
id: "scene4_concept2",
text: "Contrairement aux machines virtuelles lourdes, Docker partage le noyau du système d'exploitation, ce qui permet un démarrage en un clin d'œil.",
},
{
id: "scene5_impact",
text: "Grâce à cela, vous déployez des applications en douceur sur n'importe quel serveur, d'AWS et GCP aux VPS bon marché.",
},
{
id: "scene6_outro",
text: "Abonnez-vous à la chaîne pour maîtriser chaque jour des connaissances technologiques concises !",
},
];
generateTopicVoices("DockerShort", scenes).catch((error) => {
console.error(error);
process.exitCode = 1;
});
Les fichiers audio seront automatiquement sauvegardés dans public/audio/<NomDuSujet>/<sceneId>.<ext> (.mp3 pour edge, .wav pour cit) avec un fichier manifest.json enregistrant le nombre exact de trames (durationInFrames) et le audioPath pour chaque scène.
- Options par scène :
voice(voix du fournisseur sélectionné),rate/pitch/volume(edge uniquement),speed0.5-2.0 (cit uniquement). - Les fichiers existants sont réutilisés (cache). Pour régénérer après modification du script ou changement de voix, supprimez d'abord le fichier audio correspondant.
3. Règles de Codage Remotion (issues de remotion-dev/skills)
Lors de l'écriture du code source Remotion, vous DEVEZ respecter les principes suivants :
3.1 Utilisation des Animations Spring
N'utilisez pas de keyframes/transitions CSS ou d'easing linéaire sans vie. Utilisez spring() :
import { spring, useCurrentFrame, useVideoConfig } from "remotion";
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
// Spring rebondissant et fluide pour les Cartes/Icônes
const scale = spring({
frame,
fps,
config: {
damping: 12, // Moins de 15 crée un rebond élastique naturel
stiffness: 100, // Tension
mass: 0.8,
},
});
const entrance = spring({
frame: frame - 10, // Délai de 10 trames
fps,
from: 50,
to: 0,
});
3.2 Interpolation Sécurisée (Toujours Verrouillée)
Fournissez toujours extrapolateLeft: "clamp" et extrapolateRight: "clamp" pour éviter les dépassements de valeurs lorsque la timeline sort de la plage :
import { interpolate } from "remotion";
const opacity = interpolate(frame, [0, 15], [0, 1], {
extrapolateLeft: "clamp",
extrapolateRight: "clamp",
});
3.3 Intégration Audio et Synchronisation des Séquences
Chaque scène dans la Composition utilise <Sequence> ou <Series> pour gérer le timing avec précision :
import { Audio, staticFile, Sequence } from "remotion";
// Dans le composant Scene - récupérez le chemin depuis le manifest, NE codez PAS en dur l'extension .mp3 (le fournisseur cit génère du .wav) :
<Sequence from={0} durationInFrames={sceneDuration}>
<Audio src={staticFile(audioManifest.scenes[0].audioPath)} />
<SceneContent />
</Sequence>
- Tampon de Transition Concis (Snappy Transition Buffer) :
- Le tampon entre les scènes doit être de +3 à +4 trames (environ 0,1s) après la fin de la voix off.
- Évitez les tampons trop longs (+15 à +20 trames) qui créent des silences/morts rythmiques entre les scènes. La scène suivante doit apparaître immédiatement après la phrase précédente pour maintenir un rythme soutenu et captivant pour les vidéos courtes.
// Exemple de calcul des durées des scènes dans une Series
// Les valeurs du manifest incluent déjà un tampon de 10 trames, donc soustrayez-les avant d'ajouter le nouveau tampon.
const d1 = audioManifest.scenes[0].durationInFrames - 10 + 3;
const d2 = audioManifest.scenes[1].durationInFrames - 10 + 3;
// ...
3.4 Normes de Conception Visuelle (Vertical 1080x1920)
L'ensemble du style (fond, cartes en verre dépoli, marque, tailles de police, mise en page, sous-titres, mouvements, accroche) suit la compétence video-style. Copiez theme.ts et components/ depuis src/ClaudeBugHunterRepo/. N'utilisez pas d'emoji ou d'icônes décoratives dans le texte.
4. Processus de Création Vidéo Étape par Étape pour Antigravity / Codex
Lorsque vous recevez la demande : "Créez une vidéo explicative sur [Sujet X]" :
Étape 1 : Écrire le Script
- Identifiez les 6 scènes (Hook, Problème, Concept 1, Concept 2, Impact, Outro).
- Rédigez un dialogue en français (ou vietnamien) naturel, concis, avec des phrases courtes (total de 260 à 330 mots, 35 à 50 mots par scène). La scène 1 commence par une promesse ou un résultat concret ; voir la section Accroche et Dialogue de
video-style.
Étape 2 : Générer la Voix Off (TTS)
- Lisez
TTS_PROVIDERdans.envpour savoir si vous utilisez edge ou cit. - Créez le dossier
src/<NomDuSujet>/, puis le scriptscripts/generate-<sujet>-audio.tsqui appellegenerateTopicVoices, exécuteznpx tsx scripts/generate-<sujet>-audio.ts. - Récupérez la liste des durées réelles en trames depuis
manifest.json/src/<NomDuSujet>/audioData.ts.
Étape 3 : Créer le Dossier de Code src/<NomDuSujet>/
Structure de dossier standard :
src/<NomDuSujet>/
├── <NomDuSujet>.tsx # Composition principale regroupant les Series.Sequence
├── types.ts # Schéma et Props
├── audioData.ts # Métadonnées des durées audio
└── scenes/
├── Scene1Hook.tsx
├── Scene2Problem.tsx
├── Scene3Concept1.tsx
├── Scene4Concept2.tsx
├── Scene5Impact.tsx
└── Scene6Outro.tsx
Effets sonores : utilisez <SfxTrack cues={...} /> depuis src/sfx/SfxTrack.tsx, placé dans le composant principal. Les fichiers audio se trouvent dans public/sfx/, régénérez-les avec npx tsx scripts/generate-sfx.ts.
| Quand | Son |
|---|---|
| Au début de chaque scène, 3 trames plus tôt pour tomber dans le silence avant la nouvelle phrase (scène 1 à la trame 0) | mallet |
| Apparition d'une carte ou d'un élément | pop ou tick |
| Point d'impact, conclusion | ding |
| Appel à l'action d'abonnement | chime |
- La
framede chaque cue est le nombre de trames depuis le début de la vidéo, correspondant au moment où l'élément apparaît. - Pas besoin d'éviter manuellement les chevauchements :
SfxTrackignore automatiquement les cues dont l'intervalle avec la cue précédente est inférieur à 0,4s, et réduit le volume si un son se répète immédiatement après lui-même. - Ne téléchargez pas de sons depuis myinstants ou des sites sans licence claire. Si un nouveau son est nécessaire, ajoutez-le dans
scripts/generate-sfx.ts.
Étape 4 : Enregistrer la Composition dans src/Root.tsx
Ajoutez une nouvelle Composition dans src/Root.tsx :
<Composition
id="<NomDuSujet>"
component={<NomDuSujet>}
durationInFrames={totalFrames}
fps={30}
width={1080}
height={1920}
defaultProps={{}}
/>
Étape 5 : Vérification et Rapport
- Exécutez
npm run lintpour vérifier les erreurs TypeScript/ESLint. - Rapportez à l'utilisateur le lien pour ouvrir la Composition dans Remotion Studio (
http://localhost:3000) ou la commande pour générer la vidéo MP4 :npx remotion render <NomDuSujet> out/<NomDuSujet>.mp4