Communitygithub.com

jhatpat-reel

Transformez une longue vidéo de type talking-head en un Reel Instagram ou Short YouTube percutant. Supprime les silences, garde la meilleure prise, recadre en 9:16 / 1:1 / 16:9, ajoute des sous-titres de type Instagram et exporte un EDL pour Premiere Pro. Conçu pour les créateurs Hinglish et Hindi qui filment en une prise avec un téléphone ou un reflex.

Qu'est-ce que jhatpat-reel ?

Jhatpat-reel est un outil de montage vidéo automatisé conçu pour les créateurs de contenu qui réalisent des vidéos en une seule prise de type talking-head. Il supprime automatiquement les silences et les temps morts, sélectionne la meilleure prise de chaque ligne de dialogue (y compris en Hinglish, Hindi ou anglais), recadre la vidéo aux formats 9:16, 1:1 ou 16:9, ajoute des sous-titres animés style Instagram, et exporte une EDL pour une finalisation dans Premiere Pro. L'outil fonctionne avec ffmpeg, ffprobe et Python ; il propose plusieurs presets de coupe (reel, calm, tight) et gère les retakes à l'aide d'un fichier SRT généré par un outil de STT externe. Conçu pour être un assistant fiable, il applique automatiquement les règles de qualité (vérification du premier plan, de la respiration, du niveau audio) et peut être personnalisé via un fichier de configuration. Il est particulièrement adapté à Instagram Reels, YouTube Shorts et à tout premier montage rapide d'une vidéo à un seul intervenant.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ankurrattan0110-spec/jhatpat-reel/tree/HEAD

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait jhatpat-reel ?

Seedhi baat: un long plan, un Reel bien serré en retour. Le premier jet est fait par la machine, à toi d’y mettre le goût.

Cette compétence est un éditeur de premier jet, pas un éditeur final. Le script supprime les silences et les temps morts ; les reprises et les hésitations, c’est toi (ou Claude en lisant la transcription) qui les indiques. Les rushes bruts ne sont jamais modifiés.

Quand l’utiliser

  • Un intervenant, une prise, avec un téléphone ou un reflex — talking-head.
  • Instagram Reel, YouTube Short, ou les deux à partir d’une seule prise.
  • Hinglish, Hindi ou anglais — les trois fonctionnent.

À éviter : interview multi-caméra, clip musical, ou montage où chaque coupe demande du goût. Pour cela, ouvre toi-même la timeline.

Ce qu’il faut

ÉlémentPourquoiVérification
ffmpeg + ffprobecouper, recadrer, sous-titresffmpeg -version
python3 3.9+les trois scriptspython3 --version
transcription (optionnelle)pour repérer les repriseswhisper / whisperx / tout STT
police Devanagari (optionnelle)sous-titres HindiNoto Sans Devanagari

Pipeline

La sortie de chaque étape est consommée par l’étape suivante. Fais une pause pour montrer le résultat, puis continue.

Étape 0 — observe, puis coupe

Analyse la vidéo. Indique au créateur en une ligne : la durée, la résolution, les fps, sur quel canal est l’audio. Si la vidéo est déjà en vertical, le recadrage peut être ignoré. Si l’audio n’est que sur un seul canal (problème courant avec les micros sans fil), corrige-le d’abord, sinon la moitié du Reel n’aura pas de son après la coupe.

Si une transcription peut être obtenue, prends-la maintenant. Sans transcription, cette compétence ne peut que supprimer les silences ; elle ne peut pas détecter les reprises ni les hésitations. Dis-le clairement au créateur.

Étape 1 — coupe brute

python3 scripts/rough_cut.py take.mp4 --preset reel

Presets : reel (par défaut, serré), calm (poésie, histoire, longue conversation), tight (accroche fort, rapide).

Cela produit trois fichiers : cuts.json, <name>_cut.mp4, <name>.edl.

Si une transcription est disponible, lis cuts.json et supprime les parties avec reprises : si la même ligne a été dite deux ou trois fois, garde la dernière version claire, supprime les autres. Les « désolé », « encore une fois », « euh » — tout cela disparaît. Ensuite, rends à nouveau. Ne modifie pas cuts.json à la main — change le preset ou la configuration et relance le script.

