Name: GOXLR Utility
Author: GOXLR Utility

Linux Installation

RPM (Fedora, RHEL, CentOS)

Download the RPM package from the Downloads page and install:

sudo rpm -i goxlr-utility-1.2.4-1.x86_64.rpm

DEB (Debian, Ubuntu)

Download the DEB package and install:

sudo dpkg -i goxlr-utility_1.2.4-1_amd64.deb
sudo apt-get install -f

Launch from your application menu or run goxlr-utility in terminal.

macOS Installation

Download the appropriate build for your Mac:

Intel Macs: Download the macOS Intel build
Apple Silicon (M1/M2/M3/M4): Download the macOS M1 build

Open the .dmg file, drag GOXLR Utility to Applications, and launch. You may need to allow the app in System Settings > Privacy & Security on first run.

System Requirements

TC Helicon GoXLR or GoXLR MINI device (USB connection)
Windows: Windows 10 or 11, TC-Helicon GoXLR USB Audio Driver (see Driver / Dice error)
Linux: Kernel 5.4+, PulseAudio or PipeWire
macOS: macOS 12 Monterey or later
Minimum 4 GB RAM, 100 MB disk space
USB 2.0 or higher port

First Run Setup

When you first launch GOXLR Utility with your device connected:

The app will automatically detect your GoXLR device
Follow the guided setup wizard to configure basic audio routing
Choose a default profile or create a custom one
Test audio levels using the built-in meter

Device Profiles

Profiles save your complete device configuration including fader levels, routing, lighting, and effects. Create profiles for different use cases:

Gaming: Optimized chat/game balance
Streaming: Broadcast-ready levels with alerts
Podcasting: Voice-focused with compression

Switch profiles instantly from the profile dropdown or assign keyboard shortcuts.

Audio Routing

The routing matrix allows you to assign audio sources to outputs:

Drag connections between input and output nodes
Configure virtual audio devices for application-specific routing
Use mute groups to silence multiple channels at once

Driver / Dice Error (Windows)

Many users see a Driver or Dice error when starting GoXLR software. This usually means the TC-Helicon GoXLR USB Audio Driver is missing, outdated, or corrupted. Use the steps below before opening GOXLR Utility.

Step 1 — Check if the driver is installed

Open Settings → Apps → Installed apps (Windows 11) or Add or remove programs (Windows 10).
Search for TC-Helicon GoXLR USB Audio Driver.
If it is listed, the driver is installed (you may still need to reinstall it using Step 2).

Step 2 — Close GOXLR apps

Quit GOXLR Utility and the official GoXLR app completely before running the driver installer.

Step 3 — Download and install the driver

Download the official TC-Helicon driver package:

Download TC-Helicon GoXLR Driver (ZIP)

Extract the ZIP file.
Run the installer inside as Administrator (right-click → Run as administrator).
Important: You may need to run the installer more than once. The first run sometimes uninstalls the old driver only; run it again to complete installation.
Restart your computer when finished.

Step 4 — Test

Connect your GoXLR via USB (prefer a direct port, not a hub).
Launch GOXLR Utility.
If the error persists, repeat Step 3 or try another USB port/cable.

Still stuck? Ask on Discord or open an issue on GitHub.

Device Not Detected

Ensure the GoXLR is connected via USB directly (not through a hub)
Try a different USB port or cable
Windows: Install or reinstall the TC-Helicon GoXLR USB driver
Linux: Check udev rules — run lsusb | grep -i helix
macOS: Grant USB permissions in System Settings
Restart GOXLR Utility with the device already connected

Audio Issues

Verify your default audio output is set correctly in system settings
Check fader levels aren't muted or set to zero
Restart the audio subsystem: systemctl restart pipewire (Linux)
Ensure no other application has exclusive access to the device

Permissions

Linux: Add your user to the audio group:

sudo usermod -aG audio $USER

Log out and back in for changes to take effect.

macOS: Allow microphone and USB access in System Settings > Privacy & Security.

Custom Lighting

The lighting editor supports:

Static colors per button and fader
Animated effects (pulse, wave, rainbow — single hue)
Audio-reactive modes tied to channel levels
Import/export lighting presets

Firmware Updates

Check for updates in Settings > Firmware. The app compares your current version with the latest available. Always:

Back up your current profile before updating
Keep the device connected during the entire update
Do not disconnect power or USB during the process

CLI Options

GOXLR Utility supports command-line flags for automation:

goxlr-utility --profile "Streaming"    # Launch with specific profile
goxlr-utility --headless                 # Run without GUI (daemon mode)
goxlr-utility --version                  # Print version info
goxlr-utility --help                     # Show all options

Documentation