Repolode
Enviar
kajisho5

kajisho5/ffmpeg-skill

Uma Agent Skill e um servidor MCP com 42 ferramentas locais de edição de vídeo e áudio com FFmpeg para agentes de programação como Claude Code, Cursor e Codex.

Alternativa open source a:DescriptCapCut

Ver no GitHubSite
Estrelas
2,000
Forks
164
Issues abertas
4
Último commit
anteontem

O que é?

ffmpeg-skill permite que um agente de programação edite arquivos de vídeo e áudio chamando scripts Python estruturados que controlam ffmpeg e ffprobe localmente. As 42 ferramentas abrangem cortar e juntar clipes, remover silêncios, ajustar vídeos a uma duração ou proporção, inserir legendas e sobreposições, converter HDR para SDR, normalizar o volume, sincronizar gravações e exportar arquivos ajustados para plataformas como TikTok, Reels, YouTube e X.

Cada ferramenta recebe argumentos tipados em vez de strings de filtro brutas, aceita as opções --dry-run e --json e gera uma análise do resultado. Um contrato legível por máquina descreve as entradas e saídas de cada ferramenta, e as mesmas ferramentas também são disponibilizadas via MCP. O processamento funciona offline, sem chaves de API e usando apenas a biblioteca padrão do Python, mas é necessário ter ffmpeg e python3 instalados.

O projeto é voltado a desenvolvedores que querem que um agente faça edições rotineiras em vídeos locais sem enviá-los a um serviço na nuvem, e que o agente confira o próprio resultado antes de informar que concluiu a tarefa.

Recursos principais

  • 01Corte, junte e remova silêncios de clipes com cópia de stream sem perdas sempre que possível.
  • 02Ajuste vídeos a uma duração e proporção desejadas, incluindo corte para 9:16 e preenchimento com desfoque.
  • 03Insira legendas com temporização no estilo karaokê e ajuste de texto às zonas seguras de cada plataforma.
  • 04Normalize o volume para os níveis de referência EBU R128 e converta vídeos HDR para SDR.
  • 05Disponibilize todas as ferramentas via MCP, com um contrato gerado a partir das definições do argparse.

Casos de uso

  • Permitir que um agente transforme uma gravação longa em um clipe vertical de 60 segundos para Reels ou TikTok.
  • Normalizar o volume em lote e exportar arquivos para podcasts ou redes sociais a partir de uma pasta.
  • Adicionar legendas embutidas e sobreposições a vídeos sem enviá-los a um editor na nuvem.
  • Criar um pipeline de vídeo com scripts que verifica cada resultado com ffprobe antes de encaminhá-lo.

Início rápido

  1. 1

    Instalar a skill para Claude Code

    npx ffmpeg-skill
  2. 2

    Verificar se ffmpeg, ffprobe e os componentes necessários estão disponíveis

    npx ffmpeg-skill doctor
  3. 3

    Ler o contrato de ferramenta legível por máquina

    npx ffmpeg-skill contract --json | head -40

Antes de usar

  • É necessário que ffmpeg e python3 já estejam instalados e disponíveis no PATH.
  • As cópias instaladas pelo instalador não são atualizadas automaticamente; execute novamente o comando de instalação para atualizá-las.
  • Algumas ferramentas, como caption.py, precisam de componentes do FFmpeg, como o filtro subtitles, que podem não estar incluídos em uma instalação básica do Homebrew.

Tópicos

#ffmpeg#video-editing#agent-skills#mcp#audio-processing#captions#loudness-normalization#ai-agents#claude-code#codex

Perguntas frequentes

O que é ffmpeg-skill?
Uma Agent Skill e um servidor MCP com 42 ferramentas locais de edição de vídeo e áudio com FFmpeg para agentes de programação como Claude Code, Cursor e Codex. ffmpeg-skill permite que um agente de programação edite arquivos de vídeo e áudio chamando scripts Python estruturados que controlam ffmpeg e ffprobe localmente. As 42 ferramentas abrangem cortar e juntar clipes, remover silêncios, ajustar vídeos a uma duração ou proporção, inserir legendas e sobreposições, converter HDR para SDR, normalizar o volume, sincronizar gravações e exportar arquivos ajustados para plataformas como TikTok, Reels, YouTube e X.
ffmpeg-skill é gratuito? Qual é a licença?
ffmpeg-skill é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
ffmpeg-skill ainda é mantido?
Manutenção ativa. O último commit de ffmpeg-skill foi em 17 de out. de 2026.
Para que posso usar ffmpeg-skill?
Permitir que um agente transforme uma gravação longa em um clipe vertical de 60 segundos para Reels ou TikTok. Normalizar o volume em lote e exportar arquivos para podcasts ou redes sociais a partir de uma pasta. Adicionar legendas embutidas e sobreposições a vídeos sem enviá-los a um editor na nuvem. Criar um pipeline de vídeo com scripts que verifica cada resultado com ffprobe antes de encaminhá-lo.
Como instalar ffmpeg-skill?
Instalar a skill para Claude Code: npx ffmpeg-skill Verificar se ffmpeg, ffprobe e os componentes necessários estão disponíveis: npx ffmpeg-skill doctor Ler o contrato de ferramenta legível por máquina: npx ffmpeg-skill contract --json | head -40
Onde consigo ffmpeg-skill?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/kajisho5/ffmpeg-skill

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados