Roam Studio
Take control of your Ableton Live projects. Find missing samples, organize your library, archive to the cloud.
Never Lose a Sample
Recover missing samples across any drive with intelligent matching
Organize Everything
Songs, albums, tags, ratings, and readiness checklists
Work From Anywhere
Cloud archiving, streaming, and remote access from any device
Quick Start
Install
Download the desktop app or install via pip:
pip install roam-studioLaunch
Open the desktop app or run the web server:
python -m roam_studio.webPoint to Your Projects
Set your projects folder and sample drives. Roam Studio works with your existing Ableton folder structure.
Scan & Go
Hit Refresh. Roam scans every .als file, builds your library, and shows what needs attention.
Core Features
Everything you need to keep your Ableton projects healthy and organized.
Project Scanning
Discovers every .als file in your projects folder, extracts all sample references, and builds a searchable inventory. Instantly see which projects have missing samples.
Sample Recovery
Matches missing samples across all indexed drives using filename + exact file size for reliable matching. Copy-only operations -never modifies your originals.
Smart Recovery
One-click orchestrated workflow: scan your project, index connected drives, match missing samples, and copy them back. Real-time progress via WebSocket updates.
Drive Indexing
Index any folder or external drive. Supports WAV, AIF, MP3, FLAC, OGG, M4A, AAC, REX, and more. Persistent SQLite index -scan once, search forever.
Project Relinking
Fixes broken sample paths directly inside .als files. SHA-256 verified backups, transaction logging, atomic writes, and rollback capability. Dry-run by default.
Batch Relinking
Relink multiple projects in a single operation. Requires exact filename and size match for safety. Automatic rescan after completion to verify results.
Sample Consolidation
Gathers scattered samples into an organized vault. Content-addressed storage using SHA-256 hashes prevents duplicates. Per-project manifests track ownership.
Corrupt ALS Recovery
Detects corrupted project files (bad gzip, empty, old formats) and searches indexed drives for uncorrupted originals. Restores with backup of the corrupted version.
How It Works
Visual guides to the key workflows.
Architecture
Client
React + TypeScript UI
Server
FastAPI Backend
Core Engine
Storage
SQLite · Local FS
Cloudflare R2 (optional)
Sample Recovery Flow
Album Lifecycle
Track your albums from early ideas through to public showcase.
Cloud Archive Flow
Organization Tools
Everything to keep your creative work structured and findable.
Song Management
Create unified song entities that link Ableton projects with their rendered audio exports. One song, all its versions in one place.
Album Management
Group songs into albums with drag-and-drop track ordering. Add artwork, descriptions, release details, and per-track notes. Placeholder tracks for songs still in progress.
Album Showcase
Mark albums as WEBSITE to create a public-facing showcase. Audio preview playback, track listings, and album metadata -ready for sharing.
Tags & Metadata
Free-form tags, star ratings (1–5), work status tracking, BPM, notes, and health scores. Filter and search your entire library by any combination.
Checklists & TODOs
Per-project readiness checklists to track what needs to happen before a track is done. Plus free-form TODO lists for any notes or tasks.
Render Management
Automatically scans your audio exports. Browse, tag, and organize renders. Link them to songs for a complete picture of every version.
Cloud Features
Archive, stream, and access your projects from anywhere.
Cloud Archiving
Archive completed projects and renders to Cloudflare R2 object storage. Verified sync with 24-hour safety window before local cleanup. Your projects stay in the database for browsing.
Cloud Restore
Download archived projects back to local storage whenever you need them. Full state tracking during the restore process.
Audio Streaming
Stream audio directly from R2 cloud storage without downloading. HTTP range request support means seeking works instantly. Play your renders from anywhere.
Cloud Mode
Deploy the server remotely and access your entire library from your phone, laptop, or any browser. All organization features work over the network -tag, rate, and arrange from the couch.
Desktop App
Native app experience with no setup required.
Native Experience
Electron-based desktop app. Download the DMG, drag to Applications, and you're running -no Python or Node.js install needed.
Audio Playback
Built-in audio player with seeking, now-playing bar, and album track preview. Listen to renders while you organize.
Cross-Platform
Available for macOS (Apple Silicon + Intel), Windows, and Linux. Same full-featured UI on every platform.
System Requirements
What you need to run Roam Studio.
| Requirement | Details |
|---|---|
| Operating System | macOS, Windows, or Linux |
| Desktop App | Download the installer -no other dependencies needed |
| Python (server mode) | Python 3.10 or later (3.11 recommended) |
| Storage | External drives for sample storage (any format your OS can read) |
| Cloud (optional) | Cloudflare R2 account + rclone configured |
| Ableton Live | Any version that produces .als project files |
| Audio Formats | WAV, AIF, AIFF, MP3, FLAC, OGG, M4A, AAC, REX, RX2 |
FAQ
+Will Roam Studio delete my files?
No. All operations are copy or move only. Roam Studio never deletes files. Destructive operations run in dry-run mode by default so you can preview changes before committing.
+How does sample matching work?
Roam Studio matches by filename + exact byte size. This prevents wrong-file matches that can happen with filename-only matching. High-confidence matches (name + size) are auto-applied; low-confidence matches are flagged for your review.
+Can I use it with multiple drives?
Yes. Index any number of drives and Roam Studio will search all of them when recovering samples. Drive indexes persist in the database, so you only need to re-index when drive contents change.
+What Ableton versions are supported?
All versions that produce .als project files. Roam Studio handles both old and new XML element ordering, Max for Live devices, and various sample reference formats.
+Do I need an internet connection?
No. All local features (scanning, recovery, relinking, organization) work fully offline. An internet connection is only needed for cloud features like R2 archiving and audio streaming.
+How is relinking safe?
Every relink operation creates a SHA-256 verified backup of your project file, logs all changes in a transaction log, uses atomic writes to prevent corruption, and supports full rollback. Dry-run is the default -you always preview before applying.
+Can I access it from my phone?
Yes. Deploy the server with Cloud Mode and access your full library from any browser -phone, tablet, or another computer. All organization features (tags, albums, ratings, notes) work remotely.