Install Song Maker

1. Download the app

Download the installer for your system directly:

• 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 your models stay on your computer. YuE2 and HTDemucs model files are downloaded separately during first-time setup.

2. Install the engine and models

YuE2 weights are licensed under CC BY-NC 4.0, which restricts commercial use. The setup script asks you to accept the license before downloading. Q4 is selected by default, and interrupted downloads can resume.

Windows

Open PowerShell and paste:

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

An NVIDIA GPU and a recent driver are required. The installer is not signed with a publisher certificate, so Windows may show SmartScreen.

macOS

Open Terminal and paste:

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

Intel and Apple Silicon Macs use the Metal engine. The app is not notarized; if macOS prompts you, allow it in System Settings → Privacy & Security.

Linux

On an x64 PC with an NVIDIA GPU, open Terminal and paste:

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

The NVIDIA driver must support CUDA 12.8. The release binary targets Ubuntu x64; other distributions may need additional system dependencies.

3. Check disk space

The engine, YuE2, and HTDemucs require several gigabytes. Make sure you have a stable connection and enough free space. Files are kept in Song Maker's local cache.

ffmpeg with libsoxr is required for resampling and some exports: winget install Gyan.FFmpeg on Windows, brew install ffmpeg on macOS, or your Linux distribution's ffmpeg package.