Communitygithub.com

FFmpeg

FFmpeg est le couteau suisse du traitement multimédia. Il gère pratiquement tous les formats audio et vidéo, codecs et conteneurs existants. Cette compétence couvre la conversion de formats, le transcodage, le découpage, la concaténation, le filtrage, la compression, l'extraction de miniatures, l'incrustation de sous-titres, la normalisation audio, la création de GIF, l'ajout de filigranes et l'intégration avec des outils comme yt-dlp et gallery-dl.

Qu'est-ce que FFmpeg ?

Cette compétence fournit une référence complète et pratique pour utiliser FFmpeg, l'outil en ligne de commande essentiel pour la manipulation de fichiers audio et vidéo. Elle couvre les opérations fondamentales comme la conversion entre formats (WebM, MP4, MKV, AVI, MOV) et codecs (H.264, AAC, VP9, Opus), le découpage temporel précis, la concaténation de clips, l'extraction de pistes audio, la normalisation du volume, le redimensionnement et la compression vidéo, la génération de miniatures et de GIF, l'incrustation de sous-titres et de filigranes, ainsi que des effets comme le ralenti ou l'accélération. La compétence détaille également l'intégration avec des téléchargeurs comme yt-dlp pour convertir automatiquement les fichiers récupérés, et elle propose des scripts de traitement par lots pour automatiser les workflows sur des dossiers entiers. Elle est conçue pour être exécutée sur tout système disposant de FFmpeg (Linux, macOS, Windows), accessible via tout agent capable de lancer des commandes shell. Sa valeur réside dans la présentation de commandes prêtes à l'emploi, organisées par tâche, avec des explications claires sur chaque paramètre (CRF, -movflags, -c copy, etc.) pour éviter les erreurs et optimiser la qualité et la vitesse de traitement.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/TerminalSkills/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 ?

Présentation

FFmpeg est le couteau suisse du traitement multimédia. Il gère pratiquement tous les formats audio et vidéo, codecs et conteneurs existants. Cette compétence couvre la conversion de formats, le transcodage, le découpage, la concaténation, le filtrage, la compression, l'extraction de miniatures, l'incrustation de sous-titres, la normalisation audio, la création de GIF, l'ajout de filigranes et l'intégration avec des outils comme yt-dlp et gallery-dl.

Instructions

Étape 1 : Installation

# Ubuntu/Debian
sudo apt install -y ffmpeg

# macOS
brew install ffmpeg

# Vérification
ffmpeg -version
ffprobe -version   # Outil d'information multimédia, inclus avec ffmpeg

Étape 2 : Conversion de formats

La tâche la plus courante — convertir entre formats de conteneurs et codecs.

# WebM → MP4 (ré-encodage vers H.264 + AAC pour une compatibilité universelle)
ffmpeg -i input.webm -c:v libx264 -c:a aac -movflags +faststart output.mp4

# WebM → MP4 (copie des flux si déjà H.264/AAC — instantané, sans perte de qualité)
ffmpeg -i input.webm -c copy output.mp4

# MKV → MP4 (copie de flux, sans ré-encodage)
ffmpeg -i input.mkv -c copy output.mp4

# AVI → MP4
ffmpeg -i input.avi -c:v libx264 -crf 23 -c:a aac -b:a 128k output.mp4

# MOV → MP4 (Apple ProRes vers H.264)
ffmpeg -i input.mov -c:v libx264 -crf 18 -preset slow -c:a aac output.mp4

# Tout format → MP4 avec démarrage rapide optimisé pour le web
ffmpeg -i input.* -c:v libx264 -crf 23 -preset medium -c:a aac -movflags +faststart output.mp4

CRF (Constant Rate Factor) : Contrôle la qualité. Plus bas = meilleure qualité, fichier plus volumineux.

  • 18 : Visuellement sans perte
  • 23 : Par défaut, bon équilibre
  • 28 : Fichier plus petit, perte de qualité perceptible
  • 51 : Pire qualité

Étape 3 : Opérations audio

# Extraire l'audio d'une vidéo
ffmpeg -i video.mp4 -vn -c:a copy audio.aac          # Copie du codec (rapide)
ffmpeg -i video.mp4 -vn -c:a libmp3lame -q:a 2 audio.mp3  # Conversion en MP3
ffmpeg -i video.mp4 -vn -c:a flac audio.flac          # FLAC sans perte

# Convertir entre formats audio
ffmpeg -i input.wav -c:a libmp3lame -b:a 320k output.mp3
ffmpeg -i input.mp3 -c:a libopus -b:a 128k output.opus
ffmpeg -i input.flac -c:a aac -b:a 256k output.m4a

# Normaliser le volume audio
ffmpeg -i input.mp3 -af loudnorm=I=-16:LRA=11:TP=-1.5 output.mp3

