Configuration Reference
A comprehensive reference of all configurable fields and settings in the application.
This page serves as a technical reference for all configuration options available in the Roblox Audio Bulk Uploader.
General Configuration
These fields are located in the main Configuration panel and define the core upload behavior.
| Field | Description | Storage |
|---|---|---|
| API Key | Your Roblox Open Cloud API key with Asset:Write and Asset Permissions scopes. | OS Keychain (Primary) or settings.json (Fallback) |
| Creator ID | The exact numeric ID of the User or Group that will own the uploaded audio. | settings.json |
| Creator Type | A dropdown to select either User or Group, matching the target of your Creator ID. | settings.json |
| Upload Delay | The time (in seconds) the application waits between completing one upload and starting the next. Increasing this can help prevent hitting Roblox rate limits on massive batches. | settings.json |
Auto-Grant Permissions
This section configures which external entities are automatically granted "Use" access to your audio after approval. Multiple targets are supported.
| Field | Description |
|---|---|
| Target Type | Dropdown selecting the type of entity to grant access to: Universe, User, or Group. |
| Target ID | The exact numeric ID of the entity. Note that for games, this must be the Universe ID (Experience ID), not the Place ID. |
DataStore Sync (Owner Mode)
This section configures the optional synchronization payload sent to a live Roblox experience via a Bridge Server.
| Field | Description |
|---|---|
| Enable Toggle | Turns the Owner Mode synchronization feature on or off. |
| Category | Dropdown classifying the upload batch: Standard Library (persistent audio) or Event Mix (time-limited audio). |
| Bridge Server URL | The complete public URL of your Node.js Bridge Server, including the protocol (e.g., https://my-bridge.example.com). |
| Bridge Secret | A custom secret string used to authenticate the payload. This must exactly match the secret configured on the Bridge Server. Stored securely via the OS Keychain. |
Mix Audio Controls
These controls define the parameters for the local Digital Signal Processing (DSP) pipeline when using the Mix Audio feature.
| Field | Description |
|---|---|
| Speed Slider | Adjusts the playback speed between 0.5x and 2.5x. This behaves like a turntable resampler, meaning it affects both speed and pitch simultaneously. |
| Gain | Provides overall volume adjustment (in decibels) applied before the final target-peak normalization and export. |
The settings.json File
When the application saves your preferences, it separates sensitive credentials from non-sensitive settings.
The settings.json file (located in your src/ directory) strictly stores your non-credential preferences so you don't have to re-enter them on every launch.
Data stored in settings.json includes:
creator_idcreator_typeupload_delayauto_grant_targetsdatastore_sync_enableddatastore_sync_categorybridge_server_url
(Note: The API Key and Bridge Secret are stored via the OS-level Keychain, unless the Keychain is unavailable, in which case they fall back to settings.json. Refer to the Credential Storage Security guide for details).