wavexlr-on-linux-cfg

KO | EN

gitlite — search

#javascript #python #react #ai #llm #golang #android #machine-learning #rust #deep-learning #macos #cli #openai #open-source

wavexlr-on-linux-cfg

(★ 70)

Unofficial instructions to fix issues with Wave XLR on Linux

wavexlr-on-linux-cfg Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Wave XLR on Linux

Unofficial instructions to fix issues with Wave XLR (also Wave 1, Wave 3 and XLR Dock) on Linux.

As of November 2024, Wave XLR does not have official Linux support - [Elgato Wave XLR - System Requirements](https://help.elgato.com/hc/en-us/articles/4404864886157-Elgato-Wave-XLR-System-Requirements).

However, since the device is recognized by the system as a standard USB audio device, some functionality can be accessed on Linux.

> **Disclaimer**: The instructions and information on this page are unofficial and not endorsed or supported by device manufacturer - Elgato. 
> The content of this page is based on my personal experience and may not work in all cases.
> I cannot guarantee the accuracy or reliability of the information provided. Use at your own risk. No warranties or guarantees, express or implied, are provided.

## Issues

### No audio signal from the microphone

When the device is used for both playback and recording, the microphone produces no audio signal.

Other users have reported the same issue:
* [endeavouros forum post](https://forum.endeavouros.com/t/cannot-use-mic-when-output-input-are-selected-on-sound-device/43275/13)
* [pipewire issue #3587](https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/3587)

After some trial and error, I found that the issue is most likely not related to [pipewire](https://pipewire.org/) and is more low-level. It's reproducible with playback and recording from raw ALSA devices without pipewire or pulseaudio running.

If you start playing an audio and then initiate recording from the microphone, there is no signal detected from the microphone. However, when the process is reversed, starting the recording first then playback, everything seems to work fine.

#### The workaround

These instructions assume your Linux distribution uses [pipewire](https://pipewire.org/) and [wireplumber](https://pipewire.pages.freedesktop.org/wireplumber/) `>=0.5`.

The steps below configure wireplumber so that Wave XLR playback node is created only after the microphone source is activated.
A custom script creates a virtual sink node and links it to the microphone source, forcing the device to start and keep the microphone capture active.

##### Step 1. Disable the autoconfigured playback sink and define a custom Lua script.

Create the directory if it doesn't exist `~/.config/wireplumber/wireplumber.conf.d/`:
```
mkdir -p ~/.config/wireplumber/wireplumber.conf.d/
```

For Wave XLR: create [~/.config/wireplumber/wireplumber.conf.d/51-wavexlr.conf](./files/cfg1/51-wavexlr.conf) file.

For Wave 3: create [~/.config/wireplumber/wireplumber.conf.d/51-wave3.conf](./files/cfg1/51-wave3.conf) file.

For Wave 1: create [~/.config/wireplumber/wireplumber.conf.d/51-wave1.conf](./files/cfg1/51-wave1.conf) file.

For XLR Dock: create [~/.config/wireplumber/wireplumber.conf.d/51-xlrdock.conf](./files/cfg1/51-xlrdock.conf) file.

##### Step 2. Create a custom wireplumber script.

Create the directory if it doesn't exist `~/.local/share/wireplumber/scripts/`:
```
mkdir -p ~/.local/share/wireplumber/scripts/
```

Create the file [~/.local/share/wireplumber/scripts/wavedevicefix.lua](./files/cfg1/wavedevicefix.lua)

> **IMPORTANT**
> If you’re upgrading from a version released before December 2025, be aware that the script file has been renamed from `wavexlrfix.lua` to `wavedevicefix.lua`. Make sure to also replace your old configuration file with the updated version provided above.

#### The workaround (Alternative)

**This fix doesn't work for me anymore**

The following alternative solution was reported in [#15](https://github.com/jmansar/wavexlr-on-linux-cfg/issues/15). It is much simpler, however it stopped working for me after one of the system updates. I'm going to leave it here for now, in case someone finds it useful and it works on their system.

These instructions assume your Linux distribution uses [pipewire](https://pipewire.org/) and [wireplumber](https://pipewire.pages.freedesktop.org/wireplumber/) `>=0.5`.
> Note: For wireplumber version 0.4, such as the one installed on Ubuntu 22.04 LTS, refer to the instructions [here](#wireplumber-04).

Create the directory if it doesn't exist `~/.config/wireplumber/wireplumber.conf.d/`:
```
mkdir -p ~/.config/wireplumber/wireplumber.conf.d/
```

For Wave XLR: create [~/.config/wireplumber/wireplumber.conf.d/51-wavexlr.conf](./files/cfg2/51-wavexlr.conf) file.

For Wave 3: create [~/.config/wireplumber/wireplumber.conf.d/51-wave3.conf](./files/cfg2/51-wave3.conf) file.

For Wave 1: create [~/.config/wireplumber/wireplumber.conf.d/51-wave1.conf](./files/cfg2/51-wave1.conf) file.

For XLR Dock: create [~/.config/wireplumber/wireplumber.conf.d/51-xlrdock.conf](./files/cfg2/51-xlrdock.conf) file.

The configuration sets the `node.always-process` property to `true` on the device source node (microphone input).

##### Wireplumber 0.4

Create the directory if it doesn't exist `~/.config/wireplumber/main.lua.d/`:
```
mkdir -p ~/.config/wireplumber/main.lua.d/
```

For Wave XLR: create [~/.config/wireplumber/main.lua.d/51-wavexlr.lua](./files/cfg2/51-wavexlr.lua) file.

For Wave 3: create [~/.config/wireplumber/main.lua.d/51-wave3.lua](./files/cfg2/51-wave3.lua) file.

For Wave 1: create [~/.config/wireplumber/main.lua.d/51-wave1.lua](./files/cfg2/51-wave1.lua) file.

For XLR Dock: create [~/.config/wireplumber/main.lua.d/51-xlrdock.lua](./files/cfg2/51-xlrdock.lua) file.

#### Troubleshooting

If the workaround fails, try restarting the wireplumber:
```
systemctl restart --user wireplumber
```

To view wireplumber logs 
```
journalctl -u wireplumber --user --lines 30
```

## Changelog

### 2026-04-12
* Revert to using original workaround for the microphone issue. [#31](https://github.com/jmansar/wavexlr-on-linux-cfg/pull/31)

### 2026-03-20
* Add instructions for Wave 1. Reported in [#27](https://github.com/jmansar/wavexlr-on-linux-cfg/issues/27).

### 2026-02-15
* Add instructions for XLR Dock. Reported in [#25](https://github.com/jmansar/wavexlr-on-linux-cfg/issues/25).

### 2026-01-24
* Add instructions for wireplumber 0.4 which is used on older systems. Reported in [#18](https://github.com/jmansar/wavexlr-on-linux-cfg/issues/18).

### 2026-01-11
* Add instructions for a new, much simpler workaround reported in [#15](https://github.com/jmansar/wavexlr-on-linux-cfg/issues/15).

### 2025-12-06

* Fix intermittent failures when creating a null sink link. [#12](https://github.com/jmansar/wavexlr-on-linux-cfg/pull/12)
* Add instructions for Wave 3, adjust the config and the script. [#13](https://github.com/jmansar/wavexlr-on-linux-cfg/pull/13)
* Set `session.suspend-timeout-seconds: 0` on the device sink. [#13](https://github.com/jmansar/wavexlr-on-linux-cfg/pull/13)

### 2025-11-29
* Add device profile properties to WaveXLR Sink for audio mixer compatibility. [#11](https://github.com/jmansar/wavexlr-on-linux-cfg/pull/11)

## Contributing

If you'd like to suggest improvements to these instructions, please raise an issue or a PR on this [repository](https://github.com/jmansar/wavexlr-on-linux-cfg).

## License

[MIT License](https://github.com/jmansar/wavexlr-on-linux-cfg/blob/main/LICENSE)

wavexlr-on-linux-cfg

wavexlr-on-linux-cfg Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

wavexlr-on-linux-cfg

wavexlr-on-linux-cfg Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README