O que FFmpeg faz?
Visão Geral
FFmpeg é o canivete suíço do processamento de mídia. Ele lida com praticamente todos os formatos de áudio e vídeo, codecs e contêineres existentes. Esta skill cobre conversão de formatos, transcodificação de codecs, corte, concatenação, filtragem, compressão, extração de miniaturas, incorporação de legendas, normalização de áudio, criação de GIFs, adição de marcas d'água e integração com pipelines usando ferramentas como yt-dlp e gallery-dl.
Instruções
Passo 1: Instalação
# Ubuntu/Debian
sudo apt install -y ffmpeg
# macOS
brew install ffmpeg
# Verificar
ffmpeg -version
ffprobe -version # ferramenta de informações de mídia, incluso com ffmpeg
Passo 2: Conversão de Formatos
A tarefa mais comum — conversão entre formatos de contêiner e codecs.
# WebM → MP4 (reencodificar para H.264 + AAC para compatibilidade universal)
ffmpeg -i input.webm -c:v libx264 -c:a aac -movflags +faststart output.mp4
# WebM → MP4 (copiar streams se já for H.264/AAC — instantâneo, sem perda de qualidade)
ffmpeg -i input.webm -c copy output.mp4
# MKV → MP4 (cópia de stream, sem reencodificação)
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 para H.264)
ffmpeg -i input.mov -c:v libx264 -crf 18 -preset slow -c:a aac output.mp4
# Qualquer formato → MP4 com início rápido otimizado para web
ffmpeg -i input.* -c:v libx264 -crf 23 -preset medium -c:a aac -movflags +faststart output.mp4
CRF (Constant Rate Factor): Controla a qualidade. Menor = melhor qualidade, arquivo maior.
- 18: Visualmente sem perdas
- 23: Padrão, bom equilíbrio
- 28: Arquivo menor, alguma perda de qualidade
- 51: Pior qualidade
Passo 3: Operações de Áudio
# Extrair áudio do vídeo
ffmpeg -i video.mp4 -vn -c:a copy audio.aac # Copiar codec (rápido)
ffmpeg -i video.mp4 -vn -c:a libmp3lame -q:a 2 audio.mp3 # Converter para MP3
ffmpeg -i video.mp4 -vn -c:a flac audio.flac # FLAC sem perdas
# Converter entre formatos de áudio
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
# Normalizar volume de áudio
ffmpeg -i input.mp3 -af loudnorm=I=-16:LRA=11:TP=-1.5 output.mp3
# Alterar taxa de amostragem
ffmpeg -i input.wav -ar 44100 output.wav
# Mesclar áudio no vídeo
ffmpeg -i video.mp4 -i audio.mp3 -c:v copy -c:a aac -map 0:v:0 -map 1:a:0 output.mp4
Passo 4: Cortar, Recortar e Concatenar
# Cortar do timestamp até a duração
ffmpeg -i input.mp4 -ss 00:01:30 -t 00:00:45 -c copy clip.mp4 # 45s a partir de 1:30
# Cortar do início até o timestamp final
ffmpeg -i input.mp4 -ss 00:05:00 -to 00:10:00 -c copy clip.mp4 # 5:00 a 10:00
# Primeiros 30 segundos
ffmpeg -i input.mp4 -t 30 -c copy first30.mp4
# Concatenar arquivos (criar lista de arquivos primeiro)
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
# Concatenar com reencodificação (quando os codecs diferem)
ffmpeg -f concat -safe 0 -i filelist.txt -c:v libx264 -c:a aac output.mp4
Passo 5: Resolução e Compressão
# Redimensionar para 1080p (manter proporção)
ffmpeg -i input.mp4 -vf "scale=-2:1080" -c:v libx264 -crf 23 -c:a copy output.mp4
# Redimensionar para 720p
ffmpeg -i input.mp4 -vf "scale=-2:720" -c:v libx264 -crf 23 -c:a copy output.mp4
# Redimensionar para largura específica (altura automática)
ffmpeg -i input.mp4 -vf "scale=1280:-2" output.mp4
# Comprimir agressivamente (arquivo menor)
ffmpeg -i input.mp4 -c:v libx264 -crf 28 -preset faster -c:a aac -b:a 96k small.mp4
# Codificação em dois passes para tamanho de arquivo alvo
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
# Alterar taxa de quadros
ffmpeg -i input.mp4 -r 30 output.mp4
Passo 6: Miniaturas e Capturas de Tela
# Captura de tela única em um timestamp
ffmpeg -i input.mp4 -ss 00:01:30 -frames:v 1 thumb.jpg
# Captura de tela a cada 10 segundos
ffmpeg -i input.mp4 -vf "fps=1/10" thumbs/frame_%04d.jpg
# Grade de miniaturas (folha de contato 4x4)
ffmpeg -i input.mp4 -vf "select='not(mod(n,300))',scale=320:-1,tile=4x4" -frames:v 1 grid.jpg
# Extrair primeiro quadro
ffmpeg -i input.mp4 -frames:v 1 first_frame.png
Passo 7: Legendas
# Queimar legendas no vídeo (hardcoded)
ffmpeg -i input.mp4 -vf "subtitles=subs.srt" output.mp4
# Queimar legendas ASS/SSA com estilo
ffmpeg -i input.mp4 -vf "ass=subs.ass" output.mp4
# Adicionar faixa de legenda (soft subs, usuário pode ativar/desativar)
ffmpeg -i input.mp4 -i subs.srt -c copy -c:s mov_text output.mp4
# Extrair legendas do vídeo
ffmpeg -i input.mkv -map 0:s:0 subs.srt
Passo 8: Filtros e Efeitos
# Criar GIF a partir de um segmento de vídeo
ffmpeg -i input.mp4 -ss 5 -t 3 -vf "fps=15,scale=480:-1:flags=lanczos" output.gif
# GIF de alta qualidade com paleta
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
# Adicionar marca d'água
ffmpeg -i input.mp4 -i watermark.png -filter_complex "overlay=W-w-10:H-h-10" output.mp4
# Acelerar / desacelerar
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
# Girar vídeo
ffmpeg -i input.mp4 -vf "transpose=1" rotated.mp4 # 90° no sentido horário
ffmpeg -i input.mp4 -vf "transpose=2" rotated.mp4 # 90° no sentido anti-horário
# Cortar vídeo (largura:altura:x:y)
ffmpeg -i input.mp4 -vf "crop=1280:720:0:180" cropped.mp4
# Fade in/out
ffmpeg -i input.mp4 -vf "fade=in:0:30,fade=out:870:30" -af "afade=in:0:30,afade=out:870:30" output.mp4
Passo 9: Informações de Mídia
# Informações completas da mídia
ffprobe -v quiet -print_format json -show_format -show_streams input.mp4
# Apenas duração
ffprobe -v quiet -show_entries format=duration -of csv=p=0 input.mp4
# Resolução
ffprobe -v quiet -select_streams v:0 -show_entries stream=width,height -of csv=p=0 input.mp4
# Informações do codec
ffprobe -v quiet -select_streams v:0 -show_entries stream=codec_name -of csv=p=0 input.mp4
Passo 10: Processamento em Lote
# Converter todos os arquivos WebM para MP4
for f in *.webm; do
ffmpeg -i "$f" -c:v libx264 -crf 23 -c:a aac "${f%.webm}.mp4"
done
# Comprimir todos os arquivos MP4 no diretório
for f in *.mp4; do
ffmpeg -i "$f" -c:v libx264 -crf 28 -preset fast -c:a aac "compressed_${f}"
done
# Extrair áudio de todos os vídeos
for f in *.mp4; do
ffmpeg -i "$f" -vn -c:a libmp3lame -q:a 2 "${f%.mp4}.mp3"
done
Exemplos
Exemplo 1: Converter downloads do yt-dlp de WebM para MP4
Comando do usuário: "Baixei vídeos com yt-dlp, mas eles são todos arquivos .webm. Converta-os para MP4 para que toquem no meu iPhone."
O agente irá:
- Verificar se os arquivos WebM contêm H.264+AAC (cópia de stream possível) ou VP9+Opus (reencodificação necessária) usando
ffprobe. - Para arquivos VP9/Opus, executar:
for f in *.webm; do ffmpeg -i "$f" -c:v libx264 -crf 23 -preset medium -c:a aac -movflags +faststart "${f%.webm}.mp4"; done - A flag
-movflags +faststartmove os metadados para o início do arquivo, permitindo reprodução instantânea em dispositivos móveis e navegadores web. - Reportar os resultados da conversão com tamanhos de arquivo antes e depois.
Exemplo 2: Criar um compilado de destaques a partir de vários clipes
Comando do usuário: "Tenho 5 clipes de vídeo de uma conferência. Corte as melhores partes e junte-as em um único vídeo com transições de fade."
O agente irá:
- Cortar cada clipe nos timestamps especificados usando as flags
-sse-to. - Reencodificar todos os clipes para o mesmo codec/resolução:
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 - Criar uma lista de arquivos concat e mesclar:
ffmpeg -f concat -safe 0 -i filelist.txt -c copy highlight_reel.mp4
Diretrizes
- Ao converter downloads do yt-dlp (tipicamente WebM/VP9+Opus), sempre reencodifique para H.264+AAC para máxima compatibilidade de dispositivos. Use
-c:v libx264 -crf 23 -c:a aac -movflags +faststart. - Use cópia de stream (
-c copy) sempre que possível para evitar reencodificação — é instantânea e sem perdas. Apenas reencodifique ao mudar codecs, aplicar filtros, ou quando os contêineres de origem e destino forem incompatíveis. - Sempre adicione
-movflags +faststartao criar arquivos MP4 para reprodução na web ou dispositivos móveis; isso move o átomo moov para o início do arquivo para streaming instantâneo. - Use
ffprobeantes do processamento para entender o formato de entrada, evitando reencodificações desnecessárias. - Para operações em lote, sempre teste o comando em um único arquivo antes de executar em todo o diretório.
- Prefira o modo CRF ao modo de taxa de bits para codificação de passagem única; ele produz qualidade consistente em diferentes tipos de conteúdo.