Communitygithub.com

bhubbard/ffmpeg-skill-rs

Fork natif Rust haute performance de ffmpeg-skill. Boîte à outils déterministe de manipulation multimédia FFmpeg et serveur MCP (Model Context Protocol) pour programmeurs et créateurs assistés par IA.

Qu'est-ce que ffmpeg-skill-rs ?

`ffmpeg-skill-rs` est un portage et fork natif en Rust de `kajisho5/ffmpeg-skill`, conçu pour offrir une alternative ultra-rapide, fiable et déterministe aux scripts shell/Python. Il remplace les wrappers fragiles par un binaire unique, statique et autonome, garantissant une sécurité de type stricte, une latence d'invocation inférieure à la milliseconde et une intégration immédiate avec les agents IA via un serveur MCP JSON-RPC 2.0 sur stdio. Ce skill est idéal pour les développeurs et créateurs utilisant des plateformes comme Claude Desktop, Cursor, Antigravity ou Open WebUI, qui ont besoin d'outils de manipulation vidéo/audio prévisibles, accélérés matériellement et contrôlables via contrat machine. Parmi ses fonctionnalités clés : inspection matérielle (`fms doctor`), découpage image par image, recadrage intelligent, détection de silence et suppression de temps morts, normalisation audio EBU R128, présets de livraison (YouTube, Reels, TikTok, ProRes, GIF), et génération de formes d'onde. Le tout sans dépendance à Python, Node.js ou tout autre runtime externe.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

ffmpeg-skill-rs (fms)

ffmpeg-skill-rs est un portage natif Rust haute performance et un fork de kajisho5/ffmpeg-skill. Il remplace les scripts shell/Python fragiles par un seul binaire natif statiquement lié, offrant une sécurité de type stricte, une latence d'invocation inférieure à la milliseconde, et un serveur MCP (Model Context Protocol) JSON-RPC 2.0 intégré sur stdio.

Points forts

  • Surcharge d'exécution nulle : Binaire Rust natif compilé unique (ffmpeg-skill / alias fms). Aucun environnement Python, Node.js ou pip requis.
  • Serveur MCP intégré : Intégration instantanée avec Claude Desktop, Cursor, Antigravity, Open WebUI et autres agents IA (fms mcp).
  • Contrat déterministe lisible par machine : Émet des spécifications JSON contract_version: "1.0" pour une exécution fiable des outils par des agents de codage autonomes.
  • Préréglages accélérés par le matériel : Utilise automatiquement VideoToolbox Apple Silicon (h264_videotoolbox, hevc_videotoolbox, prores_videotoolbox), Nvidia NVENC et VAAPI.
  • Coupe intelligente des silences et EBU R128 double passe : Suppression transparente des temps morts et normalisation du volume audio de qualité diffusion.

Utilisation en CLI

# Inspection des capacités et de l'accélération matérielle
fms doctor

# Sondage multimédia approfondi avec sélecteurs de champs pointés
fms probe input.mp4 --compact
fms probe input.mp4 --field "duration"
Fms probe input.mp4 --field "video[0].codec"

# Découpage sans perte ou image par image
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

# Mise en conformité du format d'image (pad, crop, blur)
fms fit input.mp4 -a 9:16 -m pad --fps 60

# Recadrage exact par boîte englobante rectangulaire
fms crop input.mp4 -W 1080 -H 1080 -x 420 -y 0

# Détection des barres noires / letterbox
fms cropdetect movie.mp4 --limit 30 --json

# Préréglages de livraison par plateforme (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

# Concaténation avec transitions fondues
fms join clip1.mp4 clip2.mp4 clip3.mp4 --transition dissolve --transition-duration 1.0

# Normalisation du volume EBU R128 double passe
fms loudness podcast.wav --preset podcast -o podcast_master.wav

# Suppression des silences / temps morts
fms silence raw_take.mp4 --noise-db -28 --min-duration 0.4 --remove

# Manipulation de la vitesse avec préservation du pitch (atempo)
fms speedramp video.mp4 --speed 1.5

# Rendu de forme d'onde et spectrogramme visuels
fms waveform audio.mp3 --mode waveform -W 1920 -H 400 -o waveform.png

# Détection de changements de plan et extraction de vignettes
fms scenes video.mp4 --threshold 0.35 -d ./thumbnails

# Validateur de conformité aux spécifications de livraison
fms check final_cut.mp4 --platform reels --json

# Émission du contrat machine au format JSON
fms contract --json

Configuration du Model Context Protocol (MCP)

Ajoutez ffmpeg-skill à votre configuration client MCP (par ex. claude_desktop_config.json, gemini, ou cursor) :

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

Skills associés