Quickstart

This walks you through the core flow: configure your credentials, point at a folder of audio files, and upload. Mixing, Datastore Sync, and auto-grant permissions are covered later — this page keeps things minimal so you can confirm everything works end to end first.

1. Launch the app

python src/main.py

2. Enter your credentials

In the Configuration panel, enter:

Your Roblox Open Cloud API key
Your Creator ID
Your Creator Type (User or Group)

Your API key is stored in your OS keychain (Windows Credential Manager / macOS Keychain) via keyring, with a plaintext JSON fallback only if keyring is unavailable on your system. See Credential Storage for details.

3. Select a folder

Click Select Folder and point it at a folder containing .mp3, .ogg, .wav, or .flac files you have the rights to upload.

Files already present in your local upload history (see Duplicate Detection) will be skipped automatically — you won't spend API quota re-uploading the same audio.

4. Start the upload

Click Start Upload. Progress, moderation status, and any errors appear in the queue table and activity log as the batch runs.

If Roblox rejects any asset during moderation, the entire queue halts immediately to protect your account from repeated moderation strikes. See Handling Moderation Rejections.

What's next?

Need to normalize loudness, change speed/pitch, or split long tracks before uploading? See Mixing Audio Before Upload.
Want approved uploads to sync automatically into your in-game music DataStore? See Setting Up Datastore Sync.
Want uploaded assets to automatically grant access to specific Universes, Users, or Groups? See Setting Up Auto-Grant Permissions.