O que FFmpeg faz?
Visão Geral
O FFmpeg é o canivete suíço do processamento de mídia. Ele lida com praticamente todos os formatos de áudio e vídeo, codecs e containers existentes. Esta skill abrange conversão de formatos, transcodificação, corte, concatenação, filtros, compressão, extração de miniaturas, inserção de legendas, normalização de áudio, criação de GIFs, marca d'água e integração com 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, incluída com ffmpeg
Passo 2: Conversão de Formato
A tarefa mais comum — converter entre formatos de container e codecs.
# WebM → MP4 (re-encodificar 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á H.264/AAC — instantâneo, sem perda de qualidade)
ffmpeg -i input.webm -c copy output.mp4
# MKV → MP4 (cópia de stream, sem re-encodificaçã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, Aparar e Concatenar
# Aparar a partir de um timestamp por duração
ffmpeg -i input.mp4 -ss 00:01:30 -t 00:00:45 -c copy clip.mp4 # 45s começando em 1:30
# Aparar do início ao 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 re-encodificaçã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 de dois passos 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 única em timestamp
ffmpeg -i input.mp4 -ss 00:01:30 -frames:v 1 thumb.jpg
# Captura 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
# Gravar legendas no vídeo (hardcoded)
ffmpeg -i input.mp4 -vf "subtitles=subs.srt" output.mp4
# Gravar legendas ASS/SSA com estilo
ffmpeg -i input.mp4 -vf "ass=subs.ass" output.mp4
# Adicionar faixa de legenda (soft subs, usuário pode alternar)
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° sentido horário
ffmpeg -i input.mp4 -vf "transpose=2" rotated.mp4 # 90° 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
Prompt do usuário: "Baixei vídeos com yt-dlp, mas eles são todos arquivos .webm. Converta-os para MP4 para que possam ser reproduzidos 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 (re-encodificaçã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. - Relatar resultados da conversão com tamanhos de arquivo antes e depois.
Exemplo 2: Criar um vídeo de melhores momentos a partir de vários clipes
Prompt 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 para os timestamps especificados usando as flags
-sse-to. - Re-encodificar todos os clipes para codec/resolução correspondentes:
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 re-encodificar para H.264+AAC para máxima compatibilidade com 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 re-encodificação — é instantânea e sem perdas. Apenas re-encodifique ao alterar codecs, aplicar filtros, ou quando os containers de origem e destino forem incompatíveis. - Sempre adicione
-movflags +faststartao criar arquivos MP4 para reprodução web ou móvel; ele 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 re-encodificação desnecessária. - Para operações em lote, sempre teste o comando em um único arquivo primeiro antes de executar em todo o diretório.
- Prefira o modo CRF ao modo de bitrate para codificação de um único passo; ele produz qualidade consistente em diferentes tipos de conteúdo.