irfanfaraaz/claude-kit/elevenlabs-music

ElevenLabs Audio Generator

Generate music, sound effects, and voice clips via ElevenLabs, and preview them in a grouped browser player.

Setup

• ELEVENLABS_API_KEY must be set in .env at the project root.
• Requires bash, curl, and python3.

Audio Types

Music

bash scripts/generate.sh <output_dir>/music "<prompt>" [duration_seconds] [prompt_influence]

• duration_seconds: 0.5 to 30 (optional, API can infer if omitted).
• prompt_influence: 0 to 1, default 0.3 (higher = closer to prompt).
• Be specific: genre, mood, tempo, instruments, "no vocals" for instrumental.

Sound Effects

bash scripts/generate.sh <output_dir>/sfx "<prompt>" [duration_seconds] [prompt_influence]

• Same endpoint as music; describe sounds instead of songs.
• Good for whooshes, clicks, ambient, UI sounds, impacts.

Voice

bash scripts/generate_voice.sh <output_dir>/voice "<text>" [voice_id] [model_id]

• Default voice: Sarah (EXAVITQu4vr4xnSDxMaL).
• Default model: eleven_flash_v2_5.
• Common voices: Roger (CwhRBWXzGAHq8TQ4Fs17), Charlie (IKne3meq5aSn9XLyUdCD), George (JBFqnCBsd6RMkjVDRZzb), River (SAz9YHcvj6GT2YYXdXww).

Player

Build the grouped player (music/sfx/voice sections with different accent colors):

bash scripts/player.sh <base_dir> <output_html>

Expected directory structure:

<base_dir>/
├── music/*.mp3   # green accent
├── sfx/*.mp3     # yellow accent
└── voice/*.mp3   # blue accent

Any category directory that exists gets included; missing ones are skipped.

Workflow

1. Generate tracks in parallel (one call per track; use & and wait).
2. Organize into music/, sfx/, voice/ subdirectories.
3. Build the player: bash scripts/player.sh <base_dir> <output_html>.
4. Serve locally, for example:

``bash cd <base_dir> && nohup python3 -m http.server <port> > /dev/null 2>&1 & ``

1. Expose via Cloudflare tunnel:

``bash bash skills/cloudflare-tunnel/scripts/tunnel.sh start <port> ``

1. Send the tunnel URL so the user can preview, select favorites, and request more.

Error Handling

• If the API returns a non-200 status, scripts print the error body to stderr and exit non-zero.
• Ensure .env contains a valid ELEVENLABS_API_KEY.