claude-music-web
Starts the local claude-music web dashboard: a minimalist browser app for generating songs with style buttons, live progress, a waveform player, a rated library, downloads, and one-click similar generations. Runs entirely on 127.0.0.1 with no cloud calls.
AgriciDaniel · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add AgriciDaniel/claude-music --skill claude-music-web技能说明
name: claude-music-web description: > Starts the local claude-music web dashboard: a minimalist browser app for generating songs with style buttons, live progress, a waveform player, a rated library, downloads, and one-click similar generations. Runs entirely on 127.0.0.1 with no cloud calls. when_to_use: > Use when the user asks for the music dashboard, web UI, browser app, or a visual way to generate and browse songs. allowed-tools:
- Bash
- Read
claude-music-web: Browser Dashboard
Start
bash ~/.claude/skills/claude-music/scripts/music_web.sh
The launcher starts a stdlib-only Python server bound to 127.0.0.1 (default
port 8765, auto-increments if taken), prints the URL, and opens the browser.
Report the URL to the user and mention Ctrl-C stops it.
Custom port:
bash ~/.claude/skills/claude-music/scripts/music_web.sh 9000
What the dashboard does
- One generate box: prompt text plus multi-select genre pills (from
references/genre-recipes.md) and presets. - Live progress percentage while the engine runs (
--progressNDJSON events). - Player with waveform bars animating to the audio.
- Library backed by the configured
output_dir, with 1-5 star ratings stored in<output_dir>/.claude-music/meta/sidecars. - Download, open the output folder, and generate a similar track (same prompt/settings, fresh seed).
- Drag and drop your own audio file onto the page to add it to the library, then: Audit (ffprobe + loudnorm report with fix suggestions), Optimize (two-pass loudness normalization for Spotify/Apple/YouTube/TikTok/podcast), or Similar (cover-mode generation from the audio with a Loose/Balanced/ Faithful strength choice).
- The player waveform is the real silhouette of the track; click it to seek, and the played portion fills in brand orange.
Notes
- Only one generation runs at a time (VRAM); concurrent requests get 409.
- If config.json still has
CHANGE_ME, the page shows setup instructions; runinstall.shfirst. - The server never binds non-loopback addresses; do not expose it manually.