ReelStudio : sujet entré, reel sorti
Vous êtes le producteur et l'équipe. Faites ce que vous seul pouvez faire (écriture, réalisation, codage des scènes, jugement des images) et exécutez la commande reelstudio pour ce que vous ne pouvez pas faire (voix, images, horodatages, rendu).
reelstudio <commande> # = $RS ci-dessous ; lanceur dans ~/.local/bin, exécute ~/ReelStudio/engine/bin/rs.mjs
$RS ci-dessous signifie reelstudio. Si reelstudio n'est pas dans le PATH, utilisez node ~/ReelStudio/engine/bin/rs.mjs (après la première configuration) ou node <racine du plugin>/engine/bin/rs.mjs (la racine du plugin se trouve deux dossiers au-dessus de ce SKILL.md).
Le moteur appelle OpenRouter et exécute ffmpeg et Chrome headless (Remotion), il a donc besoin d'un accès réseau et doit écrire dans ~/ReelStudio : si le bac à sable bloque une commande reelstudio, demandez des autorisations élevées pour celle-ci plutôt que de contourner le problème. Exécutez chaque commande individuellement (pas de chaînes cd … && ou de pipes). setup, frames et render peuvent prendre quelques minutes.
Tout se trouve dans ~/ReelStudio/ : reels/<nom>/, brands/*.json, looks/<id>/look.json (+ images de mascotte et de référence), .env (clé OpenRouter), config.json (remplacements de modèle optionnels). L'utilisateur peut également tout piloter depuis l'application web Codex : node <racine du plugin>/app-codex/server.mjs (http://127.0.0.1:4749 ; il exécute codex exec en tant que producteur).
0. Première fois
Exécutez $RS setup (copie le moteur, installe Remotion une fois, crée la marque default). Si elle signale qu'aucune clé OpenRouter n'est présente, la voix et les images ne peuvent pas fonctionner : arrêtez-vous et demandez à l'utilisateur de la définir lui-même (dans son propre Terminal : reelstudio key, ou OPENROUTER_API_KEY=... dans ~/ReelStudio/.env). Ne lui demandez jamais de coller la clé dans le chat. Réexécutez $RS setup après avoir mis à jour le plugin (le lanceur choisit la version de plugin installée la plus récente).
1. Brief
Obtenez le sujet (ou le script de l'utilisateur), la marque ($RS list affiche les marques et les looks), la langue et la durée cible (par défaut 25–40 s). Pour une qualité éditoriale premium (zooms fluides de la caméra sur un seul monde, police serif pour le titre, pilule rouge, cartes propres) utilisez une marque avec le look editoriale (ou cronaca pour l'histoire et les histoires vraies avec des photos réelles, marque storia) et le format zoom de l'étape 5b ; n'importe quel sujet convient. Lisez ~/ReelStudio/brands/<marque>.json et suivez son tone.
Le look est la ligne créative. Chaque marque pointe vers un look dans ~/ReelStudio/looks/<id>/look.json. Lisez-le avant d'écrire quoi que ce soit et obéissez à sa bible (règles de mise en page, utilisation de la mascotte, ce qu'il faut éviter). Ses couleurs, sa police, son style de légende et son arrière-plan sont appliqués automatiquement. Son imageStyle et ses images de référence sont ajoutés automatiquement à chaque appel rs image, donc toutes les images d'une marque partagent un seul style. Chaque reel d'une marque doit ressembler à une partie de la même série.
2. Script et storyboard
$RS new "<sujet>" --brand <marque> affiche le nom du reel. Écrivez reels/<nom>/reel.json :
{"title": "...", "brand": "default", "scenes": [
{"id": "hook", "voiceover": "...", "visual": "ce qui est à l'écran", "hold": 0.2}
]}
Règles pour le script :
- Accroche dans les 2 premières secondes : une affirmation surprenante, un nombre ou une question. Pas de "Bonjour à tous", pas de "Dans cette vidéo".
- 5 à 9 scènes, une idée chacune, 6 à 20 mots de voix off par scène. Phrases parlées courtes. Écrivez les nombres comme ils doivent être prononcés ("quatre", pas "4"), car le TTS lit exactement ce que vous écrivez.
- Les faits doivent être vrais. Si vous n'êtes pas sûr d'un nombre, omettez-le.
- Terminez par une conclusion, puis une courte scène d'appel à l'action (suivre, enregistrer, commenter un mot). L'appel à l'action obtient toujours son propre écran propre :
<EndScreen title="…" sub="…" actions={['Enregistrer', 'Suivre']} />(fond de marque opaque qui couvre le monde/les photos, mascotte si le look en a une, pilule du nom de la marque). Ne placez jamais l'appel à l'action sur des photos, un monde ou les visuels d'une autre scène. - Les
idsont des slugs courts et stables. Changer levoiceoverd'une scène ne ré-enregistre que cette scène.
Montrez le script à l'utilisateur (lignes de voix off uniquement) et attendez son accord avant de dépenser pour la voix, à moins qu'il n'ait dit d'aller directement à la fin.
3. Voix et timing
$RS voice <nom> : génère un MP3 par scène avec Gemini 3.8 Flash TTS (voix Charon : n°1 dans l'arène TTS, son italien natif) via OpenRouter, obtient les horodatages des mots à partir de la transcription Nemotron, et écrit timeline.json (images à 30 ips par scène et par mot). Les voice.instructions de la marque guident le ton et le rythme (écrivez-les dans la langue du reel, par exemple "ton documentaire, rythme soutenu"). Options : --scene id1,id2 pour refaire certaines scènes, --voice <nom> (Gemini : Charon, Kore, Puck, Aoede, Fenrir, Leda, Orus, Zephyr…), --tier eleven (ElevenLabs v4 : le plus expressif, comprend les balises [excited] [whispers] [pause], mais ses voix préfabriquées sont des anglophones), --tier native (Microsoft MAI-Voice-2.1, vraies voix it-IT Luca/Rosa, plus lent et plus ponctué), --tier budget, --local (voix macOS de brouillon robotique : uniquement lorsque l'utilisateur demande explicitement un brouillon gratuit. Ne l'utilisez jamais comme solution de repli : si voice échoue à cause du réseau ou de la clé, corrigez cela, par exemple en réexécutant la même commande avec un accès réseau, et render refuse de toute façon les scènes avec voix de brouillon). Chaque clip est poli automatiquement : le silence mort est coupé aux deux extrémités, seules les pauses de plus de 0,65 s sont raccourcies (les pauses de respiration normales restent, sinon la voix semble essoufflée), égalisation et niveau doux (--raw-voice saute cette étape) ; la prise non retouchée est conservée dans assets/vo/raw/, et voice <reel> --repolish refait le polissage sans payer pour une nouvelle prise. Le rendu amène le mix à −14 LUFS. Les scènes se succèdent avec un hold de 0,2 s ; augmentez-le pour un temps fort dramatique délibéré (0,5–0,8). Les instructions vocales reçoivent une note de rythme naturel ; définissez "pace": "free" dans la voix de la marque pour la supprimer. Avec --speed au-dessus de 1,3, même une voix calme commence à sembler essoufflée : suggérez 1,2–1,3 pour les reels riches en parole. Écrivez la voix off comme des phrases connectées qui s'enchaînent dans la scène suivante, pas comme des légendes isolées. Une marque peut épingler des voix par modèle : "voice": {"voices": {"google/gemini-3.8-flash-tts": "Kore"}}.
4. Matériel visuel : choisissez ce qui sert chaque plan
Rien n'est forcé : par plan, choisissez le matériel qui semble le meilleur et qui est honnête, et mélangez librement. Demandez la limite de l'utilisateur pour les images payantes (par défaut ≤ 4).
- Photos réelles (histoire, actualités, lieux réels, personnes, objets qui existent) :
$RS photo <nom> search "<requête en anglais, année, lieu>"liste les résultats sous licence libre de Wikimedia Commons (domaine public, CC0, CC BY/BY-SA) et écritframes/photos-sheet.png(4 par ligne, ordre de la liste) : regardez-la, choisissez, puis$RS photo <nom> get <n> <nomimg>→assets/img/<nomimg>.jpg(jusqu'à 3000 px) avec l'auteur/la licence enregistrés dansassets/credits.json. Montrez toujours le crédit (<Credit file="img/x.jpg" />, ou<Photo … credit>). Préférez les photos réelles aux images IA chaque fois que le sujet a réellement existé ; ne présentez jamais une image IA comme une photo historique. - Images IA (illustration, concepts, reconstitutions, scènes qu'aucun appareil photo n'a capturées) :
$RS image <nom> <nomimg> "<prompt>"avec la direction artistique et les références du look.--world: Nano Banana 2.1 en 4K (3072×5504, ~0,12 $) : une image assez grande pour être le monde de la caméra ou une grande impression ; reste nette jusqu'à environ 2,8× de zoom.--res 2K|4Kavec--model bytedance-seed/seedream-4.5(4K, 0,04 $, détails plus denses) ou d'autres modèles qui le supportent ;--aspect 1:1|3:4|16:9pour des impressions non verticales.- par défaut (MAI-Image-2.7, ~800 px, ~0,035 $) et
--hero(GPT Image 2.6 Sunburst, meilleurs détails, ~860 px, ~0,15–0,21 $) : uniquement pour les petites cartes ou insertions, jamais pour les zooms profonds ou les arrière-plans plein écran. --mascot,--ref img/autre.png(continuité),--no-style. Décrivez le sujet et la composition ; le look gère le style. Ajoutez toujours "composition verticale, pas de texte" (ou le bon rapport hauteur/largeur). Regardez chaque image que vous générez (ouvrez le PNG avec l'outil de visualisation d'image,view_image).
- Vectoriel (SVG/React) là où c'est plus propre que n'importe quelle image : graphiques, nombres, cartes et diagrammes, chronologies, icônes (
$RS icon <nom> <nom-lucide…>), interface utilisateur, étiquettes. Construisez-le avec soin : largeurs de trait cohérentes, uniquement la palette du look, ombres douces et dégradés, espacement généreux. Ne simulez jamais un objet ou une scène avec des formes grossières : si cela nécessite un dessin, utilisez une image IA ; si cela a existé, utilisez une photo. - Règle de résolution : à l'écran, une image ne doit jamais être affichée plus grande que sa largeur en pixels (zoom × largeur du monde ≤ largeur du PNG) ;
rs framesmontrera un flou si vous enfreignez cette règle.
5. Construire les scènes : reels/<nom>/src/Reel.tsx
Composez les composants à partir de @rs (source : ~/ReelStudio/engine/src/lib/index.tsx, lisez-le lorsque vous avez besoin de détails) :
import React from 'react';
import {Reel, Title, BigStat, Bullets, Quote, Compare, Icon, Card, CTA, ImageBG, Mascot, CoverFrame, BrandBG, ReelProps} from '@rs';
export default (p: ReelProps) => (
<Reel {...p}
scenes={{
hook: <><Title kicker="Psychologie" text="Votre cerveau *adore* les listes" /><Mascot pos="peek" /></>,
stat: <BigStat value={4} prefix="≈" label="éléments dans la *mémoire de travail*" />,
why: <Bullets title="Pourquoi ça marche" items={['Divise le problème', 'Réduit l*effort*']} />,
cta: <CTA text="Plus d'astuces sur le *cerveau*" />,
}}
backgrounds={{ hook: <ImageBG src="img/brain.png" /> }}
/>
);
// Optionnel : une image de couverture. Les animations s'affichent déjà terminées ici.
export const Cover = (p: ReelProps) => (
<CoverFrame brand={p.brand}><BrandBG /><Title text="Votre cerveau *adore* les listes" /><Mascot pos="peek" /></CoverFrame>
);
- Chaque identifiant de scène dans
reel.jsona besoin d'une entrée dansscenes.*mot*met ce mot dans la couleur d'accent. - Composants :
Title,Kicker,BigStat(comptage),Bullets(révélation chronométrée sur la scène, ouat=[images]synchronisée avec les images de mots detimeline.json),Quote,Compare(deux colonnes),Icon(gros emoji),Card(image encadrée),CTA,ImageBG(Ken Burns à fond perdu),BrandBG(l'arrière-plan du look : papier, dégradé ou uni ; c'est l'arrière-plan par défaut),Mascot(la mascotte du look :pos="peek"glisse depuis le bord droit,"corner"se place en bas à droite de la zone de contenu,"center"est un grand héros ;src="img/pose.png"utilise une pose générée). Les superpositions sont automatiques : légendes karaoké, barre de progression, nom de la marque. Désactivez-les aveccaptions={false}et des props similaires. - Le texte à l'écran complète la voix off. Ne le répétez pas mot pour mot, car les légendes le font déjà. Limitez-vous à 2–7 mots par scène.
- Les visuels personnalisés sont autorisés : écrivez vos propres composants React dans
src/avecuseF(),useScene(),useBrand(),interpolate,spring,fitFont,Stagedepuis@rs. Veillez à ce que tout soit déterministe (pas deMath.random, pas deDate). - Zones de sécurité (1080×1920) : contenu entre y=200 et y=1180, à l'intérieur de
Stage. Les légendes se situent à y≈1250–1450. Rien d'important en dessous de y=1500, où Instagram place son interface utilisateur. - Variez les mises en page : n'utilisez jamais le même composant trois scènes de suite.
5b. Le format zoom (qualité éditoriale premium)
Le moyen d'atteindre une qualité d'explication de premier ordre sur n'importe quel sujet, avec le look editoriale (explications propres) ou le look cronaca (histoire, économie, histoires vraies avec des photos réelles) : un grand monde, une seule caméra qui glisse et zoome dessus, jamais de coupe franche. Lisez la bible du look et suivez-la. Le monde peut être composé de photos réelles, d'images IA 4K et de pièces vectorielles dans n'importe quelle combinaison (étape 4).
import React from 'react';
import {Reel, ReelProps, Headline, Pill, StatCard, Badge, ChartCard, Source, Credit, Grain, At, WorldGround, WorldImage, EndScreen, CoverFrame, AbsoluteFill, useBrand, useReveal} from '@rs';
const W: [number, number] = [3240, 6300];
// Impressions disposées sur une table en papier, éloignées les unes des autres pour que la caméra voyage (photos de `rs photo`, 3000 px de large)
const P = {crowd: {x: 1050, y: 1600, w: 1600, h: 1186, r: -2}, line: {x: 2200, y: 5050, w: 1500, h: 1206, r: 1.5}};
const world = (
<>
<WorldGround w={W[0]} h={W[1]} pattern="lines" step={64} />
{Object.entries(P).map(([k, p]) => <WorldImage key={k} src={`img/${k}.jpg`} x={p.x} y={p.y} w={p.w} h={p.h} rotate={p.r} radius={6} grade="bw" />)}
{/* les étiquettes de type musée, un fil rouge entre les impressions, une image IA 4K ou des pièces SVG peuvent également vivre ici */}
</>
);
const OVER = {x: 1620, y: 3250, zoom: 0.34};
const Dim = () => { const b = useBrand(); const o = useReveal(0, 16); return <AbsoluteFill style={{background: b.colors.bg1, opacity: 0.82 * o}} />; };
export default (p: ReelProps) => (
<Reel {...p} world={world} worldSize={W} overlay={<Grain amount={0.14} />}
camera={{
hook: OVER, // vue d'ensemble de toute la table
crowd: [{x: 1050, y: 1850, zoom: 0.62}, {x: 1170, y: 1720, zoom: 0.95, at: 0.42, move: 40}], // survoler, puis plonger dans un détail
chart: {x: 1620, y: 4400, zoom: 0.42}, // reculer, atténuer le monde, montrer les données
line: {x: 2200, y: 5280, zoom: 0.64},
cta: OVER,
}}
scenes={{
hook: <Headline title={'Le Jeudi noir\nde Wall Street'} pill="−11% en quelques heures" />,
crowd: <><StatCard value={12.9} decimals={1} suffix=" mln" label="actions échangées : *un record*" y={900} w={680} delay={150} /><Credit file="img/crowd.jpg" y={1165} /></>,
chart: <><Dim /><ChartCard type="line" data={[381, 199, 294, 41]} labels={['sept 1929', '', '', 'juil 1932']} title="Dow Jones, 1929–1932" x={540} y={720} w={940} h={640} /><Badge value="−89%" label="depuis le sommet" x={540} y={1150} color="#B3261E" delay={150} /><Source text="Source : S&P Dow Jones Indices" y={1215} /></>,
line: <><StatCard value={25} suffix="%" label="chômeurs aux USA en 1933" y={880} w={720} /><Credit file="img/line.jpg" y={1170} /></>,
cta: <EndScreen title={"Histoires qui ont\nchangé l'économie"} sub="Chaque semaine une crise, expliquée" actions={['Enregistrer', 'Suivre']} />, // écran propre, jamais au-dessus du monde
}}
/>
);
export const Cover = (p: ReelProps) => (
<CoverFrame brand={p.brand} world={world} worldSize={W} shot={{x: 1050, y: 1900, zoom: 0.62}}>
<Headline title={
...
[La suite se concentre sur l'écran de fin et la configuration du rendu.]
## 6. Rendu
`$RS frames <nom>` génère les images PNG (vérifie les résolutions, avertit en cas de flou). `$RS render <nom>` produit le MP4 final. Options : `--preview` (qualité inférieure, rendu plus rapide, pour vérifier le montage), `--no-clean` (conserve les images intermédiaires). Le rendu peut prendre plusieurs minutes selon la complexité et la durée.
## 7. Publication
Le MP4 se trouve dans `reels/<nom>/out/`. L'utilisateur peut le télécharger manuellement ou utiliser un script de partage. Il n'y a pas de fonctionnalité de téléversement automatique intégrée.
---
### Conseils généraux
- **Itérez vite** : montrez le script, les images, les images clés avant de lancer un rendu complet. Utilisez `--preview` pour les tests.
- **Qualité avant quantité** : mieux vaut un reel court et percutant qu'un long et ennuyeux.
- **Respectez les marques et les looks** : ils définissent l'identité visuelle. Ne les ignorez pas.
- **Vérifiez les faits** : ne diffusez pas de fausses informations.
- **Créditez les sources** : toujours créditer les photos libres de droits selon leur licence.
- **La voix est primordiale** : une bonne voix off peut faire ou défaire un reel. Choisissez le bon modèle et les bonnes instructions.
### Dépannage
- `reelstudio` introuvable : vérifiez le PATH ou utilisez le chemin direct avec `node`.
- Pas de clé OpenRouter : exécutez `reelstudio key` ou définissez `OPENROUTER_API_KEY` dans `~/ReelStudio/.env`.
- La voix échoue : vérifiez le réseau, la clé, ou réessayez avec un modèle différent (`--tier`).
- Les images sont floues : respectez la règle de résolution (zoom × largeur du monde ≤ largeur du PNG).
- Le rendu est lent : utilisez `--preview` pour les tests, ou réduisez la durée/le nombre d'images.
### Notes techniques avancées
- Le moteur Remotion est installé une fois par `setup`, dans `~/ReelStudio/engine/`.
- Les fichiers de cache et temporaires sont dans `~/ReelStudio/tmp/`.
- Les logs sont dans `~/ReelStudio/logs/`.
- Les modèles d'IA peuvent être remplacés dans `config.json` à l'échelle du projet.
- Le format `--world` utilise un monde unique de haute résolution, idéal pour les explications détaillées.
### Bonnes pratiques pour le script
- Accroche forte dès la première seconde.
- Phrases courtes et percutantes.
- Utilisez des nombres et des statistiques pour renforcer l'impact.
- Terminez par un appel à l'action clair.
- Adaptez le ton à la marque et au sujet.
### Bonnes pratiques pour les visuels
- Photos réelles pour l'authenticité.
- Images IA pour les concepts et reconstitutions.
- Vectoriel pour les données et schémas.
- Mélangez les types de visuels pour maintenir l'intérêt.
- Ne surchargez pas les scènes ; chaque visuel doit servir un but.
### Bonnes pratiques pour la voix
- Choisissez la voix adaptée au ton du reel.
- Utilisez les instructions vocales de la marque.
- Évitez les vitesses trop élevées (`--speed` > 1.3).
- Laissez des pauses naturelles ; ne supprimez pas toutes les respirations.
- Utilisez `--repolish` si nécessaire, sans repayer.
### Exemple de flux de travail complet
1. `reelstudio setup` (première fois seulement)
2. `reelstudio new "Sujet" --brand ma_marque`
3. Écrire `reel.json` avec le script et le storyboard
4. Montrer le script à l'utilisateur, obtenir l'accord
5. `reelstudio voice mon_reel`
6. Choisir les photos/images : `rs photo ... get`, `rs image ...`
7. Écrire `Reel.tsx` avec les composants et la mise en scène
8. `reelstudio frames mon_reel --preview` (vérifier)
9. `reelstudio render mon_reel` (production)
10. Publier le MP4 depuis `reels/mon_reel/out/`