Communitygithub.com

cut-takes

Transformez un enregistrement brut face caméra en un montage brut : chaque réplique conservée une fois, dans sa dernière prise complète, avec les longues pauses réduites. Fonctionne dans toutes les langues, avec ou sans script, et exporte vers DaVinci Resolve, Premiere Pro, Final Cut Pro ou CapCut Desktop, ainsi qu'en MP4 optionnel.

Qu'est-ce que cut-takes ?

Cut Takes est un outil conçu pour les monteurs travaillant avec des rushs de type “talking head” (personne seule face caméra). Il analyse une vidéo brute contenant plusieurs prises, répétitions, faux départs et silences, puis produit un montage brut (rough cut) où chaque phrase n'apparaît qu'une fois, dans sa dernière prise complète, avec les longues pauses resserrées. L'utilisateur conserve le contrôle final : il peut consulter un fichier Markdown listant chaque segment détecté, modifier un fichier JSON pour ajuster les coupes (supprimer un souffle, un regard vers les notes, un mot coupé), puis lancer le rendu vers un fichier EDL, FCPXML, XML ou un dossier CapCut. L'outil prend en charge toutes les langues, détecte automatiquement la langue parlée, et peut s'appuyer sur un script texte optionnel pour mieux identifier les répliques. Il ne génère ni sous-titres, ni musique, ni effets : uniquement le montage brut. L'export MP4 permet une vérification finale avant import dans l'éditeur vidéo principal.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MikolajKopec/skills/tree/HEAD/skills/video/cut-takes

Demander à votre IA préférée

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

Documentation

Cut Takes

Transformez un enregistrement brut face caméra en un montage brut : chaque réplique dite une fois, dans sa dernière prise complète, avec les longues pauses réduites. Le script trouve la parole, la transcrit phrase par phrase et mesure les niveaux. C'est vous qui décidez quelles prises garder.

Script : python "${CLAUDE_SKILL_DIR}/scripts/cut_takes.py" (utilisez python3 là où python est Python 2 ou absent). Ci-dessous, il est écrit cut_takes.py.

0. Installation (une fois)

Exécutez cut_takes.py doctor. Si quelque chose manque, informez l'utilisateur et proposez la commande d'installation :

  • FFmpeg : Windows winget install Gyan.FFmpeg, macOS brew install ffmpeg, Linux sudo apt install ffmpeg.
  • Paquet Python : python -m pip install faster-whisper.
  • GPU NVIDIA optionnel : python -m pip install nvidia-cublas-cu12 "nvidia-cudnn-cu12==9.*" (environ 2 Go). Sans lui, tout tourne sur CPU, juste plus lentement.

1. Analyse

Demandez le chemin de la vidéo et, si le locuteur lisait un script, le script sous forme de texte brut (optionnel). Choisissez un dossier de travail à côté de la vidéo, par exemple <dossier_vidéo>/<nom_vidéo>-travail/.

cut_takes.py analyze VIDEO --work TRAVAIL [--script SCRIPT.txt] [--language en]
  • La langue est détectée automatiquement ; passez --language si la ligne de détection dans la sortie est erronée.
  • Sur CPU, un long enregistrement prend du temps. Pour un passage rapide, ajoutez --model small.
  • Les très gros fichiers (4K, plus de 20 minutes) fonctionnent, mais le rendu est plus rapide à partir d'une copie 1080p.

Sortie dans TRAVAIL : takes.md (lisez ceci), takes.json et un brouillon cuts.json.

2. Choisir les prises

Lisez takes.md. Chaque phrase a un identifiant, un temps source, un texte et un statut :

  • KEEP / DROP reprise dans #N - le script suppose que la dernière prise complète gagne. Vérifiez chaque supposition.

  • DROP peu clair (bruit ?) - une toux, un clic ou une respiration que Whisper a transformés en mots (« Merci. »). DROP pas dans le script - uniquement avec --script.

  • (couper avant "mot" ...) - seule la fin de la phrase a été redite plus tard ; le clip du brouillon se termine avant ce mot.

  • !! répété ... / !! faux départ ... / !! mot long ... - un bégaiement à l'intérieur d'une phrase (un mot long est souvent une répétition que Whisper a fusionnée). Vérifiez-le en transcrivant de courtes fenêtres, puis supprimez-le avec skip ou utilisez une autre prise :

    cut_takes.py transcribe VIDEO --work TRAVAIL --at 86.1 87.0 87.4 88.6
    
  • Mots du script non trouvés - des lignes qu'aucune phrase conservée ne couvre. Cherchez-les dans les phrases DROP ; si elles manquent, informez l'utilisateur.

