Install Song Maker

1. Download the app

Download the installer for your system:

• Windows x64: recommended .exe installer or .msi, with an NVIDIA GPU.
• macOS: Apple Silicon .dmg or Intel Mac .dmg, using Metal acceleration.
• Linux x64: AppImage, .deb, or .rpm, with an NVIDIA GPU.

See all releases and their files.

The app and models stay on your computer.

What v0.4.3 adds: What’s new.

2. Open the app (setup)

On first launch, Song Maker’s assistant:

1. checks the GPU (NVIDIA CUDA or Metal);
2. offers the Q4 pack (default) or Q8;
3. asks you to accept YuE2 CC BY-NC 4.0 and HTDemucs licenses;
4. downloads the engine and weights (can resume if the connection drops).

No online account. Screens, Settings, Lego, and ffmpeg: Set up Song Maker.

Windows installers may not all be signed yet, so SmartScreen can appear. On macOS the app is not notarized; allow it in System Settings → Privacy & Security.

3. Disk space and ffmpeg

The engine, YuE2, and HTDemucs need several gigabytes. ffmpeg with libsoxr is used for resampling and some exports:

• Windows: winget install Gyan.FFmpeg
• macOS: brew install ffmpeg
• Linux: your distribution’s ffmpeg package

Otherwise set SONG_MAKER_FFMPEG.

4. Next

• First song — style, lyrics, YuE2.
• Batch generation — JSON for several songs.
• GPU troubleshooting — Q4, Q8, memory.

Script path (optional)

To download binaries and weights without the in-app assistant (developers):

Windows (PowerShell):

irm https://raw.githubusercontent.com/azerothl/song-maker/main/scripts/first-run-windows.ps1 | iex

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/azerothl/song-maker/main/scripts/first-run-unix.sh | bash

The usual path is still the assistant in the installed app.