Ableton Hub

Version 1.0.10 — The "cross-platform trusted installer" release - 🔒 Bravo! 🔒

What is Ableton Hub?

Ableton Hub is a desktop application that helps you organize, manage, and discover your Ableton Live projects across multiple locations. Whether your projects are on your computer, external drives, network shares, or cloud storage, Ableton Hub scans and indexes them all in one place. Creating collections of your projects and mapping exports to projects with deep learning of your project stats.

Key Benefits:

Find Projects quickly - Search and Sort across all your projects by Name, Tempo, Key, Age, Length, Bars, Tracks, Plugins, or Tags
Discover Similar Projects - Find projects with similar plugins, devices, tempo, and structure using advanced similarity analysis
Organize with Collections - Create albums, EPs, or custom collections to group related projects
Track your Exports - Automatically find and link exported audio files to their source projects
Preview Audio Exports - Click on Ableton project to cycle thru all audio exports
Launch with Live - Open any project directly in Ableton Live with your preferred version
Discover patterns - See which plugins and devices you use most across your projects

Built with Python and PyQt6 (GUI framework), Ableton Hub provides powerful tools for music producers to maintain their project libraries and group projects based on their similarities.

Features

Core Functionality

Project Discovery & Management

Multi-Location Scanning: Scan and index Ableton .als project files across multiple locations (local drives, network shares, cloud storage)
Automatic File Watching: Real-time detection of new, modified, or deleted projects using file system watchers
Project Metadata Extraction: Automatically extracts rich metadata from .als files including:
- Plugins and devices used
- Tempo and time signature
- Musical key and scale type (e.g., C Major, D# Minor)
- Track counts (top-level audio, MIDI, and group tracks - excludes nested/return tracks)
- Arrangement length
- Ableton Live version
- Sample references
- Automation status
- Timeline Markers: Extract timeline markers (locators) with timestamps and text annotations
File Hash Tracking: SHA256 hashing for duplicate detection and integrity verification
Project Health Dashboard: Monitor project health metrics, identify issues, and track project status
Visual Export Indicators: Projects with exports display colorized icons

Project Collections & Organization

Static Collections: Create custom collections for albums, EPs, sessions, compilations, and more
Smart Collections: Rule-based dynamic collections that auto-update based on criteria:
- Filter by tags, locations, date ranges
- Filter by plugins, devices, or project metadata
- Filter by rating, favorites, or export status
- Filter by tempo range (min/max BPM)
- Filter by similarity: Find projects similar to a reference project (with configurable similarity threshold)
Track Management: Organize projects within collections as tracks with:
- Custom Track / Song names that map to Project name and Audio Export
- Per-track artwork
- Track re-ordering
Collection Types: Support for albums, EPs, sessions, compilations, and custom types

Timeline Markers & Export

Timeline Marker Extraction: Automatically extracts timeline markers (locators) from projects using dawtool
- Supports Live v8-12 with tempo automation handling
- Display markers in Project Properties view
- Export markers to text or CSV format
- Useful for DJ mixes, podcasts, film projects, and project documentation

Search & Discovery

Full-Text Search: Powerful search (using FTS5 - Full-Text Search engine) across:
- Project names
- Export song names
- Notes and tags
- Plugins and devices
- Timeline marker text
Advanced Filtering:
- Date filters (Today, This Week, This Month, Last 7/30 Days, Custom Range)
- Location-based filtering
- Tag-based filtering
- Plugin/device search
- Tempo range filtering (preset ranges: 60-90, 90-120, 120-150, 150+ BPM or custom)
Search Modes: Filter by name, export name, tags, or notes
Real-time Results: Debounced search with instant results
Always-Visible Tempo Filter: Quick-access tempo range buttons in the search bar

Project Similarity & Discovery

Intelligent Similarity Analysis: Find projects similar to any reference project using advanced algorithms:
- Jaccard Similarity Algorithm: Measures plugin and device overlap between projects
- Multi-Metric Comparison: Combines plugin similarity, device similarity, tempo proximity, structural similarity, and feature vector analysis
- Weighted Scoring: Overall similarity score (0-100%) with detailed breakdowns
Multiple Discovery Methods:
- Context Menu: Right-click any project → "Find Similar Projects" to open a dialog showing up to 20 similar projects with similarity scores and explanations
- Project Properties View: View similar projects directly in project properties with detailed similarity breakdowns
- Similarities Panel: Dedicated sidebar panel (between Recent and Favorites) for exploring project similarities with:
  - Project dropdown selector for quick comparison
  - Detailed explanation of how Jaccard similarity works with examples
  - Similar Projects list with percentage scores
  - ML-Based Matches using content-based filtering
- Smart Collections: Create dynamic collections filtered by similarity to a reference project (with configurable similarity threshold)
How to Use:
1. Find Similar Projects from a Card: Right-click any project card → "Find Similar Projects"
2. Search First, Then Find Similar: Use the search bar to find a project, then right-click it to find similar projects
3. View in Project Properties: Open project properties to see the "Similar Projects" section
4. Browse Similarities: Click "Similarities" in the sidebar (between Recent and Favorites) to explore project similarities with the built-in explanation and project selector
5. Create Similarity-Based Collections: Use Smart Collections with a similarity filter rule
Similarity Metrics:
- Plugin overlap (Jaccard similarity on plugin sets)
- Device overlap (Jaccard similarity on device sets)
- Tempo proximity (±5 BPM tolerance)
- Structural similarity (track counts, arrangement length)
- Feature vector cosine similarity
Detailed Explanations: Tooltips and explanations show why projects are similar (shared plugins, devices, tempo, etc.) with similarity scores displayed as percentages

Location Management

Multiple Location Types:
- Local folders
- Network shares
- Dropbox/Cloud storage
- USB drives
- Custom locations
Location Features:
- Favorite locations
- Color coding
- Active/inactive status
- Project count tracking
- Last scan timestamp
Bulk Operations: Scan all active locations at once
Location Statistics: View project counts, total size, and scan history

Tagging System

Flexible Tagging: Create and assign tags with categories
Color-Coded Tags: Visual organization with custom colors
Tag Management: Full CRUD operations for tags
Tag Filtering: Filter projects by one or more tags

Export Tracking

Automatic Export Detection: Scans for exported audio files during project scanning:
- Searches project folders, location roots, and common export directories (Exports, Renders, Bounces, Mixdowns)
- Smart fuzzy matching handles renamed exports (strips "project" suffix, version numbers, date stamps)
- Three-tier matching: exact match → normalized match → fuzzy match (65% threshold)
Export Metadata: Track export formats, bit depths, sample rates, file sizes
Export-to-Project Mapping: Link exports back to source projects with confidence scoring
Export Status Indicators: Green border and 🔊 icon for projects with playable exports
Export Song Name: Set custom export names to improve matching accuracy

Audio Preview & Playback

Waveform Thumbnails: Generate visual waveform previews from exported audio files
Automatic Generation: Thumbnails created automatically during export tracking
Default Artwork: Uses Ableton logo as default thumbnail when preview unavailable
Click-to-Play on Project Cards: Single-click any project card with exports to instantly play audio
- Click again to cycle through multiple exports
- Click on last export to stop playback
- Visual feedback shows current export name and position (e.g., "🔊 MySong (2/3)")
Status Bar Playback Display: Shows currently playing filename in the status bar with green highlight
In-App Audio Playback: Play exported audio files directly from the project details:
- Play/Pause and Stop controls
- Seek slider with time display
- Volume control
- Support for WAV, AIFF, MP3, FLAC, OGG, and M4A formats
- Cross-platform audio playback using Qt Multimedia

Duplicate Detection

Multiple Detection Methods:
- File hash comparison (SHA256)
- Name similarity matching
- Location-based detection
Duplicate Reports: View and manage duplicate projects
Smart Merging: Options to merge or remove duplicates

Project Status & Cleanup

Missing Project Detection: Automatically marks projects as MISSING when files are deleted or moved
Backup Project Exclusion: Backup .als files in Backup folders are automatically excluded from project grid
Backup Project Access: View and launch backup project versions from Project Properties dialog
Missing Projects View: Toggle to view MISSING projects in the View menu
Database Cleanup: Tools menu options to clean up MISSING projects or reset the entire database

Ableton Live Integration

Live Version Detection: Automatically detect installed Ableton Live versions
Live Launcher: Launch projects with a specific Live version
Version Management: View all installed Live versions in the sidebar
Quick Launch: Double-click projects to open with Live
Preferences Access: Right-click Live installations to:
- Open the Preferences folder for that version
- Edit or create Options.txt for advanced configuration

Backup & Archive

Backup Location Management: Configure a dedicated backup folder from the sidebar
Project Backups View: See all backup copies of a project in the Project Properties dialog
Backup Project Launch: Double-click any backup in the list to launch it with Ableton Live
Automatic Backup Detection: Finds backup .als files in Backup folders and timestamped filenames
Archive Service: Create compressed (ZIP) backups of projects with all assets
One-Click Archive: Archive projects directly to your configured backup location

Ableton Link Network

Link Device Discovery: Discover and monitor devices on your Ableton Link network
Real-time Monitoring: Live updates of Link network status
Device Information: View device names, IP addresses, and connection status

MCP Servers Integration

Quick Access Links: Sidebar section with links to popular Ableton MCP server projects:
- ableton-mcp (GitHub)
- ableton-copilot-mcp (GitHub)
- Live control via MCP documentation and resources

User Interface

Multiple Themes: Choose from Orange (default), Blue, Green, or Pink themes inspired by Ableton Live's aesthetic
Grid & List Views: Toggle between grid and list views for projects
Sortable List View: Click column headers to sort by:
- Name (A-Z / Z-A)
- Location (ascending / descending)
- Tempo (low to high / high to low)
- Musical Key (A-Z / Z-A)
- Ableton Live Version (v9, v10, v11, v12)
- Modified date (newest / oldest)
- Tags, Export status, and more
Learning Resources: Built-in links to:
- Official Ableton documentation
- Certified trainers directory
- Regional user groups (Austin, Chicago, San Francisco)
- Ableton Discord community

Enhanced Logging & Diagnostics

Comprehensive Logging System: Built-in logging infrastructure for troubleshooting and debugging
- Configurable Log Levels: DEBUG, INFO, WARNING, ERROR, CRITICAL (defaults to ERROR for production)
- Development Mode: Automatically switches to DEBUG level when running from source
- Log Viewer: Built-in log viewer accessible from Help menu to view recent logs without leaving the app
Log File Locations:
- Windows: %APPDATA%\AbletonHub\logs\
- macOS: ~/Library/Application Support/AbletonHub/logs/
- Linux: ~/.local/share/AbletonHub/logs/

First Time Setup

New to Ableton Hub? Check out the First Time Setup Guide for a detailed walkthrough of what to expect on your first launch and how to get started.

Quick Overview:

Launch the application using one of the installation methods above
Add your first location:
- Click "Add Location" in the sidebar
- Select a folder containing Ableton projects
- Choose location type (Local, Network, Cloud, etc.)
Scan for projects:
- Click the "Scan" button in the toolbar
- Wait for the scan to complete (this may take a few minutes depending on how many projects you have)
- Projects will appear in the main view
Explore your projects:
- Double-click any project to open it in Ableton Live
- Use the search bar to find projects by name, tempo, or plugins
- Click project cards to see details and play exports

Next Steps:

Create collections to organize related projects
Add tags to categorize your projects
Explore the search and filtering options
Check out the Health Dashboard to see project statistics

System Architecture

If viewing on mobile, expand the "View Diagram (Mobile)" section below for an image version.

flowchart TB
    subgraph ui["App UI Layer"]
        MainWindow["Main Window"]
        Sidebar["Sidebar Navigation"]
        ProjectGrid["Project Grid/List View"]
        SearchBar["Search & Filter Bar"]
        CollectionView["Collection View"]
        ProjectPropertiesView["Project Properties View"]
        SimilaritiesPanel["Similarities Panel"]
        HealthDashboard["Health Dashboard"]
    end

    subgraph row2[" "]
        direction LR
        subgraph ext["External Resources"]
            ProjectFiles[".als Project Files"]
            ExportedAudio["Exported Audio Files"]
            LiveInstallations["Ableton Live Installations"]
            LinkNetwork["Ableton Link Network"]
        end

        subgraph svc["Service Layer"]
            Scanner["Project Scanner"]
            Watcher["File System Watcher"]
            ALSParser["ALS Parser"]
            LiveDetector["Live Version Detector"]
            LiveLauncher["Live Launcher"]
            LinkScanner["Link Network Scanner"]
            ExportTracker["Export Tracker"]
            SmartCollections["Smart Collections"]
            DuplicateDetector["Duplicate Detector"]
            HealthCalculator["Health Calculator"]
            SimilarityAnalyzer["Similarity Analyzer"]
            RecommendationEngine["Recommendation Engine"]
            AudioPlayer["Audio Player"]
            ArchiveService["Archive Service"]
        end

        subgraph data["Data Storage"]
            SQLite[("SQLite Database with FTS5")]
            Config["Configuration"]
            Cache["Thumbnail Cache"]
        end
    end

    MainWindow --> Sidebar
    MainWindow --> ProjectGrid
    MainWindow --> SearchBar
    MainWindow --> CollectionView
    MainWindow --> ProjectPropertiesView
    MainWindow --> SimilaritiesPanel
    MainWindow --> HealthDashboard

    ui --> svc

    Sidebar --> Scanner
    ProjectGrid --> SQLite
    SearchBar --> SQLite
    CollectionView --> SmartCollections
    ProjectPropertiesView --> SQLite
    ProjectPropertiesView --> ALSParser
    SimilaritiesPanel --> SimilarityAnalyzer
    SimilaritiesPanel --> RecommendationEngine
    HealthDashboard --> HealthCalculator

    Scanner --> ALSParser
    Scanner --> ProjectFiles
    Scanner --> SQLite
    Watcher --> ProjectFiles
    Watcher --> SQLite
    ALSParser --> ProjectFiles

    LiveDetector --> LiveInstallations
    LiveLauncher --> LiveInstallations
    LiveLauncher --> ProjectFiles

    LinkScanner --> LinkNetwork

    ExportTracker --> ExportedAudio
    ExportTracker --> SQLite

    SmartCollections --> SQLite
    SmartCollections --> SimilarityAnalyzer
    DuplicateDetector --> SQLite
    HealthCalculator --> SQLite
    SimilarityAnalyzer --> SQLite
    RecommendationEngine --> SimilarityAnalyzer
    RecommendationEngine --> SQLite
    AudioPlayer --> ExportedAudio
    ArchiveService --> ProjectFiles
    ArchiveService --> SQLite

    MainWindow --> Config
    ProjectGrid --> Cache

    linkStyle default stroke:#0abde3,stroke-width:2px
    linkStyle 0,1,2,3,4,5,6,39 stroke:#9b59b6,stroke-width:2px
    linkStyle 9,10,12,21,28,31,32,33,35,38 stroke:#f1c40f,stroke-width:2px
    linkStyle 18,20,22,23,24,25,26,27,36,37 stroke:#e67e22,stroke-width:2px
    style ext fill:none,stroke:#e74c3c,stroke-width:3px
    style data fill:none,stroke:#27ae60,stroke-width:3px

View Diagram (Mobile)

If the Mermaid diagram above doesn't render (e.g., on GitHub mobile app), view the architecture diagram below:

Requirements

Python (programming language): Version 3.11 or higher
Operating System:
- macOS 10.15+ (Catalina or later)
- Windows 10/11
- Linux (with Qt6 support)

Installation

Choose the installation method that works best for you.

Method 1: Download Installer (Easiest)

Download a pre-built installer from the Releases page. No Python installation required.

Platform	Format	File
Windows 10/11	MSI installer	`AbletonHub-x.x.x.msi`
macOS 10.15+	DMG disk image	`AbletonHub-x.x.x.dmg`

Windows: Download the .msi, double-click to install, and launch "Ableton Hub" from the Start Menu.

macOS: Download the .dmg, open it, and drag "Ableton Hub" to your Applications folder.

Method 2: Install from GitHub (Recommended for Developers)

This is the easiest method - pip (Python package installer) will automatically download and install everything you need.

pip install "ableton-hub @ git+https://github.com/EazyTom/ableton-hub.git"
ableton-hub  # Run the application

This method will:

✅ Automatically install all dependencies (PyQt6, SQLAlchemy, ML libraries, etc.)
✅ Create the ableton-hub command in your PATH (system path) - you can run it from anywhere
✅ Work on Windows, macOS, and Linux
✅ Allow easy updates: pip install --upgrade git+https://github.com/yourusername/ableton-hub.git

Note: ableton-hub is the executable command created by pip installation. You don't need to navigate to any directory - just run ableton-hub from anywhere in your terminal after installation.

Note: This method requires Python 3.11+ to be installed. Most macOS users already have Python installed. See platform-specific guides below if you need help checking or installing Python.

Method 3: Download Source and Install

If you prefer to download the source code and install manually:

Download the source code:
- Go to the GitHub repository and click "Code" → "Download ZIP"
- Extract the ZIP file to a folder on your computer
Open Terminal (macOS) or Command Prompt/PowerShell (Windows):
- macOS: Press Cmd + Space, type "Terminal", and press Enter
- Windows: Press Win + R, type "cmd" or "powershell", and press Enter
Navigate to the extracted folder:
```
# macOS
cd ~/Downloads/Ableton-Hub-main

# Windows (adjust path as needed)
cd C:\Users\YourName\Downloads\Ableton-Hub-main
```
Note: When you download the ZIP from GitHub, it extracts to a folder named Ableton-Hub-main. Make sure you're inside this folder before running the installation commands.

Set up a virtual environment (recommended - keeps dependencies isolated):

# macOS
python3 -m venv .venv
source .venv/bin/activate

# Windows
python -m venv .venv
.venv\Scripts\activate.bat

Install dependencies:
```
pip install -r requirements.txt
```
Run the application:

Option A: Command Line
```
python -m src.main
```
Option B: Windows Launcher Script (Windows only)
- Double-click run-ableton-hub.bat to run the application
- Tip: Create a desktop shortcut to run-ableton-hub.bat for easy access:
  1. Right-click run-ableton-hub.bat → "Create shortcut"
  2. Drag the shortcut to your desktop
  3. Rename it to "Ableton Hub" if desired

Platform-Specific Installation Guides

For detailed step-by-step instructions with troubleshooting help:

macOS Installation Guide - Complete Mac setup instructions
Windows Installation Guide - Complete Windows setup instructions

These guides include:

How to check if Python is installed
How to install Python if needed
How to verify your installation worked
Common issues and solutions

Additional Resources

First Time Setup Guide - Detailed walkthrough for new users
macOS Installation Guide - Step-by-step Mac installation
Windows Installation Guide - Step-by-step Windows installation
Quick Reference - Common tasks and keyboard shortcuts
FAQ - Frequently asked questions

For Developers

Interested in contributing or understanding how Ableton Hub works? Check out the Contributing Guide for:

Development environment setup
Architecture overview and project structure
Code style guidelines
Testing instructions
Technical details about .als file parsing, database structure, and more

Building Installers Locally

Ableton Hub uses Briefcase to produce native installers. Briefcase handles all platform tooling (including WiX for Windows MSI) automatically.

pip install briefcase

# Windows MSI (run on Windows)
briefcase create windows && briefcase build windows && briefcase package windows -p msi

# macOS DMG (run on macOS)
briefcase create macOS && briefcase build macOS && briefcase package macOS -p dmg

Installers are also built automatically via GitHub Actions on every version tag push. See .github/workflows/build_installers.yml.

🔧 Troubleshooting

Having issues? Here are solutions to common problems:

I can't install Python or pip isn't working

macOS:

Most Macs come with Python installed. Check by opening Terminal and typing: python3 --version
If Python isn't installed, download it from python.org or use Homebrew: brew install python3
See the macOS Installation Guide for detailed help

Windows:

Download Python from python.org
During installation, make sure to check "Add Python to PATH"
See the Windows Installation Guide for detailed help

The app won't start

Ensure Python 3.11+ is installed (check with python --version or python3 --version)
If you used Method 2 (source installation), make sure you activated the virtual environment (.venv)
Try reinstalling: pip install --upgrade git+https://github.com/EazyTom/ableton-hub.git
On Linux, you may need additional system libraries for PyQt6 (GUI framework)

I don't see my projects

Check that locations are added and active in the sidebar
Verify the scan completed successfully (check the status bar at the bottom)
Make sure .als files are in the folders you're scanning
Try clicking "Scan All Locations" in the toolbar
Check the "View" menu → "Show Missing Projects" to see if projects were marked as missing

Audio playback isn't working

Make sure you have exported audio files (WAV, MP3, etc.) in your project folders
On Linux, you may need to install audio codecs: sudo apt-get install gstreamer1.0-plugins-base gstreamer1.0-plugins-good
Try clearing the thumbnail cache: Tools → Clear Thumbnail Cache

I'm confused by the interface

Check out the First Time Setup Guide for a walkthrough
See the Quick Reference for common tasks
Browse the FAQ for answers to common questions

Something went wrong

Check the status bar at the bottom of the window for error messages
View Logs: Use Help → View Logs to see detailed error information and recent activity
Check log files in the logs directory (see Settings → Logging tab for location)
Try resetting the database: Tools → Reset Database (⚠️ This will delete all your indexed projects)
If the problem persists, open an issue on GitHub with details about what happened and include relevant log entries

Contributing

Contributions are welcome! Please see the Contributing Guide for detailed information on:

How to get started with development
Code style guidelines
Testing requirements
Pull request process

Roadmap

Feature Development Status - What's implemented and what's planned
Planned Features Roadmap - Detailed implementation plans for future features

v1.0.10 - Trusted Installer Release

✅ Trusted Open Source - Official trusted installer release; verified, signed installers for Windows (MSI) and macOS (DMG)
✅ Security & Integrity - Installers built with reproducible tooling; SHA256 checksums available for all release assets
✅ Open Source Certified - Meets trusted open source standards for transparency and community verification

v1.0.9 - Audio Preview in Collections, Bugfixes, Icon Fixes

✅ Audio Preview in Collections - Preview audio exports directly from collection views; play tracks without opening the full project
✅ UI Loading Bugfixes - Fixed various UI loading issues; more reliable startup and view transitions
✅ Icon Fixes - Custom app icon now displays correctly on Windows and macOS installers; no more default BeeWare icon
✅ dawtool Markers Fixed - Timeline marker extraction from .als files now works correctly; fixed dawtool integration for marker parsing

v1.0.8 - FTUE, Find Audio Export, Random Song Name

✅ FTUE Startup Guide - First-time user experience guide walks through setup: adding locations, detecting Live versions, and key features
✅ Auto-Add Location - Automatically add default Ableton project folders when starting fresh or from the sidebar
✅ Find Audio Export Tool - Map exports to projects in a dedicated list view; find orphaned exports and link them to the right .als files
✅ Random Song Name Generator - Generate creative project names for new ideas when starting blank sessions
✅ Dependency Upgrades - Updated dependencies for macOS and Windows installers; improved compatibility and security
✅ Stability Fixes - Code cleanup and stability improvements across the app; more reliable scanning, watcher, and UI

v1.0.7 - Bugfixes (thx PAG!)

✅ No Live Installation Handling - Friendly dialog when double-clicking project cards with actionable "Open Settings" and "Add Live Installation" buttons
✅ Settings: Live Tab - Add Live installations and run Auto-Detect from Settings
✅ Settings: Locations Tab - Add project locations from Settings menu

v1.0.6 - Jaccard Similarity Fixed, Plugin/Device Detection Working

✅ Jaccard Similarity Fixed - Plugin and device similarity matching now works correctly; fixed double-serialization bug that caused character-level set comparisons instead of plugin/device name matching
✅ Plugin Detection Working - Fixed VST2/AU plugin detection (XML attribute vs child element bug); added VST3 support via Vst3PluginInfo
✅ Device Detection Rewritten - Replaced broken hardcoded device list with dynamic detection from XML Devices containers; catches all native Ableton devices including Drift, Meld, Echo, Hybrid Reverb, and any future devices
✅ Arrangement vs Session Clips - Arrangement length now only counts clips on the arrangement timeline; session clip lengths (recorded samples) tracked separately
✅ More Project Metadata - Project Information now shows time signature, track type breakdown (Audio/MIDI/Return), timeline markers, annotation, and session clip length
✅ JSON Storage Fix - Fixed double-encoding of all JSON fields (plugins, devices, samples, markers, export filenames) in scanner and watcher

v1.0.5 - Performance & Stability

✅ Faster UI Navigation - Navigating between views is near-instant; background workers properly cancelled when leaving views
✅ Persistent Metadata in DB - Export filenames, annotations, master track names, and ML feature vectors stored during scanning (no redundant ALS parsing)
✅ Optimized Similarity Analysis - Uses pre-computed feature vectors from the database instead of re-parsing ALS files on demand
✅ Thread Lifecycle Fixes - Non-blocking thread cleanup with orphaned thread tracking prevents QThread crashes and UI freezes
✅ Bug Fixes - Fixed NoneType comparison errors in similarity scoring, graceful dawtool tempo parse error handling, sidebar navigation cleanup

Recently Completed

✅ Timeline Marker Extraction - Extract timeline markers (locators) from projects using dawtool, display in Project Properties, and export to text/CSV
✅ Enhanced Logging System - Comprehensive logging with file rotation, configurable levels, log viewer, and global exception handling
✅ Database Performance Optimizations - SQLite WAL mode, optimized cache, composite indexes for faster queries
✅ GUI Widget Optimizations - Modular architecture with specialized managers, background processing, efficient signal management
✅ Project Similarity & Discovery - Find similar projects using Jaccard similarity algorithm and multi-metric analysis
✅ Similar projects in Project Properties view (embedded in main window)
✅ "Find Similar Projects" context menu option with main window navigation
✅ Similarities Panel with project selector, similarity explanations, and ML-based matches
✅ Smart Collections similarity filter rule
✅ Click-to-play exports on project cards
✅ Automatic export detection during scanning
✅ Smart fuzzy matching for export-to-project linking
✅ Status bar playback display
✅ Tempo filtering and sorting
✅ Musical key and scale detection from project files
✅ Key/scale display in project cards and list view
✅ Sortable list view with column headers (including Key and Version)
✅ In-app audio playback for exports
✅ Project backup and archive system
✅ Backup project detection and exclusion from grid
✅ Backup project access and launch from Project Properties
✅ Missing project detection and cleanup tools
✅ View Missing Projects toggle in View menu
✅ Live preferences and Options.txt access
✅ MCP servers integration links
✅ Smart collection tempo rules
✅ Visual project export indicators
✅ Single project re-scan functionality (right-click context menu)

Planned

Plugin Usage Dashboard: View most-used plugins, plugin combinations, missing plugin warnings
Workflow Analytics Dashboard: Project timeline visualization, productivity metrics, modification trends
ML Cluster Visualization: Visual grouping of similar projects, cluster-based organization
Project Versioning: Automatic version detection, version timeline, version comparison
Statistics Dashboard: Comprehensive analytics with charts and exportable reports
Cloud sync integration

License

MIT License - see LICENSE file for details.

Author

Tom Carlile
Email: carlile.tom@gmail.com

Ableton Certified Trainer and Austin Ableton User Group Organizer
https://www.ableton.com/en/certified-training/tom-carlile/

Disclaimer

This application is an independent, open-source project and is not affiliated with, endorsed by, or connected to Ableton AG. Ableton Live is a trademark of Ableton AG. This tool is designed to help music producers organize their Ableton Live projects and is provided as-is without warranty.

Acknowledgments

Inspired by Ableton Live's workflow and design aesthetic
Built with PyQt6
Uses SQLAlchemy for database management
Ableton for creating amazing music production software

Name		Name	Last commit message	Last commit date
Latest commit History 112 Commits
.github		.github
.specify		.specify
docs		docs
resources		resources
scripts		scripts
specs		specs
src		src
tests		tests
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
MANIFEST.in		MANIFEST.in
README.md		README.md
pyproject.toml		pyproject.toml
pyrightconfig.json		pyrightconfig.json
requirements.txt		requirements.txt
run-ableton-hub.bat		run-ableton-hub.bat

Folders and files

Latest commit

History

Repository files navigation

Ableton Hub

What is Ableton Hub?

Features

Core Functionality

Project Discovery & Management

Project Collections & Organization

Timeline Markers & Export

Search & Discovery

Project Similarity & Discovery

Location Management

Tagging System

Export Tracking

Audio Preview & Playback

Duplicate Detection

Project Status & Cleanup

Ableton Live Integration

Backup & Archive

Ableton Link Network

MCP Servers Integration

User Interface

Enhanced Logging & Diagnostics

First Time Setup

System Architecture

Requirements

Installation

Method 1: Download Installer (Easiest)

Method 2: Install from GitHub (Recommended for Developers)

Method 3: Download Source and Install

Platform-Specific Installation Guides

Additional Resources

For Developers

Building Installers Locally

🔧 Troubleshooting

I can't install Python or pip isn't working

The app won't start

I don't see my projects

Audio playback isn't working

I'm confused by the interface

Something went wrong

Contributing

Roadmap

v1.0.10 - Trusted Installer Release

v1.0.9 - Audio Preview in Collections, Bugfixes, Icon Fixes

v1.0.8 - FTUE, Find Audio Export, Random Song Name

v1.0.7 - Bugfixes (thx PAG!)

v1.0.6 - Jaccard Similarity Fixed, Plugin/Device Detection Working

v1.0.5 - Performance & Stability

Recently Completed

Planned

License

Author

Disclaimer

Acknowledgments

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 5

Packages 0

Uh oh!

Contributors 1

Languages

Packages