# Changer la fréquence d'échantillonnage
ffmpeg -i input.wav -ar 44100 output.wav

# Fusionner l'audio dans une vidéo
ffmpeg -i video.mp4 -i audio.mp3 -c:v copy -c:a aac -map 0:v:0 -map 1:a:0 output.mp4

Étape 4 : Découpage, coupure et concaténation

# Couper à partir d'un timestamp pour une durée
ffmpeg -i input.mp4 -ss 00:01:30 -t 00:00:45 -c copy clip.mp4    # 45s à partir de 1:30

# Couper d'un timestamp de début à un timestamp de fin
ffmpeg -i input.mp4 -ss 00:05:00 -to 00:10:00 -c copy clip.mp4   # 5:00 à 10:00

# Premières 30 secondes
ffmpeg -i input.mp4 -t 30 -c copy first30.mp4

# Concaténer des fichiers (créer d'abord une liste de fichiers)
cat > filelist.txt << 'EOF'
file 'clip1.mp4'
file 'clip2.mp4'
file 'clip3.mp4'
EOF
ffmpeg -f concat -safe 0 -i filelist.txt -c copy output.mp4

# Concaténer avec ré-encodage (lorsque les codecs diffèrent)
ffmpeg -f concat -safe 0 -i filelist.txt -c:v libx264 -c:a aac output.mp4

Étape 5 : Résolution et compression

# Redimensionner en 1080p (conserver le ratio d'aspect)
ffmpeg -i input.mp4 -vf "scale=-2:1080" -c:v libx264 -crf 23 -c:a copy output.mp4

# Redimensionner en 720p
ffmpeg -i input.mp4 -vf "scale=-2:720" -c:v libx264 -crf 23 -c:a copy output.mp4

# Redimensionner à une largeur spécifique (hauteur automatique)
ffmpeg -i input.mp4 -vf "scale=1280:-2" output.mp4

# Compression agressive (fichier plus petit)
ffmpeg -i input.mp4 -c:v libx264 -crf 28 -preset faster -c:a aac -b:a 96k small.mp4

# Encodage à deux passes pour une taille de fichier cible
ffmpeg -i input.mp4 -c:v libx264 -b:v 1M -pass 1 -an -f null /dev/null
ffmpeg -i input.mp4 -c:v libx264 -b:v 1M -pass 2 -c:a aac -b:a 128k output.mp4

# Changer la fréquence d'images
ffmpeg -i input.mp4 -r 30 output.mp4

Étape 6 : Miniatures et captures d'écran

# Capture unique à un instant donné
ffmpeg -i input.mp4 -ss 00:01:30 -frames:v 1 thumb.jpg

# Capture toutes les 10 secondes
ffmpeg -i input.mp4 -vf "fps=1/10" thumbs/frame_%04d.jpg

# Grille de miniatures (planche contact 4x4)
ffmpeg -i input.mp4 -vf "select='not(mod(n,300))',scale=320:-1,tile=4x4" -frames:v 1 grid.jpg

# Extraire la première image
ffmpeg -i input.mp4 -frames:v 1 first_frame.png

Étape 7 : Sous-titres

# Graver les sous-titres dans la vidéo (incrustés)
ffmpeg -i input.mp4 -vf "subtitles=subs.srt" output.mp4

# Graver les sous-titres ASS/SSA avec style
ffmpeg -i input.mp4 -vf "ass=subs.ass" output.mp4

# Ajouter une piste de sous-titres (sous-titres souples, l'utilisateur peut les activer/désactiver)
ffmpeg -i input.mp4 -i subs.srt -c copy -c:s mov_text output.mp4

# Extraire les sous-titres d'une vidéo
ffmpeg -i input.mkv -map 0:s:0 subs.srt

Étape 8 : Filtres et effets

# Créer un GIF à partir d'un segment vidéo
ffmpeg -i input.mp4 -ss 5 -t 3 -vf "fps=15,scale=480:-1:flags=lanczos" output.gif

# GIF de haute qualité avec palette
ffmpeg -i input.mp4 -ss 5 -t 3 -vf "fps=15,scale=480:-1:flags=lanczos,palettegen" palette.png
ffmpeg -i input.mp4 -i palette.png -ss 5 -t 3 -lavfi "fps=15,scale=480:-1:flags=lanczos[v];[v][1:v]paletteuse" output.gif

# Ajouter un filigrane
ffmpeg -i input.mp4 -i watermark.png -filter_complex "overlay=W-w-10:H-h-10" output.mp4

# Accélérer / ralentir
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]" -map "[v]" -map "[a]" fast.mp4
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=2.0*PTS[v];[0:a]atempo=0.5[a]" -map "[v]" -map "[a]" slow.mp4

