puntorigen/avatar-skills / audio-theater
audio-theater
VerifiedTurn a dialogue, a story with dialogue, or a one-line idea into multi-character audio using Gemini TTS, with word-level timecoded transcription (WhisperX or local faster-whisper), realistic ambient/foley SFX (ElevenLabs or the sound-effects skill), and instrumental score/music (MiniMax Music 2.6). Optional stereo spatialization (pan + distance + movement) and an ffmpeg mix with sidechain ducking (music ducks under voices+SFX). Three modes - theater (dramatized radio play), lipsync (clean per-line clips <=15s plus a manifest for the seedance-2 skill), and podcast (two hosts with intro/bed/outro music). With music it delivers three tracks (full mix, music-only, and a no-music stem for animated storyboards) plus a timecoded transcript and per-line voice + SFX/music files. Use for an audio drama, audio theater / audioteatro / radioteatro, a dramatized dialogue, a score for a story/podcast/storyboard, voiceover for lipsync, a TTS conversation, or a podcast episode from a script or idea.
| File | Kind | Size |
|---|---|---|
| REFERENCE.md | markdown | 26.9 KB |
| SKILL.md | skill md | 26.9 KB |
| scripts/_common.py | script | 16.8 KB |
| scripts/audio_music.py | script | 10.3 KB |
| scripts/build_transcript.py | script | 4.8 KB |
| scripts/elevenlabs_sfx.py | script | 3.8 KB |
| scripts/export_lipsync.py | script | 4.4 KB |
| scripts/generate_sfx.py | script | 10.0 KB |
| scripts/generate_voices.py | script | 16.6 KB |
| scripts/mix.py | script | 10.0 KB |
| scripts/mix_spatial.py | script | 23.0 KB |
| scripts/requirements.txt | manifest | 364 B |
| scripts/setup_key.py | script | 4.2 KB |
| scripts/spatial.py | script | 6.8 KB |
| scripts/split_tracks.py | script | 8.3 KB |
| scripts/transcribe.py | script | 8.8 KB |
| scripts/voices.json | config | 2.1 KB |
| scripts/write_script.py | script | 9.9 KB |
scripts/setup_key.py
View on GitHub#!/usr/bin/env python3
"""Configure / inspect API keys for the audio-theater skill.
Keys are normally reused from sibling skills:
- Gemini API key from asset-generator
- Replicate API token from sound-effects (with fallbacks)
Usage:
python3 setup_key.py # auto-import from sibling skills (no overwrite)
python3 setup_key.py --show # show what's configured (masked)
python3 setup_key.py --gemini KEY # set Gemini API key
python3 setup_key.py --replicate r8_TOKEN # set Replicate API token
python3 setup_key.py --elevenlabs KEY # set ElevenLabs API key (realistic SFX backend)
"""
import argparse
import sys
from pathlib import Path
SCRIPT_DIR = Path(__file__).parent
sys.path.insert(0, str(SCRIPT_DIR))
from _common import ( # noqa: E402
load_config, save_config, get_gemini_api_key, get_replicate_token,
get_elevenlabs_api_key,
)
def mask(value):
if not value:
return "(not set)"
if len(value) <= 12:
return "***"
return value[:6] + "..." + value[-4:]
def main():
parser = argparse.ArgumentParser(description="Configure audio-theater API keys")
parser.add_argument("--show", action="store_true", help="Show current config (masked)")
parser.add_argument("--gemini", help="Set the Gemini API key")
parser.add_argument("--replicate", help="Set the Replicate API token")
parser.add_argument("--elevenlabs", help="Set the ElevenLabs API key (realistic SFX)")
args = parser.parse_args()
config = load_config()
if args.show:
gem = config.get("gemini_api_key", "") or get_gemini_api_key(required=False)
rep = config.get("replicate_api_token", "") or get_replicate_token(required=False)
el = config.get("elevenlabs_api_key", "") or get_elevenlabs_api_key(required=False)
print("audio-theater configuration:")
print(f" gemini_api_key : {mask(gem)}")
print(f" replicate_api_token : {mask(rep)}")
print(f" elevenlabs_api_key : {mask(el)}")
print(f" sfx_backend : {config.get('default_sfx_backend', 'auto')}"
f" (-> {'elevenlabs' if el else 'sound-effects'} when auto)")
print(f" tts_model : {config.get('default_tts_model', 'gemini-3.1-flash-tts-preview')}")
print(f" text_model : {config.get('default_text_model', 'gemini-3.5-flash')}")
print(f" config file : {SCRIPT_DIR.parent / 'config.json'}")
return
changed = False
if args.gemini:
config["gemini_api_key"] = args.gemini.strip()
changed = True
print(f"Gemini API key saved: {mask(config['gemini_api_key'])}")
if args.replicate:
token = args.replicate.strip()
if not token.startswith("r8_"):
print("Warning: Replicate tokens usually start with 'r8_'. Proceeding anyway.",
file=sys.stderr)
config["replicate_api_token"] = token
changed = True
print(f"Replicate API token saved: {mask(token)}")
if args.elevenlabs:
config["elevenlabs_api_key"] = args.elevenlabs.strip()
changed = True
print(f"ElevenLabs API key saved: {mask(config['elevenlabs_api_key'])}")
if changed:
save_config(config)
print(f"Config saved to {SCRIPT_DIR.parent / 'config.json'}")
return
# No explicit values -> auto-import from siblings without overwriting.
gem = get_gemini_api_key(required=False)
rep = get_replicate_token(required=False)
if gem and not config.get("gemini_api_key"):
config["gemini_api_key"] = gem
print(f"Gemini API key imported: {mask(gem)}")
if rep and not config.get("replicate_api_token"):
config["replicate_api_token"] = rep
print(f"Replicate API token imported: {mask(rep)}")
save_config(config)
print("\nResolved keys (env/own/sibling):")
print(f" gemini_api_key : {mask(gem)}")
print(f" replicate_api_token : {mask(rep)}")
if not gem:
print("\nNo Gemini key found. Set asset-generator's key or run with --gemini KEY.",
file=sys.stderr)
if not rep:
print("No Replicate token found. Configure sound-effects or run with --replicate TOKEN.",
file=sys.stderr)
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |