Editar Vídeo
Edite vídeos localmente executando ffmpeg/ffprobe diretamente. Nenhum script de wrapper é necessário.
Pré-requisitos
Instale o ffmpeg (inclui ffprobe):
# macOS
brew install ffmpeg
# Ubuntu/Debian
sudo apt update && sudo apt install -y ffmpeg
# Verifique
ffmpeg -version && ffprobe -version
Referência Rápida
Obter informações do vídeo
ffprobe -v quiet -print_format json -show_format -show_streams video.mp4
Cortar (trim)
ffmpeg -y -ss 00:00:30 -to 00:01:45 -i video.mp4 -c copy trimmed.mp4
Concatenar clipes
# 1. Crie um arquivo de lista
printf "file '%s'\n" clip1.mp4 clip2.mp4 clip3.mp4 > list.txt
# 2. Concatene com cópia de streams
ffmpeg -y -f concat -safe 0 -i list.txt -c copy joined.mp4
Redimensionar para plataforma
ffmpeg -y -i video.mp4 \
-vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2:black" \
-c:a copy tiktok.mp4
Alterar velocidade
# 2x mais rápido
ffmpeg -y -i video.mp4 -filter:v "setpts=0.5*PTS" -filter:a "atempo=2.0" fast.mp4
# 0.5x (câmera lenta)
ffmpeg -y -i video.mp4 -filter:v "setpts=2.0*PTS" -filter:a "atempo=0.5" slow.mp4
Extrair áudio
ffmpeg -y -i video.mp4 -vn -acodec libmp3lame audio.mp3
Substituir áudio
ffmpeg -y -i video.mp4 -i audio.mp3 -c:v copy -map 0:v:0 -map 1:a:0 -shortest output.mp4
Comprimir
ffmpeg -y -i video.mp4 -crf 23 -preset medium -c:a copy compressed.mp4
Converter formato
ffmpeg -y -i video.mov output.mp4
Adicionar sobreposição de imagem
# Logotipo no canto superior direito
ffmpeg -y -i video.mp4 -i logo.png \
-filter_complex "overlay=W-w-10:10" -c:a copy watermarked.mp4
Presets para Plataformas
| Plataforma | Resolução | Filtro scale + pad |
|---|---|---|
| TikTok | 1080 x 1920 | scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2:black |
| YouTube | 1920 x 1080 | scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2:black |
| 1080 x 1350 | scale=1080:1350:force_original_aspect_ratio=decrease,pad=1080:1350:(ow-iw)/2:(oh-ih)/2:black | |
| Quadrado | 1080 x 1080 | scale=1080:1080:force_original_aspect_ratio=decrease,pad=1080:1080:(ow-iw)/2:(oh-ih)/2:black |
| Twitter/X | 1920 x 1080 | scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2:black |
Use o filtro com: ffmpeg -y -i entrada.mp4 -vf "<filtro>" -c:a copy saida.mp4
Dicas
- Sempre use
-ypara sobrescrever a saída sem perguntar. - Use
-c copyquando precisar apenas cortar/juntar (sem re-codificação, muito rápido). - CRF menor = melhor qualidade, arquivo maior. A faixa 18-28 é típica; 23 é o padrão.
- Para receitas detalhadas e explicações de flags, veja
references/operations.md.