Communitygithub.com

FFmpeg para Produção de Vídeo

Processamento de vídeo e áudio com FFmpeg. Use para conversão de formatos, redimensionamento, compressão, extração de áudio e preparação de assets para Remotion. Os gatilhos incluem converter GIF para MP4, redimensionar vídeo, extrair áudio, comprimir arquivos ou qualquer tarefa de transformação de mídia.

O que é FFmpeg para Produção de Vídeo?

Esta skill fornece um guia completo de FFmpeg focado em produção de vídeo, especialmente otimizado para projetos Remotion. Ela cobre operações essenciais como conversão de GIF para MP4 com parâmetros de compatibilidade, redimensionamento de vídeo com preenchimento ou corte, compressão usando CRF e presets, extração e conversão de áudio, corte e ajuste de velocidade. A skill também inclui padrões específicos para Remotion, como cálculo de fator de velocidade e preparação de gravações de demonstração. A seção de otimização por plataforma detalha como gerar vídeos otimizados para YouTube, Twitter/X, LinkedIn, web e GIFs, com comandos bash para exportação em lote. O conteúdo explica as flags e parâmetros, fornece dicas de qualidade com tabelas de referência e inclui tratamento de erros comuns. É útil para desenvolvedores que precisam processar assets de mídia de forma eficiente para diferentes plataformas de distribuição.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Zuhair-01/claude-skills-and-systems/tree/HEAD/skills/ffmpeg

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que FFmpeg para Produção de Vídeo faz?

FFmpeg é a ferramenta essencial para processamento de vídeo/áudio. Esta skill cobre operações comuns para projetos de vídeo Remotion.

Referência Rápida

GIF para MP4 (compatível com Remotion)

ffmpeg -i input.gif -movflags faststart -pix_fmt yuv420p \
  -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" output.mp4

Por que estas flags:

  • -movflags faststart - Move os metadados para o início para streaming na web
  • -pix_fmt yuv420p - Garante compatibilidade com a maioria dos players
  • scale=trunc(...) - Força dimensões pares (exigido pela maioria dos codecs)

Redimensionar Vídeo

# Para 1920x1080 (manter proporção, adicionar barras pretas)
ffmpeg -i input.mp4 -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2" output.mp4

# Para 1920x1080 (cortar para preencher)
ffmpeg -i input.mp4 -vf "scale=1920:1080:force_original_aspect_ratio=increase,crop=1920:1080" output.mp4

# Redimensionar pela largura, altura automática
ffmpeg -i input.mp4 -vf "scale=1280:-2" output.mp4

Comprimir Vídeo

# Boa qualidade, arquivo menor (CRF 23 é o padrão, menor = melhor qualidade)
ffmpeg -i input.mp4 -c:v libx264 -crf 23 -preset medium -c:a aac -b:a 128k output.mp4

# Compressão agressiva para visualização na web
ffmpeg -i input.mp4 -c:v libx264 -crf 28 -preset fast -c:a aac -b:a 96k output.mp4

# Tamanho de arquivo alvo (ex.: ~10MB para vídeo de 60s = ~1.3Mbps)
ffmpeg -i input.mp4 -c:v libx264 -b:v 1300k -c:a aac -b:a 128k output.mp4

Extrair Áudio

# Extrair para MP3
ffmpeg -i input.mp4 -vn -acodec libmp3lame -q:a 2 output.mp3

# Extrair para AAC
ffmpeg -i input.mp4 -vn -acodec aac -b:a 192k output.m4a

# Extrair para WAV (não comprimido)
ffmpeg -i input.mp4 -vn output.wav

Converter Formatos de Áudio

# M4A para MP3 (para amostras de voz ElevenLabs)
ffmpeg -i input.m4a -codec:a libmp3lame -qscale:a 2 output.mp3

# WAV para MP3
ffmpeg -i input.wav -codec:a libmp3lame -b:a 192k output.mp3

# Ajustar volume
ffmpeg -i input.mp3 -filter:a "volume=1.5" output.mp3

Cortar Vídeo

# Cortar a partir de um timestamp por duração (recomendado - confiável)
ffmpeg -i input.mp4 -ss 00:00:30 -t 00:00:15 -c:v libx264 -c:a aac output.mp4

# Cortar de um timestamp para outro
ffmpeg -i input.mp4 -ss 00:00:30 -to 00:00:45 -c:v libx264 -c:a aac output.mp4

# Cópia de stream (mais rápido, mas pode perder frames nos pontos de corte)
# Use apenas quando a origem tiver keyframes frequentes
ffmpeg -i input.mp4 -ss 00:00:30 -t 00:00:15 -c copy output.mp4

Nota: A reencodificação é recomendada para cortes. A cópia de stream (-c copy) pode descartar silenciosamente vídeo se o ponto de busca não alinhar com um keyframe.

