Communitygithub.com

FFmpeg pour la Production Vidéo

Traitement vidéo et audio avec FFmpeg. Utilisé pour la conversion de formats, le redimensionnement, la compression, l'extraction audio et la préparation d'assets pour Remotion.

Qu'est-ce que FFmpeg pour la Production Vidéo ?

Cette compétence fournit un guide complet sur l'utilisation de FFmpeg pour le traitement vidéo et audio, spécialement conçu pour les workflows de production vidéo avec Remotion. Elle couvre les opérations essentielles comme la conversion GIF vers MP4, le redimensionnement, la compression, l'extraction audio, le découpage temporel, l'accélération/ralentissement, la concaténation, les fondus, et l'optimisation pour différentes plateformes de distribution (YouTube, Twitter/X, LinkedIn, web). Elle inclut des modèles spécifiques à Remotion pour l'ajustement de la vitesse vidéo, la préparation d'enregistrements, et des scripts batch. La compétence fournit également des références rapides sur les paramètres de qualité (CRF, preset), les erreurs courantes et leurs solutions, ainsi qu'un workflow d'intégration pour optimiser les rendus Remotion avant publication. Elle est conçue pour Claude Code, Cursor, Codex ou tout agent capable d'exécuter des commandes shell, et peut être invoquée par des demandes comme 'convertis ce GIF en MP4', 'redimensionne cette vidéo', ou 'extrais l'audio'. Les utilisateurs peuvent également demander des améliorations ou contribuer via GitHub.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Zuhair-01/claude-skills-and-systems/tree/HEAD/skills/ffmpeg

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 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 lecteurs
  • scale=trunc(...) - Force des dimensions paires (requises par la plupart des codecs)

Redimensionner une Vidéo

# En 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

# En 1920x1080 (recadrer pour remplir)
ffmpeg -i input.mp4 -vf "scale=1920:1080:force_original_aspect_ratio=increase,crop=1920:1080" output.mp4

# Redimensionner à une 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 Mb/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

Découper/Couper une Vidéo

# Couper à partir 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 coupe)
# Utiliser uniquement si 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 découpage. 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 seulement (pas d'audio)
ffmpeg -i input.mp4 -filter:v "setpts=0.5*PTS" -an output.mp4

Concaténer des Vidéos

# Créer une liste de 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 des Informations sur la 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énarioUtiliser FFmpegUtiliser Remotion
Vitesse constante (1,5x, 2x)Les deux fonctionnent✅ Plus simple
Vitesses extrêmes (>4x ou <0,25x)✅ Plus fiablePeut poser problème
Vitesse variable (accélération dans le temps)✅ PrétraiterSolution complexe nécessaire
Synchronisation audio parfaite nécessaire✅ GarantieGénéralement correct
Démo doit correspondre au timing de la voix off✅ Pré-calculerAjustement à l'exécution

Limitation de Remotion : playbackRate doit être constant. L'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. 60s de démo 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 accentuer (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 en 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 audio extrême (>2x) : Enchaî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

# 1080p standard, 30 ips, 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 vers un Asset Remotion

# Depuis un enregistrement iPhone/iPad (généralement 60 ips, 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 Lots 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 un 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 un 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

Directives de Qualité

Cas d'UtilisationCRFPresetRemarques
Archive/Master18slowMeilleure qualité, fichiers volumineux
Production20-22mediumBon équilibre
Web/Aperçu23-25fastFichiers plus petits
Brouillon/Rapide28+veryfastEncodage rapide

Optimisation de Sortie Spécifique à la Plateforme

Après que Remotion a rendu votre vidéo (généralement dans out/video.mp4), utilisez FFmpeg pour optimiser chaque plateforme de distribution.

Intégration du Workflow

Rendu Remotion (master)     Optimisation FFmpeg      Téléchargement sur la 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échargez 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 (moins de 15 Mo ciblé pour un téléchargement 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

LinkedIn préfère le MP4 avec audio AAC, durée 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 un Chargement Rapide)

# MP4 optimisé pour le web (petit fichier, 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, prise en charge 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 de 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 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 des Plateformes

PlateformeRésolution MaxTaille MaxDurée MaxAudio
YouTube8K256 Go12 heuresAAC 48 kHz
Twitter/X1920x1200512 Mo140 sAAC 44,1 kHz
LinkedIn4096x23045 Go10 minAAC 48 kHz
Instagram Feed1080x13504 Go60 sAAC 48 kHz
Instagram Reels1080x19204 Go90 sAAC 48 kHz
TikTok1080x1920287 Mo10 minAAC

Export par Lots 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é :"
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

ErreurCauseCorrectif
"No such file"Mauvais chemin d'entréeVérifier le chemin, utiliser des guillemets pour les espaces
"Invalid data"Entrée corrompueRe-télécharger ou ré-enregistrer la source
"height not divisible by 2"Dimensions impairesAjouter un filtre d'échelle avec trunc
"encoder not found"Codec manquantInstaller FFmpeg avec tous les codecs
Sortie 0 octetsÉchec silencieuxVérifier la sortie complète de ffmpeg pour les erreurs

Retours & 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 à :
    1. Mettre à jour cette compétence avec des améliorations
    2. 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.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

Zuhair-01/claude-skills-and-systems

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Zuhair-01/claude-skills-and-systems

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Zuhair-01/claude-skills-and-systems

Edit existing videos using AI — remix style, upscale, remove background, and add audio via fal.ai's hosted video models.

Zuhair-01/claude-skills-and-systems

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Zuhair-01/claude-skills-and-systems

Read-only queue dashboard for workspace-aware ship. (gstack)

Zuhair-01/claude-skills-and-systems

Generate HeyGen presenter videos via the v3 Video Agent pipeline — handles Frame Check (aspect ratio correction), prompt engineering, avatar resolution, and voice selection. Required for any HeyGen video generation. Replaces deprecated endpoints with v3. Use when: (1) generating any HeyGen video (via API or otherwise), (2) sending a personalized video message (outreach, update, announcement, pitch, knowledge), (3) creating a HeyGen presenter-led explainer, tutorial, or product demo with a human face, (4) "make a video of me saying...", "send a video to my leads", "record an update for my team", "create a video pitch", "make a loom-style message", "I want to appear in this video", "generate a HeyGen video", "make a talking head video". Accepts avatar_id from heygen-avatar for identity-first HeyGen videos, or uses a stock presenter. Returns video share URL + HeyGen session URL for iteration. Chain signal: when the user wants to create/design an avatar AND make a video in the same request, run heygen-avatar f...

Zuhair-01/claude-skills-and-systems

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

Zuhair-01/claude-skills-and-systems

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Zuhair-01/claude-skills-and-systems

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

Skills associés