musicgen-lyria3

# Musicgen Lyria 3.5 ## Overview Generate 30-second clips or full-length songs with Google's Lyria 3.5 family via the Gemini Interactions API (44.1 kHz stereo audio, structural coherence, vocals, and lyrics). All generated MP3s automatically receive: - 📜 **Embedded Lyrics**: Stored in standard `USLT` (Unsynchronized Lyrics) and mirrored in `COMM` (Comment) for 100% player/device compatibility. - 👤 **Default Artist Avatar**: Incorporates the official **Drake Riccardo Meme Clean NO** (`assets/drake_riccardo_artist_default.png`) as Artist Picture (`APIC` Type 8). - 🏷️ **ID3v2.3 Metadata**: Artist (`Riccardo C feat. Google Lyria 3`), Title, Album, Year, and `TXXX:AI_TOOL`. - 📝 **Sidecar Text File**: Matching `<output>.txt` saved alongside the `.mp3`. ## Models & Scripts | Model | Model ID | Best for | Duration | Bundled Script | | :--- | :--- | :--- | :--- | :--- | | **Lyria 3 Clip** | `lyria-3-clip-preview` | Short clips, loops, previews | ⏱️ 30s | `scripts/musicgen-lyria3-30sec.py` (Default) | | **Lyria 3.5** | `lyria-3.5` | Full songs (verses, choruses, bridges) | 🎵 2–3 min | `scripts/musicgen-lyria3-2min.py` | - `scripts/musicgen-lyria3-list.py`: List available audio/music models. ## Storage & Tagging Rules - Output audio is saved as `<output_path>.mp3`. - **MANDATORY**: Lyrics and metadata MUST ALWAYS be saved in the **exact same folder** as the audio file with the **exact same base name** (e.g., `assets/song_v2.mp3` ➔ `assets/song_v2.txt`). - **Tagging Flags**: - `--title "My Custom Song Title"` (defaults to filename without underscores) - `--artist "Riccardo C feat. Google Lyria 3"` (default) - `--album "My Album Name"` - `--cover "path/to/cover.png"` (embeds as Front Cover Type 3) - `--artist-image "path/to/artist.png"` (defaults to Drake Riccardo Clean NO meme) ## Example Usage ```bash # 30-sec clip with auto ID3 & embedded lyrics (Default) uv run scripts/musicgen-lyria3-30sec.py -o "assets/music/clip" -p "A synth-pop song: 'Electrified, living for the night.'" # Full song with Lyria 3.5 and custom album/cover uv run scripts/musicgen-lyria3-2min.py -o "assets/music/song" --cover "assets/images/cover.png" -p "An energetic pop-rock anthem: 'Full lyrics here...'" ``` ## Italian Phonetic Guidelines AI singing models mispronounce unaccented Italian words. Always use explicit accents or spacing inline: `Nicòla` (not `Nicola`), `Mòdena`, `Dàvide`, `Cacio Cavallo` (spaced), `mattacchióne`, `energìa` (not `energià`), `tecnologìa`, `fantasìa`. ## Karaoke & Subtitles (.srt / .lrc) If the user asks for synchronized lyrics, teleprompter slides, or subtitles (`.srt` / `.lrc`) for karaoke, use Whisper via `uv` to align the audio to lyrics. For the step-by-step procedure, read [references/karaoke_timeline_alignment.md](references/karaoke_timeline_alignment.md).