Skip to content

donkeyhotshow/AbleFolder

Repository files navigation

AbleFolder

Build License Version

A local-first desktop app for managing your Ableton Live projects — scan, search, tag, play bounces, and get back to making music.

Website: setcrate.app

Library View

✨ Features

🔍 Smart Project Management

  • Automatic project scanning — point SetCrate at your Ableton projects folder and it discovers every project, its .als set files, and WAV bounces automatically. Supports nested genre folders.
  • Powerful search and filtering — full-text search across project names, tags, genres, and notes. Smart filter presets (In Rotation, Top Rated, Last 7 Days, Near Done) plus status and tag dropdowns. 11 sort options including BPM, key, rating, and last worked on.

🎵 Audio & Playback

  • Global audio player — player bar persists across views with seeking, volume, and loop controls. Waveform visualization with draggable markers on the Timeline tab.
  • Spotify integration — link Spotify tracks as references with embedded playback (Premium required for full tracks).
  • SoundCloud upload — direct WAV upload from the Timeline tab.

🎨 Visual & Organization

  • Smart cover art — every project gets a cover. Choose from 9 procedurally generated gradient styles, upload your own image, or pick from a mood board. Covers are deterministic — same project always produces the same art.
  • Rich project details — edit status, genre, BPM, key, rating, and notes. Manage tags with autocomplete. Six tabs: Timeline (waveform + markers), Notes, Tasks, References, Assets, and Insights.

⏱️ Time Tracking

  • Work sessions — built-in timer tracks time spent on each project with note capture. Crash recovery picks up incomplete sessions if the app closes unexpectedly.
  • Timeline markers — 5 types (Note, Mix, Task, Idea, Issue), double-click to place, drag to reposition, popover editor.

📱 Mobile Companion

  • Cloud sync via Supabase — browse your library, edit metadata, and play bounces from your phone.
  • Full feature parity — all desktop functionality available on mobile with offline support.

Project Detail

Download

Windows (Desktop)

Download SetCrate v1.0.0 Installer (.exe)

Windows may show a SmartScreen warning since the app isn't code-signed yet. Click "More info" then "Run anyway" to proceed.

macOS (Desktop)

Download SetCrate v1.0.0 (.dmg)

The macOS build is not code-signed yet. On first launch, right-click the app and choose "Open" to bypass Gatekeeper.

Android (Mobile Companion)

Download SetCrate Mobile v1.0.0 (.apk)

You'll need to enable "Install from unknown sources" in your Android settings to sideload the APK.

iOS (Mobile Companion)

The iOS app is built with Expo (EAS Build) and distributed via TestFlight during the pre-release period.

Install via TestFlight:

  1. Install TestFlight from the App Store on your iPhone or iPad
  2. Open the TestFlight invite link (provided by the developer)
  3. Tap "Accept" then "Install" to add SetCrate to your device
  4. SetCrate will appear on your home screen like any other app

Building from source:

cd mobile
npm install
npx eas build --platform ios --profile preview   # internal TestFlight build
npx eas build --platform ios --profile production # App Store build
npx eas submit --platform ios                     # submit to App Store Connect

Requires an Apple Developer account ($99/year) and the EAS CLI (npm install -g eas-cli). Run eas login and eas build:configure before your first build.

All releases: github.com/skinut3232/Ableton-Project-Manager/releases

System Requirements

  • Desktop: Windows 10+ or macOS 10.15+ (Catalina or later)
  • Mobile: Android 8.0+ / iOS 15.0+

Consolidation

AbleFolder is the consolidated successor to two earlier tools:

  • Ableton Hub (Python/PyQt6 desktop app)
  • AbleFolder / ablet (Electron/React desktop + CLI)

Those donor projects are now archived and kept read-only. New development happens here.

If you are migrating from Ableton Hub or AbleFolder, see:

  • MIGRATION.md — high-level migration guide and CLI mapping
  • CONSOLIDATION/ — detailed stage results, schema audits, and CLI registry
  • docs/adr/ — architecture decision records (ADR-001–ADR-007)

Getting Started

  1. Install — run the Windows installer linked above
  2. Set your projects folder — open Settings and browse to your Ableton projects root directory (e.g. D:\Music\Ableton Projects)
  3. Set your Ableton path — browse to your Ableton Live executable so one-click launch works
  4. Scan — click the scan button (or press Ctrl+R) and your library populates automatically
  5. Start browsing — click any project card to open the detail view, or use the search bar to find something specific

Optional Setup

  • Spotify integration — requires a Spotify Developer app. Add your Client ID and Secret to a .env file before building from source. Enables track search and reference playback (Premium required for full playback).
  • SoundCloud upload — requires a SoundCloud Developer app. Add credentials to .env. Enables direct WAV upload from the Timeline tab.
  • Cloud sync + mobile — requires a Supabase project. Configure the connection in Settings to sync your library to the mobile companion app.

Keyboard Shortcuts

Shortcut Action
Ctrl/Cmd+F or / Focus search bar
Space Play / pause audio (when not typing)
Escape Clear search / close modal / navigate home
Ctrl/Cmd+R Rescan library
Ctrl/Cmd+Shift+R Open a random project
Arrow keys Navigate the project grid
M Add marker (on Timeline tab)
N / P Next / previous marker

Tech Stack

Tauri v2 + Rust + React 19 + TypeScript + Vite 7 + SQLite (FTS5) + Tailwind CSS v4 + Zustand + TanStack Query + Expo (React Native)

~22,000 lines of code across the desktop and mobile apps.

License

This source code is shared for reference and learning purposes. All rights reserved — not licensed for redistribution or commercial use.

About

Ableton Live project manager for producers.

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors