Communitygithub.com

bhubbard/ffmpeg-skill-rs

Fork nativo em Rust de alto desempenho do ffmpeg-skill. Kit de ferramentas determinístico de manipulação de mídia FFmpeg e servidor MCP (Model Context Protocol) para programadores parceiros de IA e criadores.

O que é ffmpeg-skill-rs?

O `ffmpeg-skill-rs` (fms) é uma reimplementação em Rust nativo, de alto desempenho, do popular skill `ffmpeg-skill`. Diferente da versão original baseada em scripts shell/Python, este fork entrega um binário único, autossuficiente e estaticamente vinculado, eliminando dependências de runtime como Node.js ou Python. O principal diferencial é seu servidor MCP (Model Context Protocol) integrado, que permite a agentes de IA como Claude Desktop, Cursor e outros invocarem operações de mídia de forma determinística e com latência de submilissegundos. O skill oferece uma ampla gama de funcionalidades: desde corte e ajuste de proporção, detecção de cenas, até normalização de loudness EBU R128 e criação de GIFs, sempre com aceleração de hardware otimizada para Apple Silicon e Nvidia. Para desenvolvedores e criadores que usam agentes de IA, isso significa que é possível automatizar tarefas complexas de edição de vídeo e áudio sem a fragilidade de scripts, com um contrato de comunicação JSON-RPC 2.0 claro e confiável pelo stdio.

Funciona com✓Claude Code~Codex CLI✓Cursor✓Antigravity✓Gemini CLI
npx skills add bhubbard/ffmpeg-skill-rs

Perguntar na sua IA favorita

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

Documentação

ffmpeg-skill-rs (fms)

ffmpeg-skill-rs é um port e fork nativo em Rust de alto desempenho de kajisho5/ffmpeg-skill. Ele substitui scripts shell/Python frágeis por um único binário nativo autossuficiente e estaticamente vinculado, oferecendo segurança de tipos rigorosa, latência de invocação de submilissegundos e um servidor integrado Model Context Protocol (MCP) baseado em JSON-RPC 2.0 via stdio.

Destaques

  • Sobrecarga Zero: Binário único compilado em Rust nativo (ffmpeg-skill / alias fms). Não requer Python, Node.js ou ambientes pip.
  • Servidor MCP Integrado: Integração instantânea com Claude Desktop, Cursor, Antigravity, Open WebUI e outros agentes de IA (fms mcp).
  • Contrato Determinístico Legível por Máquina: Emite especificações JSON com contract_version: "1.0" para execução confiável de ferramentas por agentes de codificação autônomos.
  • Presets com Aceleração de Hardware: Aproveita automaticamente VideoToolbox da Apple Silicon (h264_videotoolbox, hevc_videotoolbox, prores_videotoolbox), Nvidia NVENC e VAAPI.
  • Corte Inteligente de Silêncio e EBU R128 de Duas Passagens: Remoção contínua de áudio morto e normalização de loudness em nível profissional.

Uso via CLI

# Inspeção de capacidades e aceleração de hardware
fms doctor

# Sondagem profunda de mídia com seletores de campo pontilhados
fms probe input.mp4 --compact
fms probe input.mp4 --field "duration"
fms probe input.mp4 --field "video[0].codec"

# Corte sem perdas ou com precisão de quadro
fms cut input.mp4 --start 00:01:30 --duration 15.5
fms cut input.mp4 --start 10.0 --end 25.0 --accurate -o output.mp4

# Conformação de proporção (preenchimento, corte, desfoque)
fms fit input.mp4 -a 9:16 -m pad --fps 60

# Corte exato em retângulo delimitador
fms crop input.mp4 -W 1080 -H 1080 -x 420 -y 0

# Detecção de barras pretas / letterbox
fms cropdetect movie.mp4 --limit 30 --json

# Presets de entrega para plataformas (YouTube, Reels, TikTok, ProRes, GIF)
fms export input.mov --preset reels
fms export input.mov --preset youtube4k
fms export clip.mp4 --preset gif --fps 15

# Concatenação com transições de crossfade
fms join clip1.mp4 clip2.mp4 clip3.mp4 --transition dissolve --transition-duration 1.0

# Normalização de loudness EBU R128 de duas passagens
fms loudness podcast.wav --preset podcast -o podcast_master.wav

# Remoção de silêncio com corte inteligente
fms silence raw_take.mp4 --noise-db -28 --min-duration 0.4 --remove

# Manipulação de velocidade com preservação de tom (atempo)
fms speedramp video.mp4 --speed 1.5

# Renderização de forma de onda visual e espectrograma
fms waveform audio.mp3 --mode waveform -W 1920 -H 400 -o waveform.png

# Detecção de cortes de cena e extração de miniaturas
fms scenes video.mp4 --threshold 0.35 -d ./thumbnails

# Validador de conformidade com especificações de pré-entrega
fms check final_cut.mp4 --platform reels --json

# Emitir JSON de contrato legível por máquina
fms contract --json

Configuração do Model Context Protocol (MCP)

Adicione ffmpeg-skill à configuração do seu cliente MCP (ex.: claude_desktop_config.json, gemini, ou cursor):

{
  "mcpServers": {
    "ffmpeg-skill": {
      "command": "ffmpeg-skill",
      "args": ["mcp"]
    }
  }
}

Habilidades Relacionadas