From 5cec88cc63cadf3d212165f105c3839f6e7addac Mon Sep 17 00:00:00 2001 From: Naia Date: Thu, 28 Aug 2025 21:03:17 +0200 Subject: [PATCH] Add common issues with audio on Resonite --- content/docs/resonite/_index.md | 37 +++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index 5f85011..3725a2b 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -29,6 +29,43 @@ Currently, viseme analysis does not work on Linux due to Meta not providing a Li There is an experimental mod developed by the community that allows for viseme analysis under Linux - https://github.com/KyuubiYoru/VisemesAtHome. +## Clipboard + +As of the splittening release, Resonite only supports copy/pasting text, and does not work at all in Flatpak Steam with Wayland [(issue)](https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/5321). + +This mod provides full clipboard functionality, but only works on Wayland: https://github.com/GrandtheUK/ResoniteLinuxClipboard + +## Audio Issues + +Resonite uses SDL for audio on Linux, but the current implementation can be a bit flaky. + +In particular, the WiVRn microphone [is known to be glitchy](https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/5260). + +It is recommended that you use PipeWire as your system's audio service, including its PulseAudio and ALSA support. + +The game will default to the PipeWire API if it can, falling back to the PulseAudio API. + +### Glitchy audio + +The most straightforward way to fix a glitchy microphone is to use SDL's ALSA driver with `SDL_AUDIO_DRIVER=alsa %command%` as the launch argument on Steam. + +If that doesn't work, you can try forcing the other drivers by specifying `pipewire` or `pulseaudio` instead of `alsa` in the above launch arguments. + +If you want to use the PulseAudio driver, you may need `SDL_AUDIO_DRIVER=pulseaudio PULSE_LATENCY_MSEC=15 PULSE_BUFFER_MSEC=250 PULSE_FRAGMENT_SIZE_MSEC=25 %command%` as the launch arguments. + +### Virtual audio sources/sinks + +To be able to chose a virtual sink, you have two options: + +1. Use `SDL_AUDIO_INCLUDE_MONITORS=1`, but this works with the PulseAudio driver *only* (add it next to your other env var in launch arguments). +2. Select any other source in Resonite, and manually connect the wanted input or output to Resonite's sink using a PipeWire graph GUI (e.g. Coppwr, Qwpgraph, Helvum) + +Do note that for the Audio Stream feature of Resonite, you'll need to select a different source that the one you are using as your microphone, or else SDL will **not** create a sink dedicated for it. If you only have one input, use the Steam voice option. + +### Flatpak + +The PipeWire driver is not supported by Steam Flatpak OOtB, see [this issue](https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/5261#issuecomment-3228033460) if you need to use the PipeWire driver on Resonite in Steam Flatpak. + ## FlipVR controller support with Monado Currently there is an experimental Monado branch that works with Shiftall FlipVR controllers. Instructions can be found [here](/docs/fossvr/monado/flipvr/). At the time of writing, this branch is the only way to use FlipVR controllers with Resonite, as they are not supported even through SteamVR on Windows.