Communitygithub.com

FFmpeg

O canivete suíço do processamento de mídia. Lida com praticamente todos os formatos de áudio e vídeo, codecs e containers. Esta skill abrange conversão de formatos, transcodificação, corte, concatenação, filtros, compressão, extração de miniaturas, inserção de legendas, normalização de áudio, criação de GIFs, marca d'água e integração com ferramentas como yt-dlp e gallery-dl.

O que é FFmpeg?

Esta habilidade capacita o agente a realizar tarefas de processamento de mídia usando o FFmpeg, uma ferramenta de linha de comando versátil que suporta quase todos os formatos de áudio e vídeo. Ela é ideal para desenvolvedores e usuários de ferramentas de IA que precisam converter, editar e otimizar arquivos de mídia de forma programática. A habilidade abrange desde conversões básicas de formato (WebM para MP4, MKV para MP4) até operações avançadas como normalização de áudio, criação de GIFs com paleta otimizada, inserção de marca d'água e processamento em lote. Os agentes podem usar `ffprobe` para inspecionar arquivos antes de processá-los, evitando re-encodificações desnecessárias. A habilidade também se integra perfeitamente com yt-dlp para converter downloads de vídeo para formatos compatíveis com dispositivos móveis (H.264+AAC) e com gallery-dl para processar imagens. Instruções passo a passo com exemplos práticos de linha de comando garantem que qualquer agente possa aplicar estas operações de forma eficiente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/TerminalSkills/skills/ffmpeg

Perguntar na sua IA favorita

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

Documentação

O que FFmpeg faz?

Visão Geral

O FFmpeg é o canivete suíço do processamento de mídia. Ele lida com praticamente todos os formatos de áudio e vídeo, codecs e containers existentes. Esta skill abrange conversão de formatos, transcodificação, corte, concatenação, filtros, compressão, extração de miniaturas, inserção de legendas, normalização de áudio, criação de GIFs, marca d'água e integração com ferramentas como yt-dlp e gallery-dl.

Instruções

Passo 1: Instalação

# Ubuntu/Debian
sudo apt install -y ffmpeg

# macOS
brew install ffmpeg

# Verificar
ffmpeg -version
ffprobe -version   # ferramenta de informações de mídia, incluída com ffmpeg

Passo 2: Conversão de Formato

A tarefa mais comum — converter entre formatos de container e codecs.

# WebM → MP4 (re-encodificar para H.264 + AAC para compatibilidade universal)
ffmpeg -i input.webm -c:v libx264 -c:a aac -movflags +faststart output.mp4

# WebM → MP4 (copiar streams se já H.264/AAC — instantâneo, sem perda de qualidade)
ffmpeg -i input.webm -c copy output.mp4

# MKV → MP4 (cópia de stream, sem re-encodificação)
ffmpeg -i input.mkv -c copy output.mp4

# AVI → MP4
ffmpeg -i input.avi -c:v libx264 -crf 23 -c:a aac -b:a 128k output.mp4

# MOV → MP4 (Apple ProRes para H.264)
ffmpeg -i input.mov -c:v libx264 -crf 18 -preset slow -c:a aac output.mp4

# Qualquer formato → MP4 com início rápido otimizado para web
ffmpeg -i input.* -c:v libx264 -crf 23 -preset medium -c:a aac -movflags +faststart output.mp4

CRF (Constant Rate Factor): Controla a qualidade. Menor = melhor qualidade, arquivo maior.

  • 18: Visualmente sem perdas
  • 23: Padrão, bom equilíbrio
  • 28: Arquivo menor, alguma perda de qualidade
  • 51: Pior qualidade

Passo 3: Operações de Áudio

# Extrair áudio do vídeo
ffmpeg -i video.mp4 -vn -c:a copy audio.aac          # Copiar codec (rápido)
ffmpeg -i video.mp4 -vn -c:a libmp3lame -q:a 2 audio.mp3  # Converter para MP3
ffmpeg -i video.mp4 -vn -c:a flac audio.flac          # FLAC sem perdas

# Converter entre formatos de áudio
ffmpeg -i input.wav -c:a libmp3lame -b:a 320k output.mp3
ffmpeg -i input.mp3 -c:a libopus -b:a 128k output.opus
ffmpeg -i input.flac -c:a aac -b:a 256k output.m4a

# Normalizar volume de áudio
ffmpeg -i input.mp3 -af loudnorm=I=-16:LRA=11:TP=-1.5 output.mp3

