FFmpeg pour la Production Vidéo
FFmpeg est l'outil essentiel pour le traitement vidéo/audio. Cette compétence couvre les opérations courantes pour les projets vidéo Remotion.
Référence Rapide
GIF vers MP4 (compatible Remotion)
ffmpeg -i input.gif -movflags faststart -pix_fmt yuv420p \
-vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" output.mp4
Pourquoi ces options :
-movflags faststart- Déplace les métadonnées au début pour le streaming web-pix_fmt yuv420p- Assure la compatibilité avec la plupart des lecteursscale=trunc(...)- Force des dimensions paires (requises par la plupart des codecs)
Redimensionner une Vidéo
# Vers 1920x1080 (conserver le ratio, ajouter des bandes noires)
ffmpeg -i input.mp4 -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2" output.mp4
# Vers 1920x1080 (recadrer pour remplir)
ffmpeg -i input.mp4 -vf "scale=1920:1080:force_original_aspect_ratio=increase,crop=1920:1080" output.mp4
# Redimensionner à la largeur, hauteur automatique
ffmpeg -i input.mp4 -vf "scale=1280:-2" output.mp4
Compresser une Vidéo
# Bonne qualité, fichier plus petit (CRF 23 par défaut, plus bas = meilleure qualité)
ffmpeg -i input.mp4 -c:v libx264 -crf 23 -preset medium -c:a aac -b:a 128k output.mp4
# Compression agressive pour aperçu web
ffmpeg -i input.mp4 -c:v libx264 -crf 28 -preset fast -c:a aac -b:a 96k output.mp4
# Taille de fichier cible (ex. ~10 Mo pour 60s de vidéo = ~1,3 Mbit/s)
ffmpeg -i input.mp4 -c:v libx264 -b:v 1300k -c:a aac -b:a 128k output.mp4
Extraire l'Audio
# Extraire en MP3
ffmpeg -i input.mp4 -vn -acodec libmp3lame -q:a 2 output.mp3
# Extraire en AAC
ffmpeg -i input.mp4 -vn -acodec aac -b:a 192k output.m4a
# Extraire en WAV (non compressé)
ffmpeg -i input.mp4 -vn output.wav
Convertir des Formats Audio
# M4A vers MP3 (pour échantillons vocaux ElevenLabs)
ffmpeg -i input.m4a -codec:a libmp3lame -qscale:a 2 output.mp3
# WAV vers MP3
ffmpeg -i input.wav -codec:a libmp3lame -b:a 192k output.mp3
# Ajuster le volume
ffmpeg -i input.mp3 -filter:a "volume=1.5" output.mp3
Couper/Rogner une Vidéo
# Couper d'un timestamp pour une durée (recommandé - fiable)
ffmpeg -i input.mp4 -ss 00:00:30 -t 00:00:15 -c:v libx264 -c:a aac output.mp4
# Couper d'un timestamp à un autre
ffmpeg -i input.mp4 -ss 00:00:30 -to 00:00:45 -c:v libx264 -c:a aac output.mp4
# Copie de flux (plus rapide mais peut perdre des images aux points de coupure)
# À utiliser uniquement lorsque la source a des images-clés fréquentes
ffmpeg -i input.mp4 -ss 00:00:30 -t 00:00:15 -c copy output.mp4
Remarque : Le ré-encodage est recommandé pour le rognage. La copie de flux (-c copy) peut supprimer silencieusement la vidéo si le point de recherche ne correspond pas à une image-clé.
Accélérer / Ralentir
# Vitesse 2x (vidéo et audio)
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]" -map "[v]" -map "[a]" output.mp4
# Vitesse 0.5x (ralenti)
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=2.0*PTS[v];[0:a]atempo=0.5[a]" -map "[v]" -map "[a]" output.mp4
# Vidéo uniquement (sans audio)
ffmpeg -i input.mp4 -filter:v "setpts=0.5*PTS" -an output.mp4
Concaténer des Vidéos
# Créer la liste des fichiers
echo "file 'clip1.mp4'" > list.txt
echo "file 'clip2.mp4'" >> list.txt
echo "file 'clip3.mp4'" >> list.txt
# Concaténer (même codec/résolution)
ffmpeg -f concat -safe 0 -i list.txt -c copy output.mp4
# Concaténer avec ré-encodage (sources différentes)
ffmpeg -f concat -safe 0 -i list.txt -c:v libx264 -c:a aac output.mp4
Ajouter un Fondu d'Entrée/Sortie
# Fondu d'entrée sur la première seconde, fondu de sortie sur la dernière seconde (vidéo 30ips)
ffmpeg -i input.mp4 -vf "fade=t=in:st=0:d=1,fade=t=out:st=9:d=1" -c:a copy output.mp4
# Fondu audio
ffmpeg -i input.mp4 -af "afade=t=in:st=0:d=1,afade=t=out:st=9:d=1" -c:v copy output.mp4
Obtenir les Informations Vidéo
# Durée, résolution, informations sur le codec
ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 input.mp4
# Informations complètes
ffprobe -v quiet -print_format json -show_format -show_streams input.mp4
Modèles Spécifiques à Remotion
Ajustement de la Vitesse Vidéo pour Remotion
Quand utiliser FFmpeg vs playbackRate de Remotion :
| Scénario | Utiliser FFmpeg | Utiliser Remotion |
|---|---|---|
| Vitesse constante (1.5x, 2x) | Les deux fonctionnent | ✅ Plus simple |
| Vitesses extrêmes (>4x ou <0.25x) | ✅ Plus fiable | Peut avoir des problèmes |
| Vitesse variable (accélération dans le temps) | ✅ Pré-traitement | Solution complexe nécessaire |
| Synchronisation audio parfaite | ✅ Garantie | Généralement correct |
| Démo doit correspondre au timing de la voix off | ✅ Pré-calcul | Ajustement à l'exécution |
Limitation de Remotion : playbackRate doit être constant. Une interpolation dynamique comme playbackRate={interpolate(frame, [0, 100], [1, 5])} ne fonctionnera pas correctement car Remotion évalue les images indépendamment.
# Accélérer une démo pour correspondre à une scène (ex. démo 60s en 20s = vitesse 3x)
ffmpeg -i demo-raw.mp4 \
-filter_complex "[0:v]setpts=0.333*PTS[v];[0:a]atempo=3.0[a]" \
-map "[v]" -map "[a]" \
public/demos/demo-fast.mp4
# Ralenti pour emphase (vitesse 0.5x)
ffmpeg -i action.mp4 \
-filter_complex "[0:v]setpts=2.0*PTS[v];[0:a]atempo=0.5[a]" \
-map "[v]" -map "[a]" \
public/demos/action-slow.mp4
# Accélérer sans audio (courant pour les enregistrements d'écran)
ffmpeg -i demo.mp4 -filter:v "setpts=0.5*PTS" -an public/demos/demo-2x.mp4
# Effet timelapse (vitesse 10x, supprimer l'audio)
ffmpeg -i long-demo.mp4 -filter:v "setpts=0.1*PTS" -an public/demos/timelapse.mp4
Calculer le facteur de vitesse :
- Pour faire tenir X secondes de vidéo dans Y secondes de scène :
vitesse = X / Y - Multiplicateur setpts =
1 / vitesse(ex. vitesse 3x = setpts=0.333*PTS) - Valeur atempo =
vitesse(ex. vitesse 3x = atempo=3.0)
Vitesse extrême (>2x audio) : Chaîner les filtres atempo (chacun limité à la plage 0.5-2.0) :
# Audio vitesse 4x
-filter_complex "[0:a]atempo=2.0,atempo=2.0[a]"
# Audio vitesse 8x
-filter_complex "[0:a]atempo=2.0,atempo=2.0,atempo=2.0[a]"
Préparer un Enregistrement de Démo pour Remotion
# Standard 1080p, 30ips, prêt pour Remotion
ffmpeg -i raw-recording.mp4 \
-vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2,fps=30" \
-c:v libx264 -crf 18 -preset slow \
-c:a aac -b:a 192k \
-movflags faststart \
public/demos/demo.mp4
Enregistrement d'Écran en Ressource Remotion
# Depuis un enregistrement iPhone/iPad (généralement 60ips, résolution variable)
ffmpeg -i iphone-recording.mov \
-vf "scale=1920:-2,fps=30" \
-c:v libx264 -crf 20 \
-an \
public/demos/mobile-demo.mp4
Conversion par Lot de GIF
for f in assets/*.gif; do
ffmpeg -i "$f" -movflags faststart -pix_fmt yuv420p \
-vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" \
"public/demos/$(basename "$f" .gif).mp4"
done
Problèmes Courants
"Hauteur non divisible par 2"
Ajouter le filtre d'échelle : -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2"
La vidéo ne se lit pas dans le navigateur
Utiliser : -movflags faststart -pix_fmt yuv420p -c:v libx264
Audio désynchronisé après changement de vitesse
Utiliser filter_complex avec atempo : -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]"
Fichier trop volumineux
Augmenter le CRF (23→28) ou réduire la résolution
Guide de Qualité
| Cas d'Utilisation | CRF | Preset | Remarques |
|---|---|---|---|
| Archive/Master | 18 | slow | Meilleure qualité, fichiers volumineux |
| Production | 20-22 | medium | Bon équilibre |
| Web/Aperçu | 23-25 | fast | Fichiers plus petits |
| Brouillon/Rapide | 28+ | veryfast | Encodage rapide |
Optimisation de la Sortie par Plateforme
Après que Remotion a rendu votre vidéo (généralement vers out/video.mp4), utilisez FFmpeg pour optimiser pour chaque plateforme de distribution.
Intégration du Flux de Travail
Rendu Remotion (master) Optimisation FFmpeg Téléversement plateforme
↓ ↓ ↓
out/video.mp4 ────────→ out/video-youtube.mp4 ───→ YouTube
────────→ out/video-twitter.mp4 ───→ Twitter/X
────────→ out/video-linkedin.mp4 ───→ LinkedIn
────────→ out/video-web.mp4 ───→ Intégration site web
YouTube (Paramètres Recommandés)
YouTube ré-encode tout, donc téléversez en haute qualité :
# Optimisé YouTube (1080p)
ffmpeg -i out/video.mp4 \
-c:v libx264 -preset slow -crf 18 \
-profile:v high -level 4.0 \
-bf 2 -g 30 \
-c:a aac -b:a 192k -ar 48000 \
-movflags +faststart \
out/video-youtube.mp4
# YouTube Shorts (vertical 1080x1920)
ffmpeg -i out/video.mp4 \
-vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2" \
-c:v libx264 -crf 18 -c:a aac -b:a 192k \
out/video-shorts.mp4
Twitter/X
Twitter a des limites strictes : max 140s, 512 Mo, 1920x1200 :
# Optimisé Twitter (cible <15 Mo pour téléversement rapide)
ffmpeg -i out/video.mp4 \
-c:v libx264 -preset medium -crf 24 \
-profile:v main -level 3.1 \
-vf "scale='min(1280,iw)':'min(720,ih)':force_original_aspect_ratio=decrease" \
-c:a aac -b:a 128k -ar 44100 \
-movflags +faststart \
-fs 15M \
out/video-twitter.mp4
# Vérifier la taille et la durée du fichier
ffprobe -v error -show_entries format=duration,size -of csv=p=0 out/video-twitter.mp4
LinkedIn préfère MP4 avec audio AAC, max 10 minutes :
# Optimisé LinkedIn
ffmpeg -i out/video.mp4 \
-c:v libx264 -preset medium -crf 22 \
-profile:v main \
-vf "scale='min(1920,iw)':'min(1080,ih)':force_original_aspect_ratio=decrease" \
-c:a aac -b:a 192k -ar 48000 \
-movflags +faststart \
out/video-linkedin.mp4
Site Web/Intégration (Optimisé pour Chargement Rapide)
# MP4 optimisé web (fichier petit, chargement progressif)
ffmpeg -i out/video.mp4 \
-c:v libx264 -preset medium -crf 26 \
-profile:v baseline -level 3.0 \
-vf "scale=1280:720" \
-c:a aac -b:a 128k \
-movflags +faststart \
out/video-web.mp4
# Alternative WebM (meilleure compression, support navigateur plus large)
ffmpeg -i out/video.mp4 \
-c:v libvpx-vp9 -crf 30 -b:v 0 \
-vf "scale=1280:720" \
-c:a libopus -b:a 128k \
-deadline good \
out/video-web.webm
GIF (pour Aperçus/Miniatures)
# GIF haute qualité (5 premières secondes)
ffmpeg -i out/video.mp4 -t 5 \
-vf "fps=15,scale=480:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" \
out/preview.gif
# GIF fichier plus petit
ffmpeg -i out/video.mp4 -t 3 \
-vf "fps=10,scale=320:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" \
out/preview-small.gif
Référence Rapide des Exigences Plateforme
| Plateforme | Résolution Max | Taille Max | Durée Max | Audio |
|---|---|---|---|---|
| YouTube | 8K | 256 Go | 12 heures | AAC 48 kHz |
| Twitter/X | 1920x1200 | 512 Mo | 140 s | AAC 44.1 kHz |
| 4096x2304 | 5 Go | 10 min | AAC 48 kHz | |
| Instagram Feed | 1080x1350 | 4 Go | 60 s | AAC 48 kHz |
| Instagram Reels | 1080x1920 | 4 Go | 90 s | AAC 48 kHz |
| TikTok | 1080x1920 | 287 Mo | 10 min | AAC |
Exportation par Lot pour Toutes les Plateformes
#!/bin/bash
# enregistrer sous : export-all-platforms.sh
INPUT="out/video.mp4"
# YouTube (haute qualité)
ffmpeg -i "$INPUT" -c:v libx264 -preset slow -crf 18 \
-c:a aac -b:a 192k -movflags +faststart \
out/video-youtube.mp4
# Twitter (compressé)
ffmpeg -i "$INPUT" -c:v libx264 -crf 24 \
-vf "scale='min(1280,iw)':'-2'" \
-c:a aac -b:a 128k -movflags +faststart \
out/video-twitter.mp4
# LinkedIn
ffmpeg -i "$INPUT" -c:v libx264 -crf 22 \
-c:a aac -b:a 192k -movflags +faststart \
out/video-linkedin.mp4
# Intégration web (petit)
ffmpeg -i "$INPUT" -c:v libx264 -crf 26 \
-vf "scale=1280:720" \
-c:a aac -b:a 128k -movflags +faststart \
out/video-web.mp4
echo "Exportés :"
ls -lh out/video-*.mp4
Gestion des Erreurs
Erreurs courantes et correctifs lors du traitement vidéo :
# Vérifier si FFmpeg a réussi
ffmpeg -i input.mp4 -c:v libx264 output.mp4 && echo "Succès" || echo "Échec : vérifier le fichier d'entrée"
# Valider que le fichier de sortie est lisible
ffprobe -v error -select_streams v:0 -show_entries stream=codec_name -of csv=p=0 output.mp4
# Obtenir des informations d'erreur détaillées
ffmpeg -v error -i input.mp4 -f null - 2>&1 | head -20
Gestion des Échecs Courants
| Erreur | Cause | Correctif |
|---|---|---|
| "No such file" | Chemin d'entrée incorrect | Vérifier le chemin, utiliser des guillemets pour les espaces |
| "Invalid data" | Entrée corrompue | Re-télécharger ou ré-enregistrer la source |
| "height not divisible by 2" | Dimensions impaires | Ajouter un filtre d'échelle avec trunc |
| "encoder not found" | Codec manquant | Installer FFmpeg avec les codecs complets |
| Fichier de sortie 0 octet | Échec silencieux | Vérifier la sortie complète de ffmpeg pour les erreurs |
Commentaires & Contributions
Si cette compétence manque d'informations ou pourrait être améliorée :
- Commande manquante ? Décrivez ce dont vous aviez besoin
- Erreur trouvée ? Faites-moi savoir ce qui ne va pas
- Vous voulez contribuer ? Je peux vous aider à :
- Mettre à jour cette compétence avec des améliorations
- Créer une PR sur github.com/digitalsamba/claude-code-video-toolkit
Dites simplement "améliorer cette compétence" et je vous guiderai dans la mise à jour de .claude/skills/ffmpeg/SKILL.md.