FFmpeg
Inspecionar e Explorar
# Mostrar todas as informações dos streams (codec, resolução, bitrate, duração)
ffprobe -v error -show_format -show_streams input.mp4
# Resumo em uma linha: duração, tamanho, bitrate
ffprobe -v error -show_entries format=duration,size,bit_rate -of default=noprint_wrappers=1 input.mp4
# Mostrar resolução e taxa de quadros do vídeo
ffprobe -v error -select_streams v:0 -show_entries stream=width,height,r_frame_rate,codec_name -of csv=p=0 input.mp4
# Listar todos os codecs suportados
ffmpeg -codecs
# Listar todos os formatos suportados
ffmpeg -formats
# Listar codificadores disponíveis
ffmpeg -encoders
Converter Entre Formatos
# MP4 para MKV (copiar streams, sem recodificar -- rápido)
ffmpeg -i input.mp4 -c copy output.mkv
# MKV para MP4 (recodificar se codecs forem incompatíveis com o contêiner MP4)
ffmpeg -i input.mkv -c:v libx264 -c:a aac output.mp4
# AVI para MP4
ffmpeg -i input.avi -c:v libx264 -c:a aac output.mp4
# MOV para MP4 (comum para vídeos de iPhone)
ffmpeg -i input.mov -c:v libx264 -c:a aac -movflags +faststart output.mp4
# MP4 para WebM (VP9 + Opus para web)
ffmpeg -i input.mp4 -c:v libvpx-vp9 -crf 30 -b:v 0 -c:a libopus output.webm
# Qualquer formato, deixe o FFmpeg escolher os codecs para o contêiner de destino
ffmpeg -i input.avi output.mp4
Comprimir Vídeo
# Modo CRF (qualidade constante). CRF mais baixo = melhor qualidade, arquivo maior.
# CRF 18 = visualmente sem perdas, 23 = padrão, 28 = menor mas com perdas visíveis.
ffmpeg -i input.mp4 -c:v libx264 -crf 23 -preset medium -c:a aac -b:a 128k output.mp4
# Codificação mais rápida, arquivo maior
ffmpeg -i input.mp4 -c:v libx264 -crf 23 -preset fast -c:a copy output.mp4
# Codificação mais lenta, arquivo menor (use para arquivamento)
ffmpeg -i input.mp4 -c:v libx264 -crf 23 -preset slow -c:a aac output.mp4
# H.265 para arquivos ~50% menores na mesma qualidade (codifica mais lentamente)
ffmpeg -i input.mp4 -c:v libx265 -crf 28 -preset medium -c:a aac output.mp4
# Definir um tamanho de arquivo específico (ex.: 25 MB para um vídeo de 60s)
# Calcular bitrate: (25 * 8192) / 60 = ~3413 kbps total. Subtrair ~128 para áudio.
ffmpeg -i input.mp4 -c:v libx264 -b:v 3285k -pass 1 -an -f null /dev/null && \
ffmpeg -i input.mp4 -c:v libx264 -b:v 3285k -pass 2 -c:a aac -b:a 128k output.mp4
Extrair Áudio
# Extrair áudio como MP3
ffmpeg -i input.mp4 -vn -c:a libmp3lame -q:a 2 output.mp3
# Extrair áudio como AAC (copiar se já for AAC)
ffmpeg -i input.mp4 -vn -c:a copy output.aac
# Extrair áudio como WAV (sem compressão)
ffmpeg -i input.mp4 -vn -c:a pcm_s16le output.wav
# Extrair áudio como FLAC (sem perdas)
ffmpeg -i input.mp4 -vn -c:a flac output.flac
Converter Formatos de Áudio
# WAV para MP3 (qualidade VBR 2, aproximadamente 190 kbps)
ffmpeg -i input.wav -c:a libmp3lame -q:a 2 output.mp3
# MP3 para AAC
ffmpeg -i input.mp3 -c:a aac -b:a 192k output.m4a
# FLAC para MP3
ffmpeg -i input.flac -c:a libmp3lame -q:a 0 output.mp3
# WAV para OGG Vorbis
ffmpeg -i input.wav -c:a libvorbis -q:a 5 output.ogg
# WAV para Opus (melhor relação qualidade/tamanho)
ffmpeg -i input.wav -c:a libopus -b:a 128k output.opus
# Qualquer áudio para WAV (para edição ou compatibilidade)
ffmpeg -i input.mp3 -c:a pcm_s16le -ar 44100 output.wav
Cortar e Podar
# Cortar de 00:01:30 até 00:03:00 sem recodificar (rápido, pode ter problemas com keyframes)
ffmpeg -ss 00:01:30 -to 00:03:00 -i input.mp4 -c copy output.mp4
# Cortar com recodificação (precisão de quadro)
ffmpeg -ss 00:01:30 -to 00:03:00 -i input.mp4 -c:v libx264 -c:a aac output.mp4
# Cortar os primeiros 30 segundos
ffmpeg -ss 0 -t 30 -i input.mp4 -c copy output.mp4
# Cortar os últimos 30 segundos (requer saber a duração, ou usar início negativo)
ffmpeg -sseof -30 -i input.mp4 -c copy output.mp4
# Remover os primeiros 10 segundos
ffmpeg -ss 10 -i input.mp4 -c copy output.mp4
Criar GIF
# GIF básico (baixa qualidade, simples)
ffmpeg -i input.mp4 -vf "fps=10,scale=480:-1" output.gif
# GIF de alta qualidade com geração de paleta (dois passos)
ffmpeg -i input.mp4 -vf "fps=15,scale=480:-1:flags=lanczos,palettegen" palette.png && \
ffmpeg -i input.mp4 -i palette.png -lavfi "fps=15,scale=480:-1:flags=lanczos [x]; [x][1:v] paletteuse" output.gif
# GIF a partir de um segmento específico (5 segundos começando em 00:00:30)
ffmpeg -ss 00:00:30 -t 5 -i input.mp4 -vf "fps=15,scale=480:-1:flags=lanczos,palettegen" palette.png && \
ffmpeg -ss 00:00:30 -t 5 -i input.mp4 -i palette.png -lavfi "fps=15,scale=480:-1:flags=lanczos [x]; [x][1:v] paletteuse" output.gif
Redimensionar e Escalar
# Redimensionar para 1280x720
ffmpeg -i input.mp4 -vf "scale=1280:720" -c:a copy output.mp4
# Redimensionar largura para 1280, manter proporção (-1 calcula automaticamente, -2 garante número par)
ffmpeg -i input.mp4 -vf "scale=1280:-2" -c:a copy output.mp4
# Redimensionar para 50% do tamanho original
ffmpeg -i input.mp4 -vf "scale=iw/2:ih/2" -c:a copy output.mp4
# Redimensionar para caber em 1920x1080, mantendo proporção (sem aumentar escala)
ffmpeg -i input.mp4 -vf "scale='min(1920,iw)':'min(1080,ih)':force_original_aspect_ratio=decrease" -c:a copy output.mp4
Legendas
# Legendas fixas (queimadas no vídeo, sempre visíveis)
ffmpeg -i input.mp4 -vf "subtitles=subs.srt" output.mp4
# Legendas fixas com estilo personalizado
ffmpeg -i input.mp4 -vf "subtitles=subs.srt:force_style='FontSize=24,PrimaryColour=&HFFFFFF'" output.mp4
# Legendas flexíveis (usuário pode ligar/desligar, MP4)
ffmpeg -i input.mp4 -i subs.srt -c copy -c:s mov_text output.mp4
# Legendas flexíveis (MKV, suporta mais formatos incluindo ASS)
ffmpeg -i input.mp4 -i subs.srt -c copy -c:s srt output.mkv
# Extrair legendas do vídeo
ffmpeg -i input.mkv -map 0:s:0 output.srt
Juntar e Concatenar
# Concatenar vídeos (mesmo codec, resolução, taxa de quadros)
# Primeiro crie uma lista de arquivos:
# file 'parte1.mp4'
# file 'parte2.mp4'
# file 'parte3.mp4'
ffmpeg -f concat -safe 0 -i lista_arquivos.txt -c copy output.mp4
# Gerar a lista de arquivos a partir do shell
for f in parte*.mp4; do echo "file '$f'"; done > lista_arquivos.txt
ffmpeg -f concat -safe 0 -i lista_arquivos.txt -c copy output.mp4
# Concatenar com recodificação (quando os formatos diferem)
ffmpeg -f concat -safe 0 -i lista_arquivos.txt -c:v libx264 -c:a aac output.mp4
# Combinar vídeo e áudio de arquivos separados
ffmpeg -i video.mp4 -i audio.mp3 -c:v copy -c:a aac -shortest output.mp4
# Substituir a faixa de áudio em um vídeo
ffmpeg -i video.mp4 -i novoaudio.mp3 -c:v copy -c:a aac -map 0:v:0 -map 1:a:0 output.mp4
Extrair Quadros
# Extrair um quadro em um instante específico
ffmpeg -ss 00:01:30 -i input.mp4 -frames:v 1 quadro.png
# Extrair um quadro a cada segundo
ffmpeg -i input.mp4 -vf "fps=1" quadros_%04d.png
# Extrair um quadro a cada 10 segundos
ffmpeg -i input.mp4 -vf "fps=1/10" quadros_%04d.png
# Extrair todos os quadros (atenção: gera muitos arquivos)
ffmpeg -i input.mp4 quadros_%06d.png
# Criar uma folha de miniaturas (grade 4x4)
ffmpeg -i input.mp4 -vf "select='not(mod(n\,100))',scale=320:180,tile=4x4" -frames:v 1 miniaturas.png
Gravação de Tela
# macOS -- gravar tela inteira
ffmpeg -f avfoundation -framerate 30 -i "1:0" -c:v libx264 -preset ultrafast -crf 18 output.mp4
# macOS -- listar dispositivos disponíveis
ffmpeg -f avfoundation -list_devices true -i ""
# macOS -- gravar tela com áudio
ffmpeg -f avfoundation -framerate 30 -i "1:0" -c:v libx264 -preset ultrafast -c:a aac output.mp4
# Linux (X11) -- gravar tela inteira
ffmpeg -f x11grab -framerate 30 -video_size 1920x1080 -i :0.0 -c:v libx264 -preset ultrafast -crf 18 output.mp4
# Linux (X11) -- gravar uma região (offset x=100,y=200, tamanho 1280x720)
ffmpeg -f x11grab -framerate 30 -video_size 1280x720 -i :0.0+100,200 -c:v libx264 -preset ultrafast output.mp4
# Linux (PipeWire/Wayland) -- usar captura de tela pipewire
# Wayland não suporta x11grab. Use pw-record ou OBS com pipewire.
Acelerar e Desacelerar
# Acelerar vídeo 2x (remover áudio)
ffmpeg -i input.mp4 -vf "setpts=0.5*PTS" -an output.mp4
# Acelerar vídeo 2x e áudio 2x
ffmpeg -i input.mp4 -vf "setpts=0.5*PTS" -af "atempo=2.0" output.mp4
# Desacelerar vídeo 2x com áudio
ffmpeg -i input.mp4 -vf "setpts=2.0*PTS" -af "atempo=0.5" output.mp4
# Acelerar 4x (encadear filtros atempo; cada atempo suporta faixa de 0.5-2.0)
ffmpeg -i input.mp4 -vf "setpts=0.25*PTS" -af "atempo=2.0,atempo=2.0" output.mp4
Remover Áudio
# Remover faixa de áudio, manter vídeo como está
ffmpeg -i input.mp4 -an -c:v copy output.mp4
Referência de Codecs
| Codec | Caso de Uso | Flag de Codificação | Observações |
|---|---|---|---|
| H.264 | Uso geral, maior compatibilidade | -c:v libx264 | Escolha padrão. Funciona em todos os lugares. |
| H.265 | Arquivamento, streaming, conteúdo 4K | -c:v libx265 | ~50% menor que H.264. Codificação mais lenta. |
| VP9 | Distribuição web, hospedagem estilo YouTube | -c:v libvpx-vp9 | Royalty-free. Bom suporte em navegadores. |
| AV1 | Web/streaming de próxima geração (emergente) | -c:v libaom-av1 | Melhor compressão. Codificação muito lenta. |
| AAC | Áudio em contêineres MP4 | -c:a aac | Boa qualidade, suporte universal. |
| Opus | Voz, música, streaming em bitrates baixos | -c:a libopus | Melhor qualidade por bit. Contêiner WebM/OGG. |
| MP3 | Compatibilidade legada de áudio | -c:a libmp3lame | Use quando AAC/Opus não for aceito. |
Guia rápido de decisão:
- Compartilhando na web ou precisa de ampla reprodução? H.264 + AAC em MP4.
- Precisa de arquivos menores e pode esperar mais para codificar? H.265.
- Mirando especificamente em navegadores? VP9 + Opus em WebM.
- Arquivamento e armazenamento são uma preocupação? H.265 ou AV1.
Flags Úteis
-y Sobrescrever saída sem perguntar
-n Nunca sobrescrever saída
-hide_banner Suprimir informações de compilação do FFmpeg
-v error Mostrar apenas erros (saída mais silenciosa)
-movflags +faststart Mover metadados MP4 para o início (melhor para streaming)
-map 0 Copiar todos os streams da entrada
-shortest Parar a codificação quando o stream mais curto terminar
-threads 0 Usar todas as threads de CPU disponíveis