Ensuite, modifiez cuts.json :

  • Supprimez les paroles hors caméra (« ok, encore une fois », « ça enregistre ? »), les vérifications de micro et les prises non terminées. Une prise inachevée est mieux supprimée que conservée.
  • Un commentaire fait souvent référence à la prise précédente : « n'utilisons pas ça » juste après une ligne signifie que cette ligne aussi doit disparaître.
  • Si deux prises sont également complètes, préférez celle la plus proche du script.
  • from se place dans le silence avant la prise, to dans le silence après. Conservez les clips dans l'ordre de lecture.
  • Un bégaiement dans une bonne prise : "skip": [[a, b]] avec a juste après le dernier bon mot et b juste avant la répétition propre. Utilisez les temps des mots dans takes.json pour le placer.

Optionnel : vérifiez où le locuteur regarde à la fin d'une prise (un coup d'œil aux notes ruine le montage) :

cut_takes.py frames VIDEO --at 41.2 --dur 2 --png TRAVAIL/fin.png

Regardez le PNG et terminez to avant que le regard ne quitte la caméra.

3. Rendu

cut_takes.py render TRAVAIL/cuts.json [--style natural|tight] [--mp4]
  • natural (par défaut, YouTube et formats longs) : les pauses de plus de 0,5 s sont réduites à 0,3 s.
  • tight (courts, reels) : chaque pause est coupée, et les respirations et clics labiaux entre phrases disparaissent aussi (listés comme respiration/bruit supprimé).
  • Affinez avec --max-pause et --keep-pause (secondes).
  • Ajoutez --mp4 uniquement lorsque l'utilisateur veut un fichier vidéo prêt.

Il écrit <vidéo>-cut.fcpxml, .xml, .edl, un dossier de projet CapCut <vidéo>-cut-capcut/, -segments.json (et .mp4) dans TRAVAIL et se termine par CHECK OK lorsque toutes les exportations concordent entre elles et avec le MP4. En cas de CHECK FAILED, rapportez le message et ne remettez pas les fichiers.

Avec --mp4, transcrivez le résultat une fois (cut_takes.py transcribe TRAVAIL/<vidéo>-cut.mp4 --work TRAVAIL --at 0 <longueur>) et lisez-le : chaque ligne une fois, sans répétition, aucun mot coupé en deux.

4. Remise

Indiquez à l'utilisateur la durée avant et après, le nombre de segments, les prises que vous avez supprimées et pourquoi, et tout point à écouter. Ensuite, expliquez comment importer :

ÉditeurFichierComment faire
DaVinci Resolve.fcpxml (ou .xml)Fichier > Importer > Timeline, puis choisir le fichier. Relier le média si demandé
Premiere Pro.xmlFichier > Importer, choisir le .xml ; une nouvelle séquence apparaît dans le projet
Final Cut Pro.fcpxmlFichier > Importer > XML
Autres éditeurs.edlCMX 3600 EDL, importer et relier à la vidéo source
CapCut desktopdossier -capcut/Quitter CapCut, copier tout le dossier dans le dossier des projets CapCut (ci-dessous), démarrer CapCut et ouvrir le projet depuis l'écran d'accueil

Dossier des projets CapCut : Windows %LOCALAPPDATA%\CapCut\User Data\Projects\com.lveditor.draft, macOS ~/Movies/CapCut/User Data/Projects/com.lveditor.draft, ou le chemin défini dans les paramètres de CapCut. Ne l'écrivez pas vous-même ; dites à l'utilisateur de copier le dossier. Si le projet n'apparaît pas ou ne s'ouvre pas, utilisez le .mp4 en repli.

La timeline pointe vers le fichier vidéo original, donc ne le déplacez pas et ne le renommez pas avant l'importation. Chaque coupe est une coupe franche sur une seule piste ; ajoutez des fondus enchaînés dans l'éditeur si une coupe clique.

Pour modifier quelque chose, éditez cuts.json et relancez le rendu.

Skills associés