Jabridge: Jabra Direct for Linux

Jabra headset and dongle controls for Linux. Think Jabra Direct, built by the community for Linux.

1.0.0 is the native Go rewrite of jLink. One app gives you a terminal menu, simple commands, settings, sound controls and firmware updates for supported models. No Jabra SDK is needed. This is not an official Jabra product.

Jabridge 1.1.0 with a Link 390 and Evolve3 85, using sample data. Your menus depend on your device.

Extract the Linux download, open that folder in a terminal and run setup first:

./jabridge setup

Follow the prompts. Then open the menu:

./jabridge

Or install with Go 1.27.1 or newer, run setup and open the menu:

go install github.com/Watchdog0x/jabridge/cmd/jabridge@latest
jabridge setup
jabridge

Make sure Go's bin folder is in your PATH.

Long lists scroll as you move. Choose Quit from the main menu to close the app.

With a Link 380, choose Find headset and put your headset in pairing mode. Q stops the search.

When you open Jabridge in a terminal, it checks for a new app version. If one is available, the menu shows an update screen. Press Y to update or N to continue. You can also use the arrow keys and Enter; No is selected by default.

Example update from 1.0.2 to 1.1.0. No is selected by default.

The command line asks:

A new Jabridge update is available: VERSION
Update now? (yes/no) [no]:

Type yes to update and restart, or no to continue. Enter also means no. The prompt appears before the menu or command starts. If the check fails or takes more than two seconds, Jabridge continues normally. Scripts and background services do not get the prompt.

You can also update directly:

./jabridge update

This updates the app, not your device firmware.

Switch between ANC, HearThrough and Off:

jabridge settings set headset.noise-control anc
jabridge settings set headset.noise-control hearthrough
jabridge settings set headset.noise-control off

These modes were tested on Evolve2 85 through Link 380 in PR #48. Direct USB is untested. The mixed HearThrough mode and HearThrough level are not offered.

For supported Evolve2 30 SE models with firmware 1.11.0, connected directly by USB:

jabridge headset volume 50

Start audio playback, then use this command to change the headset’s own volume. The headset rounds requests to its internal steps. At a volume limit, it may also send a normal volume key to Linux. jabridge sound volume controls Linux volume separately.

Check support for your selected model and connection:

jabridge headset volume info

Read the saved headset level:

jabridge headset volume get

The saved level can differ from the current playback volume. Running jabridge headset volume without a value also reads the saved level.

Volume writes and saved-level reads have been tested on the Evolve2 30 SE (0b0e:0e36) from issue #44. The four USB variants (0e36, 0e37, 0e38 and 0e39) have model-specific checks tested against their original firmware. The other three variants still need physical testing. Saved readings can stay unchanged for several seconds after a volume request and do not verify current playback. A headset-volume command through a Link dongle is still being investigated; it is not enabled yet.

Open Firmware in the menu, choose your device and press Enter. Follow the prompts to update. Keep the device plugged in until it finishes.

To check for firmware updates from the command line, run ./jabridge firmware.

Support depends on your device. See tested devices and firmware recovery.

Evolve2 40 firmware preparation still times out in the latest hardware report. A complete update is not confirmed. See the known firmware limitation.

See all commands:

./jabridge --help

If audio is playing but you hear nothing, this experimental command tries the recovery sequence reported in issue #44. It currently supports Evolve2 30 SE connected directly by USB.

Stop calls and recordings first, keep audio playback running, then run:

jabridge sound recover

This briefly opens the headset microphone and discards the captured audio while restarting playback. It leaves volume, mute and the selected audio profile alone. Check whether you can hear sound afterward. Audible recovery has not been confirmed. This command does not fix the separate Linux kernel mixer problem.

Before opening an issue, save a debug report:

./jabridge debug --output jabridge-debug.txt

If that file already exists, Jabridge saves a new report as jabridge-debug-1.txt, then jabridge-debug-2.txt, and so on. The command shows the exact file to attach.

Check that file before sharing it. Then open an issue, attach the file and tell us your device model and what went wrong. Debug does not change settings or firmware.

The service shares device state and controls through IPC. Build a GNOME, KDE, Hyprland or other frontend using the simple IPC guide. No applet is bundled.

For the source code, start with the codebase guide.

Thanks to am4c130d, delacor and Danfro for testing, reports and screenshots. Thanks also to keydon, zetneteork, Atem18 and everyone helping the project.

License · Release notes

Jabra Direct Linux · Jabra headset Linux support · Jabra Linux command-line tool · Manage Jabra devices on Linux · Jabra Link 380 Linux · Jabra Evolve2 85 Linux