Acelerar / Desacelerar

# Velocidade 2x (vídeo e áudio)
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]" -map "[v]" -map "[a]" output.mp4

# Velocidade 0.5x (câmera lenta)
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=2.0*PTS[v];[0:a]atempo=0.5[a]" -map "[v]" -map "[a]" output.mp4

# Apenas vídeo (sem áudio)
ffmpeg -i input.mp4 -filter:v "setpts=0.5*PTS" -an output.mp4

Concatenar Vídeos

# Criar lista de arquivos
echo "file 'clip1.mp4'" > list.txt
echo "file 'clip2.mp4'" >> list.txt
echo "file 'clip3.mp4'" >> list.txt

# Concatenar (mesmo codec/resolução)
ffmpeg -f concat -safe 0 -i list.txt -c copy output.mp4

# Concatenar com reencodificação (fontes diferentes)
ffmpeg -f concat -safe 0 -i list.txt -c:v libx264 -c:a aac output.mp4

Adicionar Fade In/Out

# Fade in no primeiro 1 segundo, fade out no último 1 segundo (vídeo 30fps)
ffmpeg -i input.mp4 -vf "fade=t=in:st=0:d=1,fade=t=out:st=9:d=1" -c:a copy output.mp4

# Fade de áudio
ffmpeg -i input.mp4 -af "afade=t=in:st=0:d=1,afade=t=out:st=9:d=1" -c:v copy output.mp4

Obter Informações do Vídeo

# Duração, resolução, informações do codec
ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 input.mp4

# Informações completas
ffprobe -v quiet -print_format json -show_format -show_streams input.mp4

Padrões Específicos do Remotion

Ajuste de Velocidade de Vídeo para Remotion

Quando usar FFmpeg vs playbackRate do Remotion:

CenárioUse FFmpegUse Remotion
Velocidade constante (1.5x, 2x)Ambos funcionam✅ Mais simples
Velocidades extremas (>4x ou <0.25x)✅ Mais confiávelPode ter problemas
Velocidade variável (acelerar ao longo do tempo)✅ Pré-processarSolução complexa necessária
Precisa de sincronia de áudio perfeita✅ GarantidoGeralmente OK
Demonstração precisa caber no tempo da narração✅ Pré-calcularAjuste em tempo de execução

Limitação do Remotion: playbackRate deve ser constante. Interpolação dinâmica como playbackRate={interpolate(frame, [0, 100], [1, 5])} não funcionará corretamente porque o Remotion avalia os frames independentemente.

# Acelerar demonstração para caber em uma cena (ex.: 60s de demo em 20s = velocidade 3x)
ffmpeg -i demo-raw.mp4 \
  -filter_complex "[0:v]setpts=0.333*PTS[v];[0:a]atempo=3.0[a]" \
  -map "[v]" -map "[a]" \
  public/demos/demo-fast.mp4

# Câmera lenta para ênfase (velocidade 0.5x)
ffmpeg -i action.mp4 \
  -filter_complex "[0:v]setpts=2.0*PTS[v];[0:a]atempo=0.5[a]" \
  -map "[v]" -map "[a]" \
  public/demos/action-slow.mp4

# Acelerar sem áudio (comum para gravações de tela)
ffmpeg -i demo.mp4 -filter:v "setpts=0.5*PTS" -an public/demos/demo-2x.mp4

# Efeito timelapse (velocidade 10x, sem áudio)
ffmpeg -i long-demo.mp4 -filter:v "setpts=0.1*PTS" -an public/demos/timelapse.mp4

Calcular fator de velocidade:

  • Para caber X segundos de vídeo em Y segundos de cena: velocidade = X / Y
  • Multiplicador setpts = 1 / velocidade (ex.: velocidade 3x = setpts=0.333*PTS)
  • Valor atempo = velocidade (ex.: velocidade 3x = atempo=3.0)

Velocidade extrema de áudio (>2x): Encadeie filtros atempo (cada um limitado ao intervalo 0.5-2.0):

# Áudio 4x velocidade
-filter_complex "[0:a]atempo=2.0,atempo=2.0[a]"

# Áudio 8x velocidade
-filter_complex "[0:a]atempo=2.0,atempo=2.0,atempo=2.0[a]"

Preparar Gravação de Demonstração para Remotion

# 1080p padrão, 30fps, pronto para Remotion
ffmpeg -i raw-recording.mp4 \
  -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2,fps=30" \
  -c:v libx264 -crf 18 -preset slow \
  -c:a aac -b:a 192k \
  -movflags faststart \
  public/demos/demo.mp4

Gravação de Tela para Asset Remotion

