Reel à partir d'une vidéo brute
Validé sur deux reels : Linux Day 2 et Linux Day 1 (avec effets sonores). library/Reel.tsx est le reel du Jour 1. Recopiez ses motifs. N'inventez pas un nouveau style.
Fonctionne sur macOS et sur Linux / Windows WSL. Installation : voir README.md dans le dépôt.
Règles strictes
- Chaque superposition est synchronisée à partir des secondes de
work/words.txt. Ne devinez jamais un timing. - Utilisez uniquement les composants de
src/(bibliothèque). N'ajoutez un nouveau composant que si aucun composant existant ne correspond à un beat. - Gardez le visage dégagé. Zones de sécurité (1080x1920) :
- Étiquettes et titres en haut : y de 90 à 400.
- Visage et cou : y d'environ 450 à 1350. Rien ici à l'exception des cartes de titre plein écran (3 s max).
- Tout le reste se place sous le cou (le premier bouton de la chemise) : y de 1360 à 1880.
Panelcommence àBELOW_NECK(1360). Utilisezfitpour redimensionner un panneau haut afin qu'il se termine à 1880. - Trouvez la ligne du cou pour chaque nouvelle vidéo : capturez une image avec une grille y et observez. Mettez à jour
BELOW_NECKdansui.tsx.
- Ne lancez pas le rendu de la vidéo complète sauf si l'utilisateur le demande dans le chat. Utilisez
scripts/stills.shpour vérifier. Un hook bloqueremotion rendersansRENDER_OK=1. - Ne téléchargez rien (modèles, polices, musique, packs sonores) sans demander à l'utilisateur.
- Lisez
reference/known-problems.mdavant de déboguer quoi que ce soit. - Dans OpenCode, le plugin
~/.config/opencode/plugins/reel-from-raweffectue le même travail que les hooks Claude (blocage du rendu, vérification de type, rappel d'instantanés). Ouvrez les images des feuilles avec l'outil de lecture. Si votre modèle ne peut pas voir les images, demandez à l'utilisateur de vérifier les feuilles.
Règles de périmètre (suivre exactement)
- Ne faites que ce que l'utilisateur a demandé. Modifiez uniquement les fichiers et valeurs nécessaires à la demande.
- Une vérification (vérification de type, vérification d'instantanés, rappel d'un hook ou plugin) est uniquement une vérification. Corrigez uniquement ce qui enfreint une règle de ce fichier ou de
reference/style-spec.md. Ne refaites jamais le style, n'ajoutez pas un composant, n'ajoutez pas une scène, et ne modifiez pas le texte, le timing ou le volume à cause d'une vérification. - Si vous pensez que quelque chose d'autre devrait changer, dites-le à l'utilisateur en une ligne. Ne le modifiez pas.
- Ne modifiez jamais
~/.claude/skills/reel-from-raw/(ce skill) pendant que vous travaillez sur une vidéo. Modifiez uniquement le projet vidéo. - Un fichier de test que vous créez (par exemple
src/__probe.ts) doit être supprimé avant de terminer.
Flux de travail (nouvelle vidéo)
Exécutez chaque étape. Chaque script affiche OK: en cas de succès. Arrêtez-vous et corrigez en cas d'ERROR.
| # | Étape | Commande / action |
|---|---|---|
| 1 | Créer le projet | bash ~/.claude/skills/reel-from-raw/scripts/new-project.sh <dir> <raw.mp4> (par exemple ~/Coding/motion-videos/<nom>). Il copie la bibliothèque, les fichiers sonores et les hooks, et installe les paquets npm (ou les clone depuis $REEL_SEED). |
| 2 | Transcrire | bash ~/.claude/skills/reel-from-raw/scripts/transcribe.sh <dir> hi (utilisez en pour l'anglais uniquement). Corrigez ensuite les erreurs de compréhension avec reference/glossary.md. |
| 3 | Couper les silences | python3 ~/.claude/skills/reel-from-raw/scripts/cuts.py <dir>. Utilisez --start/--end pour supprimer un faux départ ou une fin. |
| 4 | Feuille de beats | Suivez reference/beat-sheet-prompt.md. Écrivez work/beats.md. Montrez-la à l'utilisateur s'il souhaite approuver le plan. |
| 5 | Construire | src/Reel.tsx est le reel du Jour 1. Réécrivez-le à partir de la feuille de beats. Dans Root.tsx, définissez id (par exemple LinuxDay3) et le vrai handle. Supprimez les composants de scène que le reel n'utilise pas. Gardez les assistants At et r(). |
| 6 | Vérification de type | Automatique : un hook exécute tsc --noEmit après chaque modification. Corrigez chaque erreur signalée. |
| 7 | Vérification visuelle | bash ~/.claude/skills/reel-from-raw/scripts/stills.sh <dir> auto, puis lisez chaque out/stills/sheet*.jpg. Vérifiez également les images des beats : stills.sh <dir> 120,450,.... Vérifiez par rapport à reference/style-spec.md. Corrigez et répétez. |
| 8 | Vérification sonore | Les effets sonores accompagnent les composants (voir « Effets sonores »). Vérifiez que public/sfx/typing.wav et public/sfx/pop.wav existent. N'ajoutez pas de sons en dehors du tableau sauf si l'utilisateur le demande. |
| 9 | Prévisualisation | Ajoutez une entrée launch.json exécutant npx remotion studio --no-open --port <libre> dans le projet. Donnez à l'utilisateur l'URL http://localhost:<port>. L'utilisateur écoute les sons ici. |
| 10 | Rendu (uniquement sur demande) | RENDER_OK=1 npx remotion render <Id> out/<nom>.mp4 --gl=angle (exécutez en arrière-plan, environ 3-5 min pour 90 s). |
Effets sonores
src/sfx.tsx contient tous les sons. SFX liste les sons. <Sfx src at volume frames name> joue un son at images dans la séquence en cours.
Clé dans SFX | Source | Internet nécessaire |
|---|---|---|
whoosh, ding, click, switch, whip | @remotion/sfx (fichiers sur remotion.media) | Oui, pour Studio et le rendu |
pop | public/sfx/pop.wav (créé par code) | Non |
typing | public/sfx/typing.wav (créé par scripts/make-typing-sound.py) | Non |
Les composants de la bibliothèque jouent déjà ces sons. Vous ne les ajoutez pas manuellement.
| Moment | Fichier (dans le projet) | Son | Volume |
|---|---|---|---|
| Titre d'accroche / sous-puce | scenes/Intro.tsx (Hook) | whoosh / whip | 0.54 / 0.48 |
| Carte de titre du jour | scenes/Intro.tsx (DayTitle) | whoosh / ding | 0.6 / 0.36 |
| Puces de liste de commandes | scenes/Intro.tsx (CommandList) | pop par puce | 0.36 |
| Balise de commande / nom de commande | scenes/Commands.tsx (CommandTag) | whoosh / switch | 0.54 / 0.48 |
| Lignes de bloc-notes | scenes/Commands.tsx (NoteCard) | typing par ligne | 0.6 |
| Panneau inférieur apparaît | ui.tsx (Panel) | pop | 0.48 |
| Commande de terminal tapée | ui.tsx (Terminal) | typing pour chaque ligne de commande | 0.6 |
| Fuite de lumière | Reel.tsx | whoosh | 0.48 |
| Badge Terminé / Clic de suivi | scenes/Outro.tsx (DayDone, FollowCard) | ding / click | 0.48 / 0.72 |
Tout <Sfx> sans volume | sfx.tsx (valeur par défaut) | - | 0.42 |
Le volume va de 0 (silencieux) à 1 (plein). Gardez chaque son en dessous de la voix.
Demandes courantes (recette exacte)
| L'utilisateur demande | Faites exactement ceci |
|---|---|
| « Augmenter / diminuer tous les effets sonores de N% » | Multipliez chaque volume={x} sur une ligne <Sfx, et la valeur par défaut dans sfx.tsx, par (1 ± N/100). Arrondissez à 2 décimales. Ne touchez pas à CutVideo.tsx (c'est la voix). Exécutez grep -rn "<Sfx" src avant et après, et montrez les valeurs modifiées. |
| « Changer uniquement le volume du clavier / de la frappe » | Modifiez uniquement les lignes avec src={SFX.typing} (ui.tsx Terminal et scenes/Commands.tsx NoteCard). |
| « Changer uniquement le son X » | Trouvez sa ligne dans le tableau ci-dessus. Modifiez uniquement ce volume. |
| « Le son du clavier est faible / créez-en un nouveau » | python3 ~/.claude/skills/reel-from-raw/scripts/make-typing-sound.py <projet>/public/sfx/typing.wav. Gardez d'abord une copie de l'ancien fichier. Modifiez les nombres dans le script uniquement si l'utilisateur demande une sensation différente. |
| « Supprimer un son » | Supprimez cette ligne <Sfx .../>. |
| « Où puis-je l'entendre avant le rendu ? » | Studio (étape 9). Appuyez sur Lecture ou Espace. Studio se recharge automatiquement après chaque modification sauvegardée. |
| « Comment faire le rendu moi-même ? » | Terminal : cd <projet> && npx remotion render <Id> out/<nom>.mp4 --gl=angle. Interface Studio : bouton Rendu (extrémité droite de la barre au-dessus de la timeline) → onglet Vidéo → définir le Nom de sortie → Rendre la vidéo. La progression s'affiche dans l'onglet Travaux. Le paramètre OpenGL est déjà angle. |
| « Faire le rendu » | Étape 10, avec RENDER_OK=1. Donnez ensuite le chemin complet du fichier de sortie. |
| « Changer le handle » | Root.tsx defaultProps.handle. |
Comment fonctionne le timing
src/timeline.ts:CUTS(secondes brutes supprimées),out(sec)mappe une seconde brute à une image de sortie.<At from={rawSec} to={rawSec} name="...">affiche un bloc pour cette plage parlée.r(t0, t)donne un délai en images à l'intérieur d'un bloc, pour « faire apparaître ceci quand le mot à t est dit ».CutVideoalterne le zoom 1.0 / 1.14 par segment (punch-in sur chaque coupure). N'ajoutez pas plus de zoom.
Plan de la bibliothèque
| Fichier | Exportations | Utilisation pour |
|---|---|---|
theme.ts | DISPLAY (Anton), SANS (Inter), MONO, couleurs C, extrude() | Tout le texte et les couleurs. Pas de nouvelles polices ou couleurs. |
sfx.tsx | SFX, Sfx | Effets sonores (voir ci-dessus) |
ui.tsx | Pop, useIn, useOut, BELOW_NECK, Panel, TermFrame, Terminal | Apparition élastique, panneau moitié inférieure, terminal tapé |
scenes/Intro.tsx | Hook({title, sub, subAt}), DailyStep({children}), DayTitle({day}), CommandList({commands, line, lineAt}), LightLeak | Ouverture, transitions de sections |
scenes/Commands.tsx | CommandTag({n, total, name, nameAt, meaning, meaningAt, color}), FolderPath, FileGrid, MoveSwap, NoteCard | Un sujet par section : balise en haut, visuel dans Panel |
scenes/Commands.tsx (Jour 2, texte codé en dur) | IdCard, OwnerSwap, PhoneApps, Snapshot, TopView, PdfSearch | Ajoutez des props pour le texte avant de les réutiliser |
scenes/Outro.tsx | DayDone({day}), NextDay({day, commands, at}), FollowCard({handle}) | Fin (NextDay est facultatif) |
Reel.tsx | Reel | Reel complet du Jour 1. Utilisez-le comme exemple pour la structure. |
Conservez les tailles, couleurs et animations lorsque vous modifiez le texte.