Éditeur de reel style paper cut
Yanni est un créateur spécialisé dans la nutrition, les peptides et la physiologie. Il se filme en train de parler. Cette compétence transforme la prise brute en un reel fini 1080×1920 dans le style de la référence qu'il a choisie (un explainer de pharmacologie) : son visage à l'écran, entrecoupé de scènes « explainer » en papier froissé, avec des sous-titres sur tout.
L'utilisateur utilise à peine Claude. Faites tout le travail vous-même, gardez les messages courts et simples, et n'arrêtez que pour demander quelque chose dont vous avez vraiment besoin (un lien d'étude, une vidéo manquante). Ne montrez jamais de JSON brut ou de longs logs à l'utilisateur.
Lisez references/style.md une fois avant votre premier plan. C'est la bible de style mesurée ; ce fichier est la procédure.
E ci-dessous signifie <répertoire de base de cette compétence>/engine.
0. Prévol
~/.yanni-editor/brand.jsonmanquant, ouffmpeg/whisper-cli/nodemanquant : exécutez d'abord la compétence setup, puis revenez.- Trouvez la vidéo. S'il a glissé un fichier, le chemin est dans son message. Sinon, demandez une fois : « Glissez le fichier vidéo dans cette fenêtre et appuyez sur Entrée. »
- Dossier du projet :
<projectsDir depuis brand.json>/<sujet-en-kebab-case>(par exemple~/Movies/Yanni Edits/bpc-157-healing). Choisissez le slug après que la transcription vous a indiqué le sujet ; utilisezuntitled-<date>jusque-là et renommez après.
1. Préparation et transcription
node "$E/prep.mjs" "<vidéo brute>" "<projet>"
Normalise en 1080×1920 30fps à -16 LUFS et écrit build/raw.transcript.txt (phrases avec timestamps). Lisez ce fichier.
2. Coupe des prises (et mauvaises prises)
Cherchez les reprises : une même phrase dite deux fois, un faux départ, « attends je recommence ». Gardez la DERNIÈRE prise, supprimez les précédentes par plage temporelle brute. Supprimez aussi les déchets évidents au début et à la fin (il attrape son téléphone).
node "$E/cut.mjs" "<projet>" --remove "3.10-7.85,40.2-44.0"
# pas de reprises : node "$E/cut.mjs" "<projet>"
Les silences sont coupés dans l'audio lui-même (tout ce qui est plus silencieux que -35 dB pendant 0,3 s ou plus). S'il semble pressé, utilisez --gap 0,45 ; si la pièce est bruyante et que rien n'est coupé, essayez --db -30. Sortie : build/head.mp4 et build/transcript.txt en temps coupé. Tous les temps de beat à partir d'ici sont des temps coupés.
Lisez build/transcript.txt. Whisper se trompe sur les noms ; écrivez les corrections dans replace dans edit.json (une correspondance mot à mot, insensible à la casse), par exemple {"BPC157": "BPC-157", "tren": "Tren"}.
3. Planifier les beats (écrivez avant de toucher aux assets)
Écrivez build/plan.md : une ligne par beat avec la plage temporelle coupée, la ligne parlée, FACE ou PAPER, et pour le papier ce qui est à l'écran. Règles issues de la référence :
- Ouvrir sur PAPER. Les 2 à 4 premières secondes sont une scène papier avec une étiquette d'en-tête noire nommant le sujet et l'objet principal tombant. C'est l'accroche.
- Le premier beat FACE porte le tampon de nom (
"stamp": 0.2). - Alterner. Jamais deux beats papier dos à dos sans un beat face entre eux, sauf si la pensée parlée continue clairement (dans ce cas, faites un seul beat papier avec plusieurs plans). Les beats papier durent 2 à 5 s, les beats face 1,5 à 5 s. Visez 45 à 55 % du temps d'exécution pour le papier. build.mjs affiche
paperShare. - Ce qui va sur le papier : le moment où il nomme un composé, un aliment, un complément, une partie du corps ou une étude ; dit un nombre ; décrit un mécanisme. Ce qui reste sur le visage : opinions, avertissements, conclusions, blagues, l'appel à l'action. Le visage est la confiance ; le papier est la preuve.
- À l'intérieur d'un beat papier, le plan change toutes les 1,2 à 2,5 s.
whipvers la page d'étude suivante,pushpour ajouter la statistique ou le chiffre sous la carte actuelle,zoompour échanger les objets. Un beat papier avec un seul plan statique pendant 4 s est mort. - Longue séquence face (plus de ~4 s avec un jump cut à l'intérieur) : divisez-la en deux beats face et donnez au second
"zoom": 1.12(un zoom avant cache la coupe).
4. Rassembler les visuels
Mettez tout dans build/assets/. Écrivez build/assets/credits.txt avec la source de chaque image (find_images imprime la licence et la page).
Objets découpés (flacon, seringue, poitrine de poulet, œuf, haltère, cerveau, foie) :
node "$E/find_images.mjs" "seringue" "<projet>/build/cand" --n 6
# REGARDEZ les candidats (lisez-les), choisissez l'objet le plus net sur un fond uni
node "$E/cutout.mjs" "<projet>/build/cand/seringue-2.jpg" "<projet>/build/assets/seringue.png"
Ensuite, REGARDEZ le découpage. La suppression du fond échoue sur le verre, le plastique transparent et les arrière-plans chargés. Si ça a échoué, essayez un autre candidat, ou utilisez la photo comme card au lieu d'un cutout. L'anatomie se lit mieux en gravures anciennes : cherchez « Gray's anatomy » et utilisez "mono": true pour le look en niveaux de gris de la référence. S'il a ses propres photos de produits, préférez-les.
Pages d'étude (l'épine dorsale de ce style) :
- Uniquement des études RÉELLES. Demandez-lui le lien s'il en cite une et que vous ne pouvez pas la trouver avec certitude. N'inventez jamais une étude, une page de revue, une figure ou un nombre. Des allégations de santé sur une fausse capture d'écran peuvent nuire à des personnes et à son compte.
- Capture via Europe PMC (PubMed bloque les navigateurs headless) :
REGARDEZ-la. Puis recadrez la partie dont il parle : le bloc de titre pour « une étude de 2017 d'Oslo... », la phrase de résultats exacte ou la figure pour l'affirmation :node "$E/webshot.mjs" "https://europepmc.org/article/MED/<PMID>" "<projet>/build/cand/study.png"La capture est en 2x, donc les recadrages sont nets. Gardez les cartes lisibles : recadrez serré, une carte fait au plus ~820 px de large à l'écran.ffmpeg -v error -y -i study.png -vf "crop=W:H:X:Y" -frames:v 1 "<projet>/build/assets/study-title.png" - Les pages de revues (ScienceDirect, Wiley) bloquent souvent aussi. Si la capture est un captcha ou blanche, demandez-lui de faire une capture d'écran sur son Mac (Cmd+Maj+4) et de déposer le fichier.
Chiffres statistiques (stat) : uniquement les nombres qu'il dit à voix haute, mot pour mot.
5. Écrire build/edit.json et construire
Format complet et toutes les options : references/edit-json.md. Forme minimale :
{
"title": "bpc-157 healing",
"video": "head.mp4",
"transcript": "transcript.json",
"replace": { "bpc157": "BPC-157" },
"beats": [
{ "type": "paper", "start": 0, "end": 3.2, "header": "Est-ce que BPC-157 guérit les tendons ?",
"shots": [
{ "at": 0, "enter": "drop", "items": [ { "kind": "cutout", "src": "assets/vial.png", "label": "BPC-157" } ] },
{ "at": 1.6, "enter": "zoom", "items": [ { "kind": "cutout", "src": "assets/tendon.png", "mono": true } ] }
] },
{ "type": "face", "start": 3.2, "end": 6.4, "stamp": 0.2 },
{ "type": "paper", "start": 6.4, "end": 10.1,
"shots": [
{ "at": 0, "enter": "cut", "items": [ { "kind": "card", "src": "assets/study-title.png" } ] },
{ "at": 1.8, "enter": "push", "items": [ { "kind": "stat", "text": "40 rats", "enter": "pop" } ] },
{ "at": 2.7, "enter": "whip", "items": [ { "kind": "card", "src": "assets/study-result.png" } ] }
] }
]
}
Tout ce qui n'est pas couvert par un beat papier affiche son visage. Ensuite :
node "$E/build.mjs" "<projet>/build/edit.json"
cd "<projet>/build" && npx -y hyperframes@latest check
check doit dire Check passed. Les avertissements concernant les sous-compositions, la densité des pistes et les images en double sont attendus pour ce format ; les erreurs ne le sont pas.
6. Regarder avant de lui montrer
cd "<projet>/build" && npx -y hyperframes@latest snapshot --at <un temps dans chaque beat>
Lisez snapshots/contact-sheet-*.jpg. Vérifiez : chaque beat papier a quelque chose dessus, rien ne chevauche les sous-titres, les cartes sont lisibles, les découpages ont des bords nets, le tampon est sur son premier beat face, les sous-titres sont correctement orthographiés. Corrigez et reconstruisez jusqu'à ce que ce soit bon. Il ne devrait jamais être celui qui trouve une image cassée.
7. Prévisualisation et rendu
Rendez un brouillon pour qu'il puisse le regarder sur son téléphone ou Mac :
cd "<projet>/build" && npx -y hyperframes@latest render --quality draft --output "../out/<slug>-draft.mp4"
open "<projet>/out"
Dites-lui en deux lignes : où se trouve le fichier, et « dites-moi tout ce que vous voulez changer, comme 'agrandir l'étude à 0:12' ou 'plus de visage au milieu'. »
Pour les modifications : éditez build/edit.json, reconstruisez, vérifiez, faites un snapshot, rendez à nouveau. Pour la version finale :
npx -y hyperframes@latest render --quality high --output "../out/<slug>.mp4"
Vérifiez que le fichier existe, se lit, et que sa durée correspond à build/head.mp4 (ffprobe -v error -show_entries format=duration -of csv=p=0 <fichier>). Au-delà de ~60 Mo, re-encodez pour le téléchargement :
ffmpeg -i in.mp4 -c:v libx264 -crf 21 -preset slow -c:a copy out.mp4.
S'il veut modifier des choses à la main, npx -y hyperframes@latest preview dans le dossier build ouvre HyperFrames Studio dans le navigateur avec toute la timeline.
Règles strictes
- Ne jamais fabriquer de preuves. Pas d'études, chiffres, figures, citations ou images avant/après inventés. Si l'audio prétend quelque chose que vous ne pouvez pas sourcer, gardez cette ligne sur son visage et dites-lui quelle ligne nécessite une source.
- Les sous-titres correspondent à ce qu'il a DIT, pas à ce que le script disait. Corrigez uniquement l'orthographe.
- Une seule couleur d'accent, depuis brand.json. Texte statistique rouge, ligne de tampon rouge, rien d'autre coloré sauf les images elles-mêmes.
- Ne pas restyler le système par vidéo. Les polices, le papier, l'apparence des sous-titres et le mouvement vivent dans
engine/runtime/. Une vidéo reçoit son propre edit.json, jamais son propre CSS. S'il demande un changement de style global, modifiez le runtime une fois. - Le timing est en temps coupé, depuis
build/transcript.txt, jamais en temps brut.