# Alterar taxa de amostragem
ffmpeg -i input.wav -ar 44100 output.wav

# Mesclar áudio no vídeo
ffmpeg -i video.mp4 -i audio.mp3 -c:v copy -c:a aac -map 0:v:0 -map 1:a:0 output.mp4

Passo 4: Cortar, Aparar e Concatenar

# Aparar a partir de um timestamp por duração
ffmpeg -i input.mp4 -ss 00:01:30 -t 00:00:45 -c copy clip.mp4    # 45s começando em 1:30

# Aparar do início ao timestamp final
ffmpeg -i input.mp4 -ss 00:05:00 -to 00:10:00 -c copy clip.mp4   # 5:00 a 10:00

# Primeiros 30 segundos
ffmpeg -i input.mp4 -t 30 -c copy first30.mp4

# Concatenar arquivos (criar lista de arquivos primeiro)
cat > filelist.txt << 'EOF'
file 'clip1.mp4'
file 'clip2.mp4'
file 'clip3.mp4'
EOF
ffmpeg -f concat -safe 0 -i filelist.txt -c copy output.mp4

# Concatenar com re-encodificação (quando os codecs diferem)
ffmpeg -f concat -safe 0 -i filelist.txt -c:v libx264 -c:a aac output.mp4

Passo 5: Resolução e Compressão

# Redimensionar para 1080p (manter proporção)
ffmpeg -i input.mp4 -vf "scale=-2:1080" -c:v libx264 -crf 23 -c:a copy output.mp4

# Redimensionar para 720p
ffmpeg -i input.mp4 -vf "scale=-2:720" -c:v libx264 -crf 23 -c:a copy output.mp4

# Redimensionar para largura específica (altura automática)
ffmpeg -i input.mp4 -vf "scale=1280:-2" output.mp4

# Comprimir agressivamente (arquivo menor)
ffmpeg -i input.mp4 -c:v libx264 -crf 28 -preset faster -c:a aac -b:a 96k small.mp4

# Codificação de dois passos para tamanho de arquivo alvo
ffmpeg -i input.mp4 -c:v libx264 -b:v 1M -pass 1 -an -f null /dev/null
ffmpeg -i input.mp4 -c:v libx264 -b:v 1M -pass 2 -c:a aac -b:a 128k output.mp4

# Alterar taxa de quadros
ffmpeg -i input.mp4 -r 30 output.mp4

Passo 6: Miniaturas e Capturas de Tela

# Captura única em timestamp
ffmpeg -i input.mp4 -ss 00:01:30 -frames:v 1 thumb.jpg

# Captura a cada 10 segundos
ffmpeg -i input.mp4 -vf "fps=1/10" thumbs/frame_%04d.jpg

# Grade de miniaturas (folha de contato 4x4)
ffmpeg -i input.mp4 -vf "select='not(mod(n,300))',scale=320:-1,tile=4x4" -frames:v 1 grid.jpg

# Extrair primeiro quadro
ffmpeg -i input.mp4 -frames:v 1 first_frame.png

Passo 7: Legendas

# Gravar legendas no vídeo (hardcoded)
ffmpeg -i input.mp4 -vf "subtitles=subs.srt" output.mp4

# Gravar legendas ASS/SSA com estilo
ffmpeg -i input.mp4 -vf "ass=subs.ass" output.mp4

# Adicionar faixa de legenda (soft subs, usuário pode alternar)
ffmpeg -i input.mp4 -i subs.srt -c copy -c:s mov_text output.mp4

# Extrair legendas do vídeo
ffmpeg -i input.mkv -map 0:s:0 subs.srt

Passo 8: Filtros e Efeitos

# Criar GIF a partir de um segmento de vídeo
ffmpeg -i input.mp4 -ss 5 -t 3 -vf "fps=15,scale=480:-1:flags=lanczos" output.gif

# GIF de alta qualidade com paleta
ffmpeg -i input.mp4 -ss 5 -t 3 -vf "fps=15,scale=480:-1:flags=lanczos,palettegen" palette.png
ffmpeg -i input.mp4 -i palette.png -ss 5 -t 3 -lavfi "fps=15,scale=480:-1:flags=lanczos[v];[v][1:v]paletteuse" output.gif

# Adicionar marca d'água
ffmpeg -i input.mp4 -i watermark.png -filter_complex "overlay=W-w-10:H-h-10" output.mp4

# Acelerar / Desacelerar
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]" -map "[v]" -map "[a]" fast.mp4
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=2.0*PTS[v];[0:a]atempo=0.5[a]" -map "[v]" -map "[a]" slow.mp4

