claudeers.
// Claude Plugins

claude-music-video

Claude Code plugin that makes complete music videos from a song: beat-grid analysis, archive or your own footage, optional AI clips through any video MCP, an…

// Claude Plugins[ api ][ claude ]#claude#plugins◷ MIT$open-sourceupdated 12 days ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up claude-music-video (claude-plugin project) into my current project.
Found on https://claudeers.com/claude-music-video
Repo: https://github.com/TheMarco/claude-music-video
Homepage/docs: —
Detected install method: claude-plugin → /plugin install claude-music-video@TheMarco/claude-music-video
Category: plugins. Platforms: api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)

⚠ Unverified / not recently updated — review before pasting a run-this config.

/plugin marketplace add TheMarco/claude-music-video
/plugin install claude-music-video@TheMarco/claude-music-video
// or clone
git clone https://github.com/TheMarco/claude-music-video

// compatibility

Platformsapi
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Music Video Generator

A Claude Code skill that makes complete music videos from a song. You give it the track and a few words about the mood; it analyzes the song's beat grid and sections, finds footage on archive.org or uses your own clips and photos, optionally generates performer clips through any video-generation MCP you connect, cuts everything to the beat, and renders a finished video with the original audio in 16:9, 9:16 or square.

The picture is always your graded footage, full frame. Each video gets its own overlays, type and title, designed for that song inside your brief, and a history file keeps later videos from repeating earlier ones.

Requirements

  • Claude Code
  • Python 3.10-3.13 and ffmpeg on the PATH
  • A GPU with OpenGL 3.3 (the compositor uses moderngl)
  • Optional: any video-generation MCP server (Hedra, Runway, Luma, Kling, Replicate, fal or others) if you want AI-generated performer clips, plus credits with that provider. The plugin works only through the tools of the MCP you have connected. Archive-only videos need no provider and cost nothing.

It runs in Claude Code on your own computer. In claude.ai chat or Cowork the skill can load but can't render, since those have no local Python, ffmpeg or GPU.

Developed and tested on macOS with Apple Silicon. Linux and Windows have fallbacks for fonts, lyrics transcription and headless OpenGL, but are untested.

Install

As a plugin:

claude plugin marketplace add TheMarco/claude-music-video
claude plugin install music-video-generator@music-video

Or copy plugins/music-video-generator/skills/music-video/ to ~/.claude/skills/music-video/.

The plugin itself holds only Markdown, JSON and its icon. The pipeline's Python scripts are in this repository's engine/ folder; on first use the skill downloads that folder from GitHub, pinned to one commit (ENGINE_REV in SKILL.md), into ~/.claude/music-video/engine/<commit>/, and copies the scripts into each project from there.

Use

Start Claude Code in an empty folder with your song in it and ask for a music video ("make a music video for song.mp3, moody and nocturnal, archive footage only"). Installed as a plugin, the skill can also be run directly as /music-video-generator:music-video. It asks its brief questions in one message, waits for your go before downloading, spending credits or rendering, proposes three concepts, and shows still frames before the full render.

Each project gets an mv/ folder with the pipeline scripts, data, clips and renders. Your history of accepted videos lives in ~/.claude/music-video/.

What it runs and where data goes

Everything runs on your machine: Python scripts copied into each project, ffmpeg, and a GPU compositor. Every request the scripts make is anonymous. Network access:

  • github.com: the pipeline scripts, this repository's engine/ folder at the commit pinned in SKILL.md, downloaded once per engine version with curl from codeload.github.com
  • archive.org: searching and downloading public-domain and openly licensed films, anonymously (ia_search.py, ia_fetch.py)
  • your video-generation MCP, only through its own tools: prompts, and the reference photos you choose to send it; finished clips are downloaded from the URLs it returns (fetch_clip.py)
  • Python packages from PyPI during setup
  • the lyrics and background-removal models on first use, downloaded anonymously and checked against pinned checksums (models.py): Whisper large-v3-turbo from huggingface.co into ~/.cache/music-video/models/, and rembg's person model from github.com into rembg's own model folder. Off Apple Silicon, openai-whisper fetches its model from OpenAI's public download server.

Project files stay in the project folder; the history of accepted videos stays in ~/.claude/music-video/. Nothing is sent anywhere else.

Footage rights

You are responsible for the rights to everything in your video. The skill reads license fields on archive.org items and flags items that have none, and it puts source credits on the end card, but check anything you plan to release commercially.

Author

Made by Marco van Hylckama Vlieg: ai-created.com, @AIandDesign on X.

Development

The engine lives in engine/. After changing it, commit, then set ENGINE_REV in plugins/music-video-generator/skills/music-video/SKILL.md to that commit and raise version in plugin.json, so installs download the new engine.

// faq

What is claude-music-video?

Claude Code plugin that makes complete music videos from a song: beat-grid analysis, archive or your own footage, optional AI clips through any video MCP, and a GPU compositor with overlays designed per video.. It is open-source on GitHub.

Is claude-music-video free to use?

claude-music-video is open-source under the MIT license, so it is free to use.

What category does claude-music-video belong to?

claude-music-video is listed under plugins in the Claudeers registry of Claude-compatible tools.

15 views
★ 10 stars
unclaimed
updated 12 days ago

// embed badge

claude-music-video on Claudeers
[![Claudeers](https://claudeers.com/api/badge/claude-music-video.svg)](https://claudeers.com/claude-music-video)

// retro hit counter

claude-music-video hit counter
[![Hits](https://claudeers.com/api/counter/claude-music-video.svg)](https://claudeers.com/claude-music-video)

// reviews

// guestbook

0/500

// related in Claude Plugins

🔓

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

// pluginsmultica-ai/★ 230,631[ claude ]
🔓

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explainin…

// pluginsanthropics/⟨Python⟩★ 156,472[ claude ]
🔓

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

// pluginsHKUDS/⟨Python⟩★ 58,467◷ Apache-2.0[ claude ]
🔓

financial-services — a Claude ecosystem project on GitHub.

// pluginsanthropics/⟨Python⟩★ 41,409◷ Apache-2.0[ claude ]
→ see how claude-music-video connects across the ecosystem