Étape 2 — écoute la coupe pour vérifier

Il est indispensable d’écouter 0,2 s de chaque côté de chaque coupe. Si un mot est coupé au milieu, augmente --pre-pad / --post-pad. La transcription peut sembler correcte alors que l’audio est coupé.

Étape 3 — recadrage

python3 scripts/reframe.py take_cut.mp4 --all        # 9:16 + 1:1 + 16:9
python3 scripts/reframe.py take_cut.mp4 --to 9:16 --anchor 0.3

--anchor détermine d’où le cadre est coupé. Pour un talking-head, le visage est en haut, donc la valeur par défaut est 0.35. Si le visage est coupé, réduis l’ancrage. Pour un enregistrement d’écran, utilise --mode pad — le rognage couperait le texte.

Étape 4 — sous-titres

python3 scripts/burn_captions.py take_cut_9x16.mp4 take.srt --style pop --accent "#C6FF3D"

Styles : pop (1-3 grands mots au milieu — pour les Reels et les accroches), box (boîte pleine, lisible même sur une vidéo chargée), bar (fine ligne en bas, pour les longs formats).

Le script divise lui-même les longues répliques en petits morceaux, pour que le style pop ait du sens. Pour les sous-titres Hindi, donne le chemin de la police Devanagari avec --font — sinon la moitié des caractères ne s’afficheront pas.

Étape 5 — dernier regard

Avant l’export, vérifie toi-même ton travail avec cette liste :

  1. La première seconde. Quelque chose doit se passer dans la première image — visage, grand mot, ou mouvement. Image vide = scroll.
  2. Aucun mot coupé. Écoute trois coupes au hasard.
  3. Les sous-titres ne cachent pas le visage. En 9:16, pop apparaît au milieu ; si le visage est au centre, mieux vaut --style box.
  4. Les 2 dernières secondes. Le CTA doit être visible et s’arrêter, pas filer.
  5. Le son. Instagram et YouTube normalisent tous les deux à -14 LUFS. Si tu laisses un son trop bas, ils le remonteront et ça sonnera mal :
    ffmpeg -i final.mp4 -af loudnorm=I=-14:TP=-1.5:LRA=11 -c:v copy out.mp4
    

Règles (chaque règle avec sa raison)

  • Ne touche jamais aux rushes bruts. Tout se fait dans un nouveau fichier. Parce qu’ un mauvais rendu et la prise est perdue.
  • Pas de zoom au moment de la coupe. Parce que le zoom annonce la coupe et la rend visible.
  • Un Reel, une idée. Une autre idée, un autre Reel. Parce que deux idées ensemble, les deux sont oubliées.
  • Ne supprime pas toutes les pauses. Ne descends pas pause_keep en dessous de 0,2 s. Parce que des mots complètement collés sonnent robotiques, et il faut de l’espace pour respirer.
  • Rien d’autre avant l’accroche. Si les 3 premières secondes ne sont pas bonnes, le reste du montage est inutile. Parce que c’est là que les gens défilent.
  • Ne remets pas ce que le créateur a enlevé à la main. Avant de rendre à nouveau, lis leur version.
  • Ne prétends pas gérer les reprises sans transcription. Dis clairement : « j’ai enlevé les silences, à toi de vérifier les reprises. »

Configuration

Copie config.example.json dans config.json, puis utilise --config config.json. Chaque valeur est expliquée dans le fichier.

Ce que cette compétence ne fait pas

  • Elle ne filme pas. Le tournage est le tien.
  • Elle ne poste pas sur Instagram.
  • Elle ne télécharge ni ne copie la vidéo de quelqu’un d’autre.
  • Elle ne choisit pas la musique — la licence est de ta responsabilité.
  • Elle ne génère pas de transcription ; tu utilises un STT et fournis le SRT.

Intègre les retours dans la compétence

Quand le créateur dit « la coupe est trop saccadée » ou « le sous-titre cache le visage » — corrige-le et écris cette note ici comme règle, avec sa raison. Après deux ou trois Reels, cette compétence s’adaptera à ton goût.

Skills associés