suno-to-ableton

Turn your Suno AI songs into production-ready Ableton Live sessions. Export stems and MIDI from suno.ai, run one command, and open a fully laid-out .als file — every track named, grid-aligned, tempo-matched, and ready to remix.

Read the full documentation

What it does

Automates all the tedious work between exporting from Suno and actually producing in Ableton:

• Stem cleanup — renames, normalizes, trims silence, and routes each stem to the correct track
• Tempo and grid alignment — detects BPM, aligns the first downbeat, and snaps everything to the grid
• MIDI cleanup — strips junk notes, fixes quantization, and sets the correct tempo
• Arrangement detection — identifies song sections like intro, verse, chorus, and bridge
• Stem comparison — evaluates stem quality and picks the cleanest version when alternatives exist
• Key and harmony correction — detects the key and fixes wrong notes in MIDI
• .als export — generates an Ableton Live Set ready to open and produce

Quick start

Prerequisites

• Python 3.11+ — install guide
• uv — install guide
• ffmpeg on PATH — install guide
• PyTorch (only for stem separation) — install guide

See Install for full platform-specific installation instructions, optional extras, and dependency details.

Install

git clone https://github.com/steven-ahfu/suno-to-ableton.git
cd suno-to-ableton
uv sync

For the TUI, stem separation, or GPU acceleration, see Install — Optional extras.

Export from Suno

1. Open your song on suno.ai
2. Download Stems (ZIP of numbered WAV files)
3. Optionally download the MIDI file
4. Unzip into a project directory:

mkdir ~/suno-exports/my-song
# Unzip stems ZIP and move .mid file here

Expected layout:

my-song/
├── 0 Song Name.wav       # Full mix
├── 1 FX.wav              # FX stem
├── 2 Synth.wav           # Synth stem
├── 3 Percussion.wav      # Percussion
├── 4 Bass.wav            # Bass
├── 5 Drums.wav           # Drums
├── 6 Backing_Vocals.wav  # Backing vocals
├── 7 Vocals.wav          # Vocals
├── 8 sample.wav          # Sample
└── Song Name.mid         # MIDI (optional)

See Exporting from Suno for details on what Suno exports and how to handle edge cases.

Process

# Read-only analysis
uv run suno-to-ableton analyze ~/suno-exports/my-song

# Full processing pipeline
uv run suno-to-ableton process ~/suno-exports/my-song

# Process + generate Ableton Live Set
uv run suno-to-ableton process ~/suno-exports/my-song --export-als

See CLI Usage for the complete CLI reference, all flags, workflow examples, and advanced feature usage.

Documentation

Doc	Contents
Installation	Prerequisites, platform-specific install commands, optional extras, dependency reference
Exporting from Suno	How to get your stems and MIDI out of Suno
Usage
CLI	CLI commands and workflow
TUI	Interactive terminal interface
CLI Flags Reference	Complete flag reference
ALS Export	Ableton Live Set generation
Workflow Examples	Common recipes for different use cases
Reports & Output	Report formats and output files
Advanced Features
Overview	Feature summary and the --apply flag
Stem Quality Judgment	How stem comparison works, when to use --choose-stems
Grid Anchor (Bar-1 Detection)	Bar-1 detection for ambiguous intros
Section Detection	Arrangement section identification
Harmonic MIDI Repair	Key detection, wrong-note flagging, chord repair
MIDI Requantization	Groove-aware quantization modes
Separation Strategy	Demucs vs UVR, targeted re-separation
Contributing	Dev setup, project structure, code style, PR process

Contributing

See Contributing for development setup, project structure, and how to submit changes.

Acknowledgments

• ableton-lom-skill — Ableton Live Object Model API reference used for Remote Script and ALS integration development

License

See LICENSE.