# Pivoter la vidéo
ffmpeg -i input.mp4 -vf "transpose=1" rotated.mp4    # 90° dans le sens horaire
ffmpeg -i input.mp4 -vf "transpose=2" rotated.mp4    # 90° dans le sens anti-horaire

# Rogner la vidéo (largeur:hauteur:x:y)
ffmpeg -i input.mp4 -vf "crop=1280:720:0:180" cropped.mp4

# Fondu entrée/sortie
ffmpeg -i input.mp4 -vf "fade=in:0:30,fade=out:870:30" -af "afade=in:0:30,afade=out:870:30" output.mp4

Étape 9 : Informations multimédia

# Informations complètes
ffprobe -v quiet -print_format json -show_format -show_streams input.mp4

# Durée uniquement
ffprobe -v quiet -show_entries format=duration -of csv=p=0 input.mp4

# Résolution
ffprobe -v quiet -select_streams v:0 -show_entries stream=width,height -of csv=p=0 input.mp4

# Informations sur le codec
ffprobe -v quiet -select_streams v:0 -show_entries stream=codec_name -of csv=p=0 input.mp4

Étape 10 : Traitement par lots

# Convertir tous les fichiers WebM en MP4
for f in *.webm; do
  ffmpeg -i "$f" -c:v libx264 -crf 23 -c:a aac "${f%.webm}.mp4"
done

# Compresser tous les fichiers MP4 du répertoire
for f in *.mp4; do
  ffmpeg -i "$f" -c:v libx264 -crf 28 -preset fast -c:a aac "compressed_${f}"
done

# Extraire l'audio de toutes les vidéos
for f in *.mp4; do
  ffmpeg -i "$f" -vn -c:a libmp3lame -q:a 2 "${f%.mp4}.mp3"
done

Exemples

Exemple 1 : Convertir des téléchargements yt-dlp de WebM en MP4

Demande utilisateur : « J'ai téléchargé des vidéos avec yt-dlp mais ce ne sont que des fichiers .webm. Convertis-les en MP4 pour qu'elles soient lisibles sur mon iPhone. »

L'agent va :

  1. Vérifier si les fichiers WebM contiennent du H.264+AAC (copie de flux possible) ou du VP9+Opus (ré-encodage nécessaire) en utilisant ffprobe.
  2. Pour les fichiers VP9/Opus, exécuter : for f in *.webm; do ffmpeg -i "$f" -c:v libx264 -crf 23 -preset medium -c:a aac -movflags +faststart "${f%.webm}.mp4"; done
  3. Le flag -movflags +faststart déplace les métadonnées au début du fichier, permettant une lecture instantanée sur les appareils mobiles et les navigateurs web.
  4. Rapporter les résultats de conversion avec les tailles de fichiers avant et après.

Exemple 2 : Créer un best-of à partir de plusieurs clips

Demande utilisateur : « J'ai 5 clips vidéo d'une conférence. Découpe les meilleurs moments et assemble-les en une seule vidéo avec des transitions en fondu. »

L'agent va :

  1. Découper chaque clip aux timestamps spécifiés en utilisant les flags -ss et -to.
  2. Ré-encoder tous les clips avec le même codec/résolution : ffmpeg -i clip.mp4 -c:v libx264 -crf 23 -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:-1:-1,fade=in:0:15,fade=out:st=DURATION:d=0.5" -c:a aac -ar 44100 segment_N.mp4
  3. Créer une liste de fichiers concat et fusionner : ffmpeg -f concat -safe 0 -i filelist.txt -c copy highlight_reel.mp4

Directives

  • Lors de la conversion de téléchargements yt-dlp (généralement WebM/VP9+Opus), toujours ré-encoder vers H.264+AAC pour une compatibilité maximale avec les appareils. Utiliser -c:v libx264 -crf 23 -c:a aac -movflags +faststart.
  • Utiliser la copie de flux (-c copy) chaque fois que possible pour éviter le ré-encodage — c'est instantané et sans perte. Ne ré-encoder que lors du changement de codec, de l'application de filtres, ou lorsque les conteneurs source et cible sont incompatibles.
  • Toujours ajouter -movflags +faststart lors de la création de fichiers MP4 destinés à une lecture web ou mobile ; cela déplace l'atome moov au début du fichier pour un streaming instantané.
  • Utiliser ffprobe avant tout traitement pour comprendre le format d'entrée, évitant ainsi un ré-encodage inutile.
  • Pour les opérations par lots, toujours tester la commande sur un seul fichier avant de l'exécuter sur tout le répertoire.
  • Privilégier le mode CRF au mode de débit binaire pour l'encodage en une seule passe ; il produit une qualité cohérente pour différents types de contenu.

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills associés