Jenesyx/reel-split

Reel — Montage en écran partagé (panneau 45 % au-dessus de l'intervenant)

Un panneau permanent de couleur crème remplit la partie supérieure de l'image (1080 × split.panel_height, par défaut 864 = 45 %) avec des widgets de style UI — cartes, jauges, interrupteurs, terminaux, pastilles — qui illustrent exactement ce qui est dit. L'intervenant se trouve en dessous à l'échelle 1 et ne bouge jamais. Fin : le mot-clé de commentaire en grand à l'écran, puis une carte d'abonnement. Exemple concret : examples/split/ (plan + module de scènes d'une vraie vidéo de 100 s sur cinq compétences Claude).

Arguments : $ARGUMENTS

Valeurs par défaut (ne modifier que si l'utilisateur le demande)

Lire reel.config.json d'abord (sinon reel.config.example.json).

Élément	Valeur par défaut
Split	"split": split.panel_height (864 → panneau 45 %, intervenant 55 % ; 960 = 50/50)
Intervenant	échelle 1, pas de zoom, pas de mouvement ; visage centré dans la zone intervenant (speaker_y)
Zone de sécurité	"safe": split.safe = [64, 160, 64, 32] → le contenu de la scène se trouve dans 952 × 672 à partir de 160 px vers le bas (l'en-tête Instagram / la barre de statut du téléphone cachent le haut)
Sous-titres / Effets sonores / Musique	Aucun ajouté. Audio = le mix original de la prise, remuxé par finish.py
Prise	Supposer déjà coupée, étalonnée, musique ajoutée → utiliser telle quelle. Brute/non coupée → demander d'abord
CTA	Mot-clé de commentaire (mot ou chiffre) énorme dans une carte bulle de parole ; carte d'abonnement "handle": creator.handle, texte uniquement, jamais de recadrage du visage
Palette	split_palette : panneau crème, texte encre, remplis accent ; texte sur crème utilise accent_deep (contraste)

Entrées

Le nom de la prise et le sujet proviennent des arguments. Demander une fois, en un seul message, uniquement ce qui manque : la prise est-elle déjà coupée/étalonnée/avec musique ; le mot-clé de commentaire ; les noms ou le jargon que Whisper pourrait mal entendre (noms d'outils et de produits).

Pipeline

PY = .venv/Scripts/python.exe -X utf8 (Windows) ou .venv/bin/python -X utf8 (macOS/Linux). Les étapes longues en arrière-plan.

#	Étape	Commande / action	Vérification
1	Regarder	ffprobe ; planche contact ffmpeg -i raw/<take> -vf fps=1/5,scale=216:384,tile=9x2 -frames:v 1 work/<take>/sheet.jpg et la regarder	mur vide au-dessus de la tête ? déjà monté ?
2	Transcrire	$PY tools/transcribe.py <take> --prompt "<noms, jargon>"	relire les noms d'outils ; lacunes > 3 s → retranscrire la fenêtre
3	Visage	$PY tools/face_track.py <take> --split <panel_height>	affiche speaker_y
4	Plan des battements	une scène par idée, typiquement 3–7 s, chaque widget lié à un mot prononcé (cue = début du mot). Les scènes changent le contenu, jamais la disposition
5	Fichier de plan	work/<take>/showcase.json depuis examples/split/showcase.json : video ("../../raw/<file>"), split, speaker_y, safe, scenes_module, scenes[] {kind, start, end, cue{...}}, handle sur la scène d'abonnement ; _note enregistre les numéros de visage
6	Scènes	tools/scenes_<slug>.py depuis examples/split/scenes_5skills.py : une sc_<kind>(i, s) -> (html, js) par type, dictionnaire RENDER, CSS/JS optionnel. Coordonnées dans la zone de sécurité (952 de large) ; ids s{i}-* ; temps de cue absolus. sc_comment, sc_follow sont le CTA
7	Construction	$PY tools/showcase_build.py <take> ; dans work/<take>/sc : npx hyperframes lint public → 0 erreurs ; npx hyperframes snapshot public -o ../snaps --no-end --describe false --at <milieu de chaque scène> ; lire les planches, corriger	texte à l'intérieur du panneau, rien sous l'en-tête
8	Rendu rapide	$PY tools/finish.py <take> --seconds 12 ; lire work/<take>/sc/quick_sheet.jpg
9	Rendu complet	$PY tools/finish.py <take> (arrière-plan) → final/<take>/, vérifier, qa/sheet.jpg	lire la planche
10	Rapport	chemin, durée, scènes, résultat de vérification. Si quelque chose de nouveau a été appris, l'ajouter à cette compétence

Règles du panneau

• Les widgets illustrent la phrase prononcée à l'instant : une carte de dépôt quand ils nomment le dépôt, une jauge quand ils comparent, un barré quand ils disent « pas ça ».
• Chaque scène s'estompe 0,25 s avant la suivante (le constructeur le fait) ; à l'intérieur d'une scène, les éléments arrivent sur leurs mots de cue.
• Les nombres à l'écran doivent être des comptes réels de la prise.
• Les types de scènes intégrés dans showcase_build.py (hook, repo, cta, …) sont antérieurs à la zone de sécurité 45 % et peuvent la dépasser ; écrire les types dans tools/scenes_<slug>.py en vous basant sur examples/split/scenes_5skills.py à la place.
• Texte en farsi / arabe : classe .fa (RTL sur l'élément, jamais dir="rtl" sur <html>), letter-spacing: 0, chiffres via fa(), un grand zéro en latin 0.
• Pas de chevauchement de tweens sur une propriété, pas de Math.random / from:"random", les entrées glissées comportent autoAlpha:0 dans l'état de départ.
• Si un clip source est HDR (HLG), le mappage de tonalité d'abord (TONEMAP dans tools/story_assets.py) — finish.py s'arrête sur « HDR auto-promotion ».
• hyperframes snapshot n'est pas une preuve du rendu — l'étape 8 l'est.