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 ativos 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 abrangente de comandos FFmpeg otimizados para produção de vídeo, especialmente em projetos com Remotion. Ela cobre operações essenciais como conversão de GIF para MP4, redimensionamento, compressão, extração de áudio, corte, ajuste de velocidade e concatenação, com explicações detalhadas de cada flag e parâmetro. A skill também inclui padrões específicos para Remotion, como preparação de demos, ajuste de velocidade com sincronia de áudio e otimização para diferentes plataformas de distribuição (YouTube, Twitter/X, LinkedIn, Web). Com tabelas de referência rápida para qualidade de compressão e requisitos de plataforma, ela serve como um guia completo para desenvolvedores que precisam processar mídia de forma eficiente e profissional. Além disso, oferece scripts de exportação em lote e soluções para erros comuns, facilitando o fluxo de trabalho de produção de vídeo.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/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 com 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 essas 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 para 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 pré-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/Editar Vídeo

# Cortar do 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 do timestamp ao timestamp
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ápida, mas pode perder quadros nos pontos de corte)
# Use apenas quando a fonte tiver keyframes frequentes
ffmpeg -i input.mp4 -ss 00:00:30 -t 00:00:15 -c copy output.mp4

Nota: A re-codificação é recomendada para cortes. 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 re-codificaçã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 nos primeiros 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 para Remotion

Ajuste de Velocidade de Vídeo para Remotion

Quando usar FFmpeg vs playbackRate do Remotion:

CenárioUsar FFmpegUsar 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
Necessita sincronia de áudio perfeita✅ GarantidoGeralmente ok
Demo precisa ajustar-se ao timing 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 frames independentemente.

# Acelerar demo para caber em uma cena (ex.: demo de 60s 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, remover áudio)
ffmpeg -i long-demo.mp4 -filter:v "setpts=0.1*PTS" -an public/demos/timelapse.mp4

Calcular fator de velocidade:

  • Para encaixar 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 (>2x áudio): Encadear 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 Demo 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 Ativo 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 dessincronizado 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 o 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 (tipicamente 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 re-codifica 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

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

# Otimizado para Twitter (abaixo de 15MB alvo 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áximo 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/Incorporar (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 amplo de navegadores)
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

Referência Rápida de Requisitos por Plataforma

PlataformaResolução MáxTamanho MáxDuraçã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 que 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 erradoVerificar caminho, usar aspas para espaços
"Invalid data"Entrada corrompidaBaixar ou regravar a fonte
"height not divisible by 2"Dimensões ímparesAdicionar filtro de escala com trunc
"encoder not found"Codec ausenteInstalar FFmpeg com codecs completos
Saída 0 bytesFalha silenciosaVerificar saída completa do ffmpeg para erros

Feedback & Contribuições

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

  • Falta 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 20 individual skills — each has its own dedicated page.

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

Biznomad/agent-skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Biznomad/agent-skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

Biznomad/agent-skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

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

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

Habilidades Relacionadas