Ableton Bounce Automator
Complete User Manual — v2.0
1 What is Ableton Bounce Automator?
Ableton Bounce Automator (ABA) is a Windows desktop app that automatically batch-exports all your Ableton Live projects as MP3 files — while you sleep, while you work, or while you do anything else.
You point it at a folder, click Start, and walk away. ABA opens each
.als project in Ableton, configures the export settings, bounces the first
90 seconds as an MP3, saves the file next to the project, and moves on to the next one —
completely unattended.
Key Features
- Batch export — processes entire folder trees, including all subfolders
- Smart skip — never re-exports a project that already has an MP3
- Reads actual project duration — extracts clip end time directly from the
.alsfile, caps at 3 minutes - Handles unexpected dialogs — "samples not loaded", save prompts, and others — dismissed automatically, up to 15 retries per project
- Crash watchdog — detects if Ableton freezes, kills it, restarts it, and picks up from where it left off
- Failure tracking — projects that couldn't be exported are logged and can be reviewed or cleared
- Full session control — Pause, Resume, and Stop at any time
- Real-time log — color-coded, timestamped, project-by-project
- Works with Ableton Live 10, 11, and 12 — any edition (Intro, Standard, Suite)
2 Requirements
- Operating System — Windows 10 or Windows 11 (64-bit only)
- Ableton Live — version 10, 11, or 12 — any edition (Intro, Standard, Suite)
- Screen must stay unlocked — ABA controls Ableton's UI directly; the desktop must be visible while it runs
- License key — delivered by email after purchase
.exe installer. No Python, no Node.js, no command line.
The AbletonMCP bridge (required for communication with Ableton) is included
and installed automatically.
3 Installation
Installing ABA takes about two minutes and requires no technical knowledge.
-
Download the installer
After purchasing, you'll receive a download link by email. Save the fileAbletonBounceAutomator_Setup_v2.0.exeanywhere on your computer. -
Close Ableton Live before running the installer
The installer needs to copy files into Ableton's user folder. If Ableton is open, the installer will detect it and ask you to close it before continuing. -
Run the installer
Double-click the.exe. Windows may show a SmartScreen prompt ("Windows protected your PC") — click More info → Run anyway. This is normal for indie software that isn't yet widely distributed. -
Read the EULA and proceed
The installer displays the End User License Agreement. Click I accept the agreement and then Next. -
Review the AbletonMCP information page
The installer shows you exactly where AbletonMCP will be installed (inside your Ableton user folder). This step is automatic — just click Next. -
Choose install location and shortcuts
The default location (C:\Program Files\Ableton Bounce Automator) works for most users. Optionally check Create a Desktop shortcut. Click Install. -
Installation completes
The installer copies all files and installs the AbletonMCP Remote Script automatically. Click Finish.
4 Setting Up AbletonMCP in Ableton Live
This is a one-time manual step you do once after installation. AbletonMCP is a small Remote Script that lets ABA communicate with Ableton over a local socket. It needs to be enabled in Ableton's settings.
-
Open Ableton Live
-
Open Ableton's Preferences
PressCtrl + ,— or go to Options → Preferences. -
Go to the "Link, Tempo & MIDI" tab
Click the tab at the top of the Preferences window. -
Find an available Control Surface slot
Scroll down to the Control Surfaces section. You'll see a list of slots (Control Surface 1, 2, 3…). Pick any empty slot. -
Set Control Surface → AbletonMCP
Click the dropdown under Control Surface for that slot and select AbletonMCP from the list. -
Set Input and Output → None
For the same slot, set both Input and Output dropdowns to None. -
Close Preferences
AbletonMCP is now active. It will remain enabled every time you open Ableton.
5 License Activation
ABA requires a one-time license activation. Your license key is delivered instantly to your email after purchase from Gumroad.
Activating for the first time
-
Launch Ableton Bounce Automator
From the Desktop shortcut or the Start Menu. -
The activation window appears automatically
On first launch (or if no valid license is found), the app shows a dark activation dialog. -
Enter your license key
Type or paste your key. It is formatted asXXXX-XXXX-XXXX-XXXX. The app auto-inserts the dashes as you type — you can paste the full key at once too. -
Click Activate
If the key is valid, a confirmation message appears and the main window opens.
6 First Run
Before starting your first batch export, make sure:
- Ableton Live is open — ABA controls it directly; it must be running
- AbletonMCP is enabled in Ableton's Preferences (done once, stays active)
- Your screen is unlocked — ABA drives Ableton's UI via mouse and keyboard automation
- You are not actively clicking around in Ableton — let ABA take control
Quick start
- Open Ableton Live and leave it on the main screen.
- Launch Ableton Bounce Automator from your Desktop or Start Menu.
- Click Browse and select the root folder that contains your Ableton projects. ABA scans all subfolders automatically.
- Click ▶ Start and walk away. ABA handles everything from here.
7 Controls Reference
| Button | When available | What it does |
|---|---|---|
| ▶ Start | Idle | Begins the batch export. Scans the selected folder for projects without an MP3 and starts processing them one by one. |
| ⏸ Pause | Running | Pauses processing after the current project finishes its current step. Ableton keeps running; ABA simply waits. |
| ▶ Resume | Paused | Resumes from exactly where it paused. No project is skipped or re-processed. |
| ■ Stop | Running or Paused | Signals ABA to stop after the current project finishes. Projects already exported are not affected. The progress is preserved — run again to continue from where you stopped. |
| List Failures | Always | Prints to the log all projects that failed to export in previous sessions. The failure list is stored in a file inside your projects folder. |
| Clear Failures | Always | Removes all entries from the failure list. After clearing, those projects will be retried on the next run. |
Status bar
The status bar below the folder path shows the current state in real time:
Ready. → Exporting: [project name] → Done!
or Stopped.
The counter on the right side of the status bar shows progress as current / total
(e.g., 12 / 87).
8 Reading the Execution Log
The log panel shows a real-time, color-coded, timestamped record of everything ABA is doing. Here is what each color means:
| Color | Meaning |
|---|---|
| White | Section headers — folder path, project count |
| Cyan-green | Normal info — file names, durations, export confirmation |
| Blue | Steps in progress — "Opening project...", "Waiting for Ableton..." |
| Purple | Project start and final completion messages |
| Yellow | Warnings — unexpected dialogs dismissed, unknown durations, paused state |
| Red | Errors — timeouts, failed exports, watchdog events, stop signal |
| Gray | Dim info — already-skipped projects, separators, timestamps |
Example log output
9 Managing Failures
Sometimes a project cannot be exported — corrupted .als files, missing
critical samples that prevent loading, or repeated Ableton crashes on the same project.
ABA marks these as failed and skips them on future runs.
Where failures are stored
ABA creates a file called _bouncer_failed.json directly inside your selected
projects folder. This file lists all the .als paths that failed. You can open
it in any text editor if you want to inspect or manually edit the list.
Listing failures
Click List Failures at any time. ABA prints every failed project to the log, organized by folder. Use this to identify which projects need attention.
Clearing failures
Click Clear Failures to delete the
_bouncer_failed.json file. On the next run, those projects will be
attempted again. Useful after you have fixed a missing sample pack or restored a
corrupted project.
10 How It Works
Understanding the internals helps you know what to expect during a run.
Project scanning
ABA scans your selected folder and all subfolders. For each subfolder, it picks the
most recently modified .als file (one per folder).
Folders named "Backup" are ignored. Projects that already have an MP3 are skipped silently.
Opening a project
ABA calls os.startfile() on the .als file — the same as
double-clicking it in Explorer. Ableton opens the project normally.
4-phase load detection
ABA waits for Ableton to be fully ready through four phases:
- Splash screen closes — watches for the loading splash to disappear.
- No pending dialogs — dismisses any save prompts or confirmation dialogs.
- Window title matches — confirms Ableton's title bar contains the project name.
- MCP socket stable for 5 seconds — verifies the AbletonMCP bridge is responding consistently, confirming Ableton is fully loaded and not still initializing plugins.
Export configuration
ABA opens the Export Audio/Video dialog (Ctrl+Shift+R) and
navigates it entirely via Tab key, without relying on fixed screen coordinates.
It takes a screenshot of the dialog to detect the state of the WAV and MP3 toggle buttons
(identified by their orange "ON" color), then turns WAV off and MP3 on if needed.
Render length
ABA reads the .als file (which is a gzip-compressed XML) to find the
end position of the last clip across all tracks. This is converted to bars using the
project's tempo. The render is capped at 3 minutes (180 seconds).
MP3 file naming
The output MP3 is named:
[FolderName] - [FileName].mp3
and saved in the same folder as the .als file.
Crash watchdog
A background thread checks Ableton's window title every 5 seconds. If it contains "(Not Responding)", the watchdog flags a crash. ABA then:
- Kills the Ableton process via
taskkill. - Waits for it to fully exit.
- Restarts the watchdog thread.
- Reopens the same project and retries the export once.
- If the crash happens again on the same project, it is skipped and the next project is processed.
11 FAQ
12 Contact & Support
ABA is built and maintained by a single producer. If you have questions, bugs to report, or just want to say hi:
- Email — robledosilva@gmail.com
- GitHub — github.com/robledosilva/ableton-bouncer-automator