installation

Installation

Requirements

Requirement	Minimum
macOS	12 Monterey or later
Python	3.12 or later
Rekordbox	6.x or 7.x (for XML export/import)

Windows / Linux — the application is tested primarily on macOS. It should run on any platform that supports PySide6, but is not officially supported.

---

Install with uv (recommended)

uv is a fast Python package manager. If you don't have it yet:

curl -LsSf https://astral.sh/uv/install.sh | sh

Then install Rekordbox Set List Manager:

# Clone the repository
git clone https://github.com/your-org/set_manager.git
cd set_manager

# Create a virtual environment and install all dependencies
uv sync

---

Install with pip

git clone https://github.com/your-org/set_manager.git
cd set_manager
python -m pip install -e .

---

First launch

# With uv
uv run set-manager

# With pip / activated venv
set-manager
# or
python -m rekordbox_set_list_manager

The main window opens with an empty project. You can start adding sections immediately or connect a streaming service first.

---

Updating

git pull
uv sync   # or: pip install -e .

---

Uninstalling

Delete the cloned folder. Configuration is stored in the system user-data directory:

Platform	Config location
macOS	~/Library/Application Support/rekordbox_set_list_manager/
Linux	~/.config/rekordbox_set_list_manager/
Windows	%APPDATA%\rekordbox_set_list_manager\

Remove that directory to wipe all settings.