Edição de Vídeo
Edite vídeos localmente executando ffmpeg/ffprobe diretamente. Nenhum script wrapper é necessário.
Pré-requisitos
Instale ffmpeg (inclui ffprobe):
# macOS
brew install ffmpeg
# Ubuntu/Debian
sudo apt update && sudo apt install -y ffmpeg
# Verificar
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
ffmpeg -y -ss 00:00:30 -to 00:01:45 -i video.mp4 -c copy cortado.mp4
Concatenar clipes
# 1. Criar uma lista de arquivos
printf "file '%s'\n" clipe1.mp4 clipe2.mp4 clipe3.mp4 > lista.txt
# 2. Concatenar com cópia do stream
ffmpeg -y -f concat -safe 0 -i lista.txt -c copy unido.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" rapido.mp4
# 0.5x (câmera lenta)
ffmpeg -y -i video.mp4 -filter:v "setpts=2.0*PTS" -filter:a "atempo=0.5" lento.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 saida.mp4
Comprimir
ffmpeg -y -i video.mp4 -crf 23 -preset medium -c:a copy comprimido.mp4
Converter formato
ffmpeg -y -i video.mov saida.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 com_marca_dagua.mp4
Predefinições de Plataforma
| Plataforma | Resolução | Filtro de escala + preenchimento |
|---|---|---|
| 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 solicitar confirmação. - Use
-c copyquando precisar apenas cortar/juntar (sem re-codificação, muito rápido). - CRF mais baixo = melhor qualidade, arquivo maior. Intervalo de 18 a 28 é típico; 23 é o padrão.
- Para receitas detalhadas e explicação de flags, veja
references/operations.md.