Installation
Download the installer
Go to onyxradio.xyz and click Download Installer. Extract the zip file and run OnyxRadioSetup.exe.
Complete the installer
Follow the on-screen prompts. The installer will place Onyx Radio in your Start menu and create a desktop shortcut. The .NET 8 runtime is bundled — no manual download required.
Launch the app
Open Onyx Radio from your Start menu or desktop. You'll see the login screen on first launch.
Logging in
Onyx Radio uses Discord OAuth for authentication. Click Login with Discord — your browser will open and ask you to authorize the app. Once authorized, your username and avatar are pulled in automatically.
Onyx Radio only reads your Discord username and avatar — it cannot post messages or access your servers.
Creating a server
Go to My Communities
After login you'll see the My Communities dashboard. Click + Create server.
Redeem a key (first time only)
If you don't have a server yet, you'll be prompted to redeem an access key. Use the key you received after purchase, or reach out via Discord for a free key.
Name your server
Enter your server name. A unique join code is generated automatically (e.g. ONYX-A1B2C3D). Copy this code — you'll share it with your members.
Click Create Server
Your server is live immediately. You'll land in the server dashboard where you can configure channels, roles, and settings.
Joining a server
On the My Communities page, click + Join another, enter the join code shared by the server owner, and click Join. You'll be added instantly and the server will appear in your list.
Push-to-talk (PTT)
PTT lets you transmit voice to everyone in your active channel. To set it up:
- Go to your server dashboard and open a channel.
- Click Set PTT Key in the top bar.
- Press the key or mouse button you want to use. The binding is saved per-server.
- Hold the key to transmit. Release to stop.
You can use keyboard keys or mouse side buttons. The key name is shown in the top bar once set.
Channels
Channels are the rooms within your server. Each channel can have a name and category. To manage channels:
- Open your server dashboard and click Customize.
- Use the Channels section to add, rename, or delete channels.
- Channels can be grouped under categories for organization.
Click any channel in the left panel to tune in. You'll hear everyone who transmits on that channel, and they'll hear you when you use PTT.
Roles & permissions
Roles let you organize members and grant moderation rights. As a server owner:
- Go to Customize → Roles to create roles with custom names and colours.
- Each role can be given permissions: Kick, Ban, or Rename members.
- Open the Members tab to assign roles to specific users.
Server customization (Pro)
Pro servers unlock additional cosmetic and functional settings:
- Server banner — Upload a custom image shown in the server header.
- Accent colour — Set a colour theme for your server using the colour picker.
- Change join code — Update your server's invite code under Settings → Community ID.
- Unlimited members — Free servers are capped at 25 members; Pro removes this limit.
Auto-updates
Onyx Radio checks for updates each time it launches. When a new version is available, it downloads and installs silently in the background. You'll see a toast notification when an update is ready — restart the app to apply it.
Roblox integration
Onyx Radio supports optional Roblox account linking. Go to Profile & Integrations and click Link Roblox. This opens a browser-based authorization flow. Your Roblox username will display alongside your Discord name in the app.