AragornZJF/assistant-clip-video

Assistant de Montage Vidéo

Assistant de montage vidéo automatique. Utilise FFmpeg pour découper, générer des sous-titres et exporter des vidéos courtes.

Fonctionnalités principales

1. Découpage temporel — Extraire des segments à partir de timestamps
2. Découpage par mots-clés — Trouver des passages correspondant à des mots-clés via la reconnaissance vocale (ASR)
3. Superposition de sous-titres — Intégrer des sous-titres SRT dans la vidéo
4. Export pour réseaux sociaux — Recadrer aux formats 9:16 / 1:1 / 16:9
5. Extraction des moments forts — Détecter automatiquement les passages saillants dans une longue vidéo

Démarrage rapide

Découpage temporel

python3 scripts/cut_video.py --input video.mp4 --start 10 --duration 30 --output clip.mp4

Extraction de plusieurs segments

python3 scripts/cut_video.py --input video.mp4 --segments "0-30,60-90,120-150" --output ./clips/

Superposition de sous-titres

python3 scripts/burn_subtitles.py --input video.mp4 --srt subs.srt --output subtitled.mp4

Export pour réseaux sociaux

python3 scripts/export_social.py --input video.mp4 --format vertical --duration 60 --output shorts/

Description des scripts

scripts/cut_video.py

Découpe une vidéo selon une timeline.

python3 scripts/cut_video.py \
  --input <fichier_video> \
  --start <secondes> \
  --duration <secondes> \
  [--segments "0-30,60-90"] \
  --output <sortie>

scripts/burn_subtitles.py

Intègre des sous-titres SRT dans la vidéo.

python3 scripts/burn_subtitles.py \
  --input <video> \
  --srt <fichier_sous-titres> \
  --output <sortie>

Personnalisation possible de la position, taille de police et couleur des sous-titres.

scripts/export_social.py

Exporte la vidéo dans un format adapté aux réseaux sociaux.

python3 scripts/export_social.py \
  --input <video> \
  --format <vertical|square|horizontal> \
  --duration <secondes> \
  --output <dossier_sortie>

Format	Ratio	Usage
vertical	9:16	TikTok / Kuaishou / Xiaohongshu
square	1:1	Instagram
horizontal	16:9	YouTube / Bilibili

scripts/extract_highlights.py

Extrait automatiquement les moments forts d'une longue vidéo.

python3 scripts/extract_highlights.py \
  --input <video> \
  --num-clips <nombre_de_segments> \
  --min-duration <secondes_minimum> \
  --output <dossier_sortie>

Utilise un algorithme de détection de scènes pour localiser les transitions intéressantes.

scripts/generate_subtitles.py

Génère un fichier de sous-titres SRT (nécessite un service ASR).

python3 scripts/generate_subtitles.py \
  --input <video> \
  --provider <whisper|funclip> \
  --output <sous-titres.srt>

Workflows typiques

Workflow 1 : Extraire 3 moments forts d'un enregistrement de réunion

# 1. Découper 3 segments
python3 scripts/cut_video.py \
  --input meeting.mp4 \
  --segments "300-360,720-780,1200-1260" \
  --output ./clips/

# 2. Exporter chacun au format TikTok
for f in ./clips/*.mp4; do
  python3 scripts/export_social.py \
    --input "$f" \
    --format vertical \
    --output ./shorts/
done

Workflow 2 : Ajouter des sous-titres à une vidéo

# 1. Générer les sous-titres
python3 scripts/generate_subtitles.py \
  --input video.mp4 \
  --provider whisper \
  --output video.srt

# 2. Intégrer les sous-titres
python3 scripts/burn_subtitles.py \
  --input video.mp4 \
  --srt video.srt \
  --output subtitled.mp4

Workflow 3 : Créer plusieurs vidéos courtes en une commande

python3 scripts/export_social.py \
  --input long_video.mp4 \
  --format vertical \
  --duration 60 \
  --output ./shorts/

Prérequis système

• Obligatoire : FFmpeg (ffmpeg / ffprobe)
• Optionnel : FunClip (ASR open source d'Alibaba pour le montage vidéo)
• Optionnel : Whisper (local ou via API)

Installation

# Installer FunClip (recommandé)
pip install funclip

# Installer Whisper
pip install openai-whisper

# FFmpeg (déjà installé)
which ffmpeg  # doit renvoyer un chemin