Installation

Requirements

• Python 3.10+
• Node.js — only needed if you plan to run the bridge server for Datastore Sync (Owner Mode). If you're just uploading audio without in-game sync, you can skip this.
• A Roblox Open Cloud API key with Asset:Write scope (and optionally Asset:Read, Asset Permissions) — see Getting Your API Key if you don't have one yet.

Install the Python application

Clone the repository, then from the project root:

pip install -r requirements.txt

This installs the GUI framework (CustomTkinter), the audio DSP pipeline (pedalboard), and credential storage (keyring), among other dependencies.

Install the bridge server (optional)

Only needed if you'll use Datastore Sync. From the repository root (where package.json lives):

npm install

Verify your setup

Launch the application:

python src/main.py

If the window opens and shows the configuration panel, folder selection, and queue table, your installation is working. Next, head to the Quickstart to upload your first batch of audio.