# De gravação iPhone/iPad (geralmente 60fps, resolução variável)
ffmpeg -i iphone-recording.mov \
  -vf "scale=1920:-2,fps=30" \
  -c:v libx264 -crf 20 \
  -an \
  public/demos/mobile-demo.mp4

Converter GIFs em Lote

for f in assets/*.gif; do
  ffmpeg -i "$f" -movflags faststart -pix_fmt yuv420p \
    -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" \
    "public/demos/$(basename "$f" .gif).mp4"
done

Problemas Comuns

"Altura não divisível por 2"

Adicione filtro de escala: -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2"

Vídeo não reproduz no navegador

Use: -movflags faststart -pix_fmt yuv420p -c:v libx264

Áudio fora de sincronia após mudança de velocidade

Use filter_complex com atempo: -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]"

Arquivo muito grande

Aumente CRF (23→28) ou reduza a resolução

Diretrizes de Qualidade

Caso de UsoCRFPresetNotas
Arquivo/Mestre18slowMelhor qualidade, arquivos grandes
Produção20-22mediumBom equilíbrio
Web/Pré-visualização23-25fastArquivos menores
Rascunho/Rápido28+veryfastCodificação rápida

Otimização de Saída por Plataforma

Após o Remotion renderizar seu vídeo (normalmente para out/video.mp4), use FFmpeg para otimizar para cada plataforma de distribuição.

Integração de Fluxo de Trabalho

Renderização Remotion (mestre)     Otimização FFmpeg           Upload na plataforma
       ↓                            ↓                       ↓
   out/video.mp4  ────────→  out/video-youtube.mp4  ───→  YouTube
                  ────────→  out/video-twitter.mp4  ───→  Twitter/X
                  ────────→  out/video-linkedin.mp4 ───→  LinkedIn
                  ────────→  out/video-web.mp4      ───→  Incorporação em site

YouTube (Configurações Recomendadas)

O YouTube reencoda tudo, então faça upload com alta qualidade:

# Otimizado para YouTube (1080p)
ffmpeg -i out/video.mp4 \
  -c:v libx264 -preset slow -crf 18 \
  -profile:v high -level 4.0 \
  -bf 2 -g 30 \
  -c:a aac -b:a 192k -ar 48000 \
  -movflags +faststart \
  out/video-youtube.mp4

# YouTube Shorts (vertical 1080x1920)
ffmpeg -i out/video.mp4 \
  -vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2" \
  -c:v libx264 -crf 18 -c:a aac -b:a 192k \
  out/video-shorts.mp4

Twitter/X

Twitter tem limites rigorosos: máx. 140s, 512MB, 1920x1200:

# Otimizado para Twitter (abaixo de 15MB para upload rápido)
ffmpeg -i out/video.mp4 \
  -c:v libx264 -preset medium -crf 24 \
  -profile:v main -level 3.1 \
  -vf "scale='min(1280,iw)':'min(720,ih)':force_original_aspect_ratio=decrease" \
  -c:a aac -b:a 128k -ar 44100 \
  -movflags +faststart \
  -fs 15M \
  out/video-twitter.mp4

# Verificar tamanho do arquivo e duração
ffprobe -v error -show_entries format=duration,size -of csv=p=0 out/video-twitter.mp4

LinkedIn

LinkedIn prefere MP4 com áudio AAC, máx. 10 minutos:

# Otimizado para LinkedIn
ffmpeg -i out/video.mp4 \
  -c:v libx264 -preset medium -crf 22 \
  -profile:v main \
  -vf "scale='min(1920,iw)':'min(1080,ih)':force_original_aspect_ratio=decrease" \
  -c:a aac -b:a 192k -ar 48000 \
  -movflags +faststart \
  out/video-linkedin.mp4

Site/Incorporação (Otimizado para Carregamento Rápido)

# MP4 otimizado para web (arquivo pequeno, carregamento progressivo)
ffmpeg -i out/video.mp4 \
  -c:v libx264 -preset medium -crf 26 \
  -profile:v baseline -level 3.0 \
  -vf "scale=1280:720" \
  -c:a aac -b:a 128k \
  -movflags +faststart \
  out/video-web.mp4

# Alternativa WebM (melhor compressão, suporte mais amplo do navegador)
ffmpeg -i out/video.mp4 \
  -c:v libvpx-vp9 -crf 30 -b:v 0 \
  -vf "scale=1280:720" \
  -c:a libopus -b:a 128k \
  -deadline good \
  out/video-web.webm

GIF (para Pré-visualizações/Miniaturas)

# GIF de alta qualidade (primeiros 5 segundos)
ffmpeg -i out/video.mp4 -t 5 \
  -vf "fps=15,scale=480:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" \
  out/preview.gif

# GIF de arquivo menor
ffmpeg -i out/video.mp4 -t 3 \
  -vf "fps=10,scale=320:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" \
  out/preview-small.gif

Requisitos de Plataforma - Referência Rápida

PlataformaResolução Máx.Tamanho Máx.Duração Máx.Áudio
YouTube8K256GB12 horasAAC 48kHz
Twitter/X1920x1200512MB140sAAC 44.1kHz
LinkedIn4096x23045GB10 minAAC 48kHz
Instagram Feed1080x13504GB60sAAC 48kHz
Instagram Reels1080x19204GB90sAAC 48kHz
TikTok1080x1920287MB10 minAAC

Exportação em Lote para Todas as Plataformas

#!/bin/bash
# salvar como: export-all-platforms.sh
INPUT="out/video.mp4"

# YouTube (alta qualidade)
ffmpeg -i "$INPUT" -c:v libx264 -preset slow -crf 18 \
  -c:a aac -b:a 192k -movflags +faststart \
  out/video-youtube.mp4

# Twitter (comprimido)
ffmpeg -i "$INPUT" -c:v libx264 -crf 24 \
  -vf "scale='min(1280,iw)':'-2'" \
  -c:a aac -b:a 128k -movflags +faststart \
  out/video-twitter.mp4

# LinkedIn
ffmpeg -i "$INPUT" -c:v libx264 -crf 22 \
  -c:a aac -b:a 192k -movflags +faststart \
  out/video-linkedin.mp4

# Incorporação web (pequeno)
ffmpeg -i "$INPUT" -c:v libx264 -crf 26 \
  -vf "scale=1280:720" \
  -c:a aac -b:a 128k -movflags +faststart \
  out/video-web.mp4

echo "Exportado:"
ls -lh out/video-*.mp4

Tratamento de Erros

Erros comuns e correções ao processar vídeo:

# Verificar se FFmpeg teve sucesso
ffmpeg -i input.mp4 -c:v libx264 output.mp4 && echo "Sucesso" || echo "Falhou: verifique o arquivo de entrada"

# Validar se o arquivo de saída é reproduzível
ffprobe -v error -select_streams v:0 -show_entries stream=codec_name -of csv=p=0 output.mp4

# Obter informações detalhadas de erro
ffmpeg -v error -i input.mp4 -f null - 2>&1 | head -20

Lidando com Falhas Comuns

ErroCausaCorreção
"No such file"Caminho de entrada erradoVerifique o caminho, use aspas para espaços
"Invalid data"Entrada corrompidaRefaça o download ou regrave a fonte
"height not divisible by 2"Dimensões ímparesAdicione filtro de escala com trunc
"encoder not found"Codec ausenteInstale FFmpeg com codecs completos
Saída 0 bytesFalha silenciosaVerifique a saída completa do ffmpeg para erros

Feedback & Contribuições

Se esta skill estiver faltando informações ou puder ser melhorada:

  • Faltando um comando? Descreva o que você precisava
  • Encontrou um erro? Informe o que está errado
  • Quer contribuir? Posso ajudá-lo a:
    1. Atualizar esta skill com melhorias
    2. Criar um PR para github.com/digitalsamba/claude-code-video-toolkit

Basta dizer "melhore esta skill" e eu o guiarei na atualização de .claude/skills/ffmpeg/SKILL.md.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

Zuhair-01/claude-skills-and-systems

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Zuhair-01/claude-skills-and-systems

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Zuhair-01/claude-skills-and-systems

Edit existing videos using AI — remix style, upscale, remove background, and add audio via fal.ai's hosted video models.

Zuhair-01/claude-skills-and-systems

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Zuhair-01/claude-skills-and-systems

Read-only queue dashboard for workspace-aware ship. (gstack)

Zuhair-01/claude-skills-and-systems

Generate HeyGen presenter videos via the v3 Video Agent pipeline — handles Frame Check (aspect ratio correction), prompt engineering, avatar resolution, and voice selection. Required for any HeyGen video generation. Replaces deprecated endpoints with v3. Use when: (1) generating any HeyGen video (via API or otherwise), (2) sending a personalized video message (outreach, update, announcement, pitch, knowledge), (3) creating a HeyGen presenter-led explainer, tutorial, or product demo with a human face, (4) "make a video of me saying...", "send a video to my leads", "record an update for my team", "create a video pitch", "make a loom-style message", "I want to appear in this video", "generate a HeyGen video", "make a talking head video". Accepts avatar_id from heygen-avatar for identity-first HeyGen videos, or uses a stock presenter. Returns video share URL + HeyGen session URL for iteration. Chain signal: when the user wants to create/design an avatar AND make a video in the same request, run heygen-avatar f...

Zuhair-01/claude-skills-and-systems

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

Zuhair-01/claude-skills-and-systems

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Zuhair-01/claude-skills-and-systems

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

Habilidades Relacionadas