# Girar vídeo
ffmpeg -i input.mp4 -vf "transpose=1" rotated.mp4    # 90° sentido horário
ffmpeg -i input.mp4 -vf "transpose=2" rotated.mp4    # 90° sentido anti-horário

# Cortar vídeo (largura:altura:x:y)
ffmpeg -i input.mp4 -vf "crop=1280:720:0:180" cropped.mp4

# Fade in/out
ffmpeg -i input.mp4 -vf "fade=in:0:30,fade=out:870:30" -af "afade=in:0:30,afade=out:870:30" output.mp4

Passo 9: Informações de Mídia

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

# Apenas duração
ffprobe -v quiet -show_entries format=duration -of csv=p=0 input.mp4

# Resolução
ffprobe -v quiet -select_streams v:0 -show_entries stream=width,height -of csv=p=0 input.mp4

# Informações do codec
ffprobe -v quiet -select_streams v:0 -show_entries stream=codec_name -of csv=p=0 input.mp4

Passo 10: Processamento em Lote

# Converter todos os arquivos WebM para MP4
for f in *.webm; do
  ffmpeg -i "$f" -c:v libx264 -crf 23 -c:a aac "${f%.webm}.mp4"
done

# Comprimir todos os arquivos MP4 no diretório
for f in *.mp4; do
  ffmpeg -i "$f" -c:v libx264 -crf 28 -preset fast -c:a aac "compressed_${f}"
done

# Extrair áudio de todos os vídeos
for f in *.mp4; do
  ffmpeg -i "$f" -vn -c:a libmp3lame -q:a 2 "${f%.mp4}.mp3"
done

Exemplos

Exemplo 1: Converter downloads do yt-dlp de WebM para MP4

Prompt do usuário: "Baixei vídeos com yt-dlp, mas eles são todos arquivos .webm. Converta-os para MP4 para que possam ser reproduzidos no meu iPhone."

O agente irá:

  1. Verificar se os arquivos WebM contêm H.264+AAC (cópia de stream possível) ou VP9+Opus (re-encodificação necessária) usando ffprobe.
  2. Para arquivos VP9/Opus, executar: for f in *.webm; do ffmpeg -i "$f" -c:v libx264 -crf 23 -preset medium -c:a aac -movflags +faststart "${f%.webm}.mp4"; done
  3. A flag -movflags +faststart move os metadados para o início do arquivo, permitindo reprodução instantânea em dispositivos móveis e navegadores web.
  4. Relatar resultados da conversão com tamanhos de arquivo antes e depois.

Exemplo 2: Criar um vídeo de melhores momentos a partir de vários clipes

Prompt do usuário: "Tenho 5 clipes de vídeo de uma conferência. Corte as melhores partes e junte-as em um único vídeo com transições de fade."

O agente irá:

  1. Cortar cada clipe para os timestamps especificados usando as flags -ss e -to.
  2. Re-encodificar todos os clipes para codec/resolução correspondentes: ffmpeg -i clip.mp4 -c:v libx264 -crf 23 -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:-1:-1,fade=in:0:15,fade=out:st=DURATION:d=0.5" -c:a aac -ar 44100 segment_N.mp4
  3. Criar uma lista de arquivos concat e mesclar: ffmpeg -f concat -safe 0 -i filelist.txt -c copy highlight_reel.mp4

Diretrizes

  • Ao converter downloads do yt-dlp (tipicamente WebM/VP9+Opus), sempre re-encodificar para H.264+AAC para máxima compatibilidade com dispositivos. Use -c:v libx264 -crf 23 -c:a aac -movflags +faststart.
  • Use cópia de stream (-c copy) sempre que possível para evitar re-encodificação — é instantânea e sem perdas. Apenas re-encodifique ao alterar codecs, aplicar filtros, ou quando os containers de origem e destino forem incompatíveis.
  • Sempre adicione -movflags +faststart ao criar arquivos MP4 para reprodução web ou móvel; ele move o átomo moov para o início do arquivo para streaming instantâneo.
  • Use ffprobe antes do processamento para entender o formato de entrada, evitando re-encodificação desnecessária.
  • Para operações em lote, sempre teste o comando em um único arquivo primeiro antes de executar em todo o diretório.
  • Prefira o modo CRF ao modo de bitrate para codificação de um único passo; ele produz qualidade consistente em diferentes tipos de conteúdo.

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Habilidades Relacionadas