From b844360efa2eea47b865342d50eabd96a684e4f4 Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 13:28:19 +0000
Subject: [PATCH 01/22] Shooting the troubles away

---
 content/docs/resonite/_index.md | 40 ++++++++++++++++++++++++++++++++-
 1 file changed, 39 insertions(+), 1 deletion(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index cbcf7ac..1d10a69 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -41,7 +41,27 @@ The game will default to the PipeWire API if it can, falling back to the PulseAu
 
 ### 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.
+The most straightforward way to fix a glitchy microphone is to force the use of **SDL's ALSA driver** for Resonite's audio:
+1. Set the launch argument:
+Add the following to Resonite's Launch Options: 
+````SDL_AUDIO_DRIVER=alsa %command%````
+**Note:** If you already have `%command%` in your launch arguments, simply add `SDL_AUDIO_DRIVER=alsa` **before** it.
+2. Configure PipeWire for ALSA:
+For most users, switching to ALSA **will break all audio** in Resonite unless you configure your audio server, PipeWire, to support your hardware's sample rates.
+If this happens:
+    1. Locate the directory or create it if it doesn't exist:
+    ```$HOME/.config/pipewire/pipewire.conf.d/```
+        (Remember: The ~/.config folder is often hidden in file browsers)
+    2. Create the file `01-sample-rates.conf` in that folder. The full path should be 
+    ```$HOME/.config/pipewire/pipewire.conf.d/01-sample-rates.conf```
+    3. Paste the following content into the file to define supported sample rates, and save it:
+    ```
+    context.properties = {
+    default.clock.allowed-rates = [ 44100 48000 88200 96000 ]
+    default.clock.rate  = 48000
+    }
+
+    ```
 
 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.
 
@@ -60,6 +80,10 @@ Do note that for the Audio Stream feature of Resonite, you'll need to select a d
 
 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.
 
+### There is mic audio after a crash
+
+If you're using WiVRn, close and reopen it (this will crash Resonite).
+
 ## 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.
@@ -115,6 +139,20 @@ It may be enough to just verify file integrity in some cases.
 
 On GE-Proton9-10 (for example), loading into a world with e.g. a YouTube video or live stream can crash the game. Try using the latest GE-Proton-RTSP release.
 
+### Crash after loading
+
+Although this is rare, some proton updates can start crashing Resonite repetitively.
+
+Symptoms:
+- Crashes approximately 1 minute after successfully loading Resonite
+- Everything freezes in both desktop mode and VR, but you can still hear sounds, including the voices of other users
+
+If this happens, just switch Proton to another version in the compatibility options.
+
+### No launch and no crash
+
+Choose the correct default audio devices in your volume panel. This is likely caused by SDL.
+
 ## Controls busted after switching to desktop
 
 Resonite allows a VR player to take a break and switch to desktop mode by pressing the F8 key.
-- 
2.49.1


From e9be15c3112d0df62b0e296e38f630a0c7a080b1 Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 13:29:02 +0000
Subject: [PATCH 02/22] fix

---
 content/docs/resonite/_index.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index 1d10a69..45c16c8 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -43,10 +43,12 @@ The game will default to the PipeWire API if it can, falling back to the PulseAu
 
 The most straightforward way to fix a glitchy microphone is to force the use of **SDL's ALSA driver** for Resonite's audio:
 1. Set the launch argument:
+
 Add the following to Resonite's Launch Options: 
 ````SDL_AUDIO_DRIVER=alsa %command%````
 **Note:** If you already have `%command%` in your launch arguments, simply add `SDL_AUDIO_DRIVER=alsa` **before** it.
 2. Configure PipeWire for ALSA:
+
 For most users, switching to ALSA **will break all audio** in Resonite unless you configure your audio server, PipeWire, to support your hardware's sample rates.
 If this happens:
     1. Locate the directory or create it if it doesn't exist:
-- 
2.49.1


From a5b2db1d7afdf05ad27fb62024bfcff53886690a Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 13:30:13 +0000
Subject: [PATCH 03/22] fix fix

---
 content/docs/resonite/_index.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index 45c16c8..4b3a0cd 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -42,20 +42,25 @@ The game will default to the PipeWire API if it can, falling back to the PulseAu
 ### Glitchy audio
 
 The most straightforward way to fix a glitchy microphone is to force the use of **SDL's ALSA driver** for Resonite's audio:
+
 1. Set the launch argument:
 
 Add the following to Resonite's Launch Options: 
 ````SDL_AUDIO_DRIVER=alsa %command%````
 **Note:** If you already have `%command%` in your launch arguments, simply add `SDL_AUDIO_DRIVER=alsa` **before** it.
+
 2. Configure PipeWire for ALSA:
 
 For most users, switching to ALSA **will break all audio** in Resonite unless you configure your audio server, PipeWire, to support your hardware's sample rates.
 If this happens:
-    1. Locate the directory or create it if it doesn't exist:
+
+     1. Locate the directory or create it if it doesn't exist:
     ```$HOME/.config/pipewire/pipewire.conf.d/```
         (Remember: The ~/.config folder is often hidden in file browsers)
+
     2. Create the file `01-sample-rates.conf` in that folder. The full path should be 
     ```$HOME/.config/pipewire/pipewire.conf.d/01-sample-rates.conf```
+
     3. Paste the following content into the file to define supported sample rates, and save it:
     ```
     context.properties = {
-- 
2.49.1


From 8ec5d1b5cab497a31d04f021643c5cc877a0847a Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 13:31:18 +0000
Subject: [PATCH 04/22] fix fix fix (I hope)

---
 content/docs/resonite/_index.md | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index 4b3a0cd..8275316 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -54,21 +54,21 @@ Add the following to Resonite's Launch Options:
 For most users, switching to ALSA **will break all audio** in Resonite unless you configure your audio server, PipeWire, to support your hardware's sample rates.
 If this happens:
 
-     1. Locate the directory or create it if it doesn't exist:
-    ```$HOME/.config/pipewire/pipewire.conf.d/```
-        (Remember: The ~/.config folder is often hidden in file browsers)
+1. Locate the directory or create it if it doesn't exist:
+```$HOME/.config/pipewire/pipewire.conf.d/```
+(Remember: The ~/.config folder is often hidden in file browsers)
 
-    2. Create the file `01-sample-rates.conf` in that folder. The full path should be 
-    ```$HOME/.config/pipewire/pipewire.conf.d/01-sample-rates.conf```
+2. Create the file `01-sample-rates.conf` in that folder. The full path should be 
+```$HOME/.config/pipewire/pipewire.conf.d/01-sample-rates.conf```
 
-    3. Paste the following content into the file to define supported sample rates, and save it:
-    ```
-    context.properties = {
-    default.clock.allowed-rates = [ 44100 48000 88200 96000 ]
-    default.clock.rate  = 48000
-    }
+3. Paste the following content into the file to define supported sample rates, and save it:
+```
+context.properties = {
+default.clock.allowed-rates = [ 44100 48000 88200 96000 ]
+default.clock.rate  = 48000
+}
 
-    ```
+```
 
 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.
 
-- 
2.49.1


From 1eccc933c51ce3f43cfe4efd6054f7616997e04c Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 13:36:43 +0000
Subject: [PATCH 05/22] improved, also added a joke

---
 content/docs/resonite/_index.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index 8275316..5df2ade 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -156,7 +156,11 @@ Symptoms:
 
 If this happens, just switch Proton to another version in the compatibility options.
 
-### No launch and no crash
+### Crash before loading
+
+Symptoms:
+- Resonite doesn't launch
+- Steam indefinitely shows Resonite is running and lets you press STOP
 
 Choose the correct default audio devices in your volume panel. This is likely caused by SDL.
 
-- 
2.49.1


From 35740d340f3e7f1a131467f12a42004bc450b2f3 Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 13:42:28 +0000
Subject: [PATCH 06/22] an attempt at indentation

---
 content/docs/resonite/_index.md | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index 5df2ade..3c7c098 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -54,21 +54,21 @@ Add the following to Resonite's Launch Options:
 For most users, switching to ALSA **will break all audio** in Resonite unless you configure your audio server, PipeWire, to support your hardware's sample rates.
 If this happens:
 
-1. Locate the directory or create it if it doesn't exist:
-```$HOME/.config/pipewire/pipewire.conf.d/```
-(Remember: The ~/.config folder is often hidden in file browsers)
+    1. Locate the directory or create it if it doesn't exist:
+    ```$HOME/.config/pipewire/pipewire.conf.d/```
+    (Remember: The ~/.config folder is often hidden in file browsers)
+    
+    2. Create the file `01-sample-rates.conf` in that folder. The full path should be 
+    ```$HOME/.config/pipewire/pipewire.conf.d/01-sample-rates.conf```
 
-2. Create the file `01-sample-rates.conf` in that folder. The full path should be 
-```$HOME/.config/pipewire/pipewire.conf.d/01-sample-rates.conf```
+    3. Paste the following content into the file to define supported sample rates, and save it:
+    ```
+    context.properties = {
+    default.clock.allowed-rates = [ 44100 48000 88200 96000 ]
+    default.clock.rate  = 48000
+    }
 
-3. Paste the following content into the file to define supported sample rates, and save it:
-```
-context.properties = {
-default.clock.allowed-rates = [ 44100 48000 88200 96000 ]
-default.clock.rate  = 48000
-}
-
-```
+    ```
 
 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.
 
-- 
2.49.1


From b2dcb550268225cbcb28a57989258a9937601f70 Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 13:43:57 +0000
Subject: [PATCH 07/22] attempting

---
 content/docs/resonite/_index.md | 27 +++++++++++++--------------
 1 file changed, 13 insertions(+), 14 deletions(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index 3c7c098..a0089a9 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -54,20 +54,19 @@ Add the following to Resonite's Launch Options:
 For most users, switching to ALSA **will break all audio** in Resonite unless you configure your audio server, PipeWire, to support your hardware's sample rates.
 If this happens:
 
-    1. Locate the directory or create it if it doesn't exist:
-    ```$HOME/.config/pipewire/pipewire.conf.d/```
-    (Remember: The ~/.config folder is often hidden in file browsers)
-    
-    2. Create the file `01-sample-rates.conf` in that folder. The full path should be 
-    ```$HOME/.config/pipewire/pipewire.conf.d/01-sample-rates.conf```
-
-    3. Paste the following content into the file to define supported sample rates, and save it:
-    ```
-    context.properties = {
-    default.clock.allowed-rates = [ 44100 48000 88200 96000 ]
-    default.clock.rate  = 48000
-    }
-
+   1. Locate the directory or create it if it doesn't exist:
+   ```$HOME/.config/pipewire/pipewire.conf.d/```
+   (Remember: The ~/.config folder is often hidden in file browsers)
+   
+   2. Create the file `01-sample-rates.conf` in that folder. The full path should be 
+   ```$HOME/.config/pipewire/pipewire.conf.d/01-sample-rates.conf```
+   
+   3. Paste the following content into the file to define supported sample rates, and save it:
+   ```
+   context.properties = {
+   default.clock.allowed-rates = [ 44100 48000 88200 96000 ]
+   default.clock.rate  = 48000
+   }
     ```
 
 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.
-- 
2.49.1


From 8cf341d8fb2797fa24be4d1528f0fd0f4547a588 Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 13:44:28 +0000
Subject: [PATCH 08/22] oops

---
 content/docs/resonite/_index.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index a0089a9..f38e39e 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -55,13 +55,16 @@ For most users, switching to ALSA **will break all audio** in Resonite unless yo
 If this happens:
 
    1. Locate the directory or create it if it doesn't exist:
+   
    ```$HOME/.config/pipewire/pipewire.conf.d/```
    (Remember: The ~/.config folder is often hidden in file browsers)
    
    2. Create the file `01-sample-rates.conf` in that folder. The full path should be 
+   
    ```$HOME/.config/pipewire/pipewire.conf.d/01-sample-rates.conf```
    
    3. Paste the following content into the file to define supported sample rates, and save it:
+   
    ```
    context.properties = {
    default.clock.allowed-rates = [ 44100 48000 88200 96000 ]
-- 
2.49.1


From 53ee76bb58e31a5cc9be07c31c6e4ffc7304b873 Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 13:44:55 +0000
Subject: [PATCH 09/22] ah

---
 content/docs/resonite/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index f38e39e..f98509c 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -70,7 +70,7 @@ If this happens:
    default.clock.allowed-rates = [ 44100 48000 88200 96000 ]
    default.clock.rate  = 48000
    }
-    ```
+   ```
 
 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.
 
-- 
2.49.1


From cefba9568858bf709df8205ded016d250be2bb27 Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 13:47:11 +0000
Subject: [PATCH 10/22] test

---
 content/docs/resonite/_index.md | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index f98509c..9325127 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -55,9 +55,8 @@ For most users, switching to ALSA **will break all audio** in Resonite unless yo
 If this happens:
 
    1. Locate the directory or create it if it doesn't exist:
-   
-   ```$HOME/.config/pipewire/pipewire.conf.d/```
-   (Remember: The ~/.config folder is often hidden in file browsers)
+       ```$HOME/.config/pipewire/pipewire.conf.d/```
+       (Remember: The ~/.config folder is often hidden in file browsers)
    
    2. Create the file `01-sample-rates.conf` in that folder. The full path should be 
    
-- 
2.49.1


From 2782971a8d05e50329c69aaad7b37e2c61beccaf Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 13:47:53 +0000
Subject: [PATCH 11/22] test2

---
 content/docs/resonite/_index.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index 9325127..f5455fb 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -55,8 +55,8 @@ For most users, switching to ALSA **will break all audio** in Resonite unless yo
 If this happens:
 
    1. Locate the directory or create it if it doesn't exist:
-       ```$HOME/.config/pipewire/pipewire.conf.d/```
-       (Remember: The ~/.config folder is often hidden in file browsers)
+        ```$HOME/.config/pipewire/pipewire.conf.d/```
+        (Remember: The ~/.config folder is often hidden in file browsers)
    
    2. Create the file `01-sample-rates.conf` in that folder. The full path should be 
    
-- 
2.49.1


From 81ddd6f5da1faa1fb3d962526b859fceff2c36f3 Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 13:48:41 +0000
Subject: [PATCH 12/22] test3

---
 content/docs/resonite/_index.md | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index f5455fb..0a94628 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -55,15 +55,13 @@ For most users, switching to ALSA **will break all audio** in Resonite unless yo
 If this happens:
 
    1. Locate the directory or create it if it doesn't exist:
-        ```$HOME/.config/pipewire/pipewire.conf.d/```
-        (Remember: The ~/.config folder is often hidden in file browsers)
+   ```$HOME/.config/pipewire/pipewire.conf.d/```
+   (Remember: The ~/.config folder is often hidden in file browsers)
    
    2. Create the file `01-sample-rates.conf` in that folder. The full path should be 
-   
    ```$HOME/.config/pipewire/pipewire.conf.d/01-sample-rates.conf```
    
    3. Paste the following content into the file to define supported sample rates, and save it:
-   
    ```
    context.properties = {
    default.clock.allowed-rates = [ 44100 48000 88200 96000 ]
-- 
2.49.1


From 91f720cb6a5dab2a908d5192395c1d8175d47ab9 Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 13:49:33 +0000
Subject: [PATCH 13/22] final?

---
 content/docs/resonite/_index.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index 0a94628..72fae57 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -47,6 +47,7 @@ The most straightforward way to fix a glitchy microphone is to force the use of
 
 Add the following to Resonite's Launch Options: 
 ````SDL_AUDIO_DRIVER=alsa %command%````
+
 **Note:** If you already have `%command%` in your launch arguments, simply add `SDL_AUDIO_DRIVER=alsa` **before** it.
 
 2. Configure PipeWire for ALSA:
-- 
2.49.1


From 88fb4938a0be0360596da89697f862ed85e0df8c Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 13:55:31 +0000
Subject: [PATCH 14/22] final final

---
 content/docs/resonite/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index 72fae57..1d59033 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -87,7 +87,7 @@ Do note that for the Audio Stream feature of Resonite, you'll need to select a d
 
 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.
 
-### There is mic audio after a crash
+### No mic audio after a crash
 
 If you're using WiVRn, close and reopen it (this will crash Resonite).
 
-- 
2.49.1


From 432d40577b015771ad982351e1f45a299666e23f Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 14:44:35 +0000
Subject: [PATCH 15/22] small change

---
 content/docs/resonite/_index.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index 1d59033..547443a 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -56,11 +56,11 @@ For most users, switching to ALSA **will break all audio** in Resonite unless yo
 If this happens:
 
    1. Locate the directory or create it if it doesn't exist:
-   ```$HOME/.config/pipewire/pipewire.conf.d/```
-   (Remember: The ~/.config folder is often hidden in file browsers)
+   ```~/.config/pipewire/pipewire.conf.d/```
+   (Remember: The `~/.config` folder is often hidden in file browsers and could be `$XDG_CONFIG_HOME` on some systems)
    
    2. Create the file `01-sample-rates.conf` in that folder. The full path should be 
-   ```$HOME/.config/pipewire/pipewire.conf.d/01-sample-rates.conf```
+   ```~/.config/pipewire/pipewire.conf.d/01-sample-rates.conf```
    
    3. Paste the following content into the file to define supported sample rates, and save it:
    ```
-- 
2.49.1


From 6b518593a5eed732065d9b89d7d8121640e67fed Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 14:45:58 +0000
Subject: [PATCH 16/22] more changes

---
 content/docs/resonite/_index.md | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index 547443a..e220786 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -55,12 +55,11 @@ Add the following to Resonite's Launch Options:
 For most users, switching to ALSA **will break all audio** in Resonite unless you configure your audio server, PipeWire, to support your hardware's sample rates.
 If this happens:
 
-   1. Locate the directory or create it if it doesn't exist:
-   ```~/.config/pipewire/pipewire.conf.d/```
-   (Remember: The `~/.config` folder is often hidden in file browsers and could be `$XDG_CONFIG_HOME` on some systems)
+   1. Locate the directory or create it if it doesn't exist: `~/.config/pipewire/pipewire.conf.d/`.
    
-   2. Create the file `01-sample-rates.conf` in that folder. The full path should be 
-   ```~/.config/pipewire/pipewire.conf.d/01-sample-rates.conf```
+   Remember: The `~/.config` folder is normally hidden in file browsers and could be `$XDG_CONFIG_HOME` on some systems.
+   
+   2. Create the file `01-sample-rates.conf` in that folder. The full path should be `~/.config/pipewire/pipewire.conf.d/01-sample-rates.conf`.
    
    3. Paste the following content into the file to define supported sample rates, and save it:
    ```
-- 
2.49.1


From 55d16b7c6d27d44efdd7f418286fd005eab66630 Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 19:41:07 +0000
Subject: [PATCH 17/22] Specified who needs to use ALSA... with flavor text

---
 content/docs/resonite/_index.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index e220786..34b36b5 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -39,20 +39,20 @@ It is recommended that you use PipeWire as your system's audio service, includin
 
 The game will default to the PipeWire API if it can, falling back to the PulseAudio API.
 
-### Glitchy audio
+### Crackling microphone
 
-The most straightforward way to fix a glitchy microphone is to force the use of **SDL's ALSA driver** for Resonite's audio:
+Unfortunately, it seems that **every WiVRn user experiences crackling mic issues by default** before manually switching to the legacy ALSA driver:
 
-1. Set the launch argument:
+1. Force Resonite to use ALSA:
 
 Add the following to Resonite's Launch Options: 
 ````SDL_AUDIO_DRIVER=alsa %command%````
 
-**Note:** If you already have `%command%` in your launch arguments, simply add `SDL_AUDIO_DRIVER=alsa` **before** it.
+**Note:** If you already have `%command%` in your launch arguments, simply add `SDL_AUDIO_DRIVER=alsa` **before** it. Continue with step 2.
 
-2. Configure PipeWire for ALSA:
+2. Configure PipeWire for legacy mode:
 
-For most users, switching to ALSA **will break all audio** in Resonite unless you configure your audio server, PipeWire, to support your hardware's sample rates.
+For most if not all users, using ALSA _will_ bork your audio until you've manually configured PipeWire to support your hardware's sample rates.
 If this happens:
 
    1. Locate the directory or create it if it doesn't exist: `~/.config/pipewire/pipewire.conf.d/`.
@@ -69,7 +69,7 @@ If this happens:
    }
    ```
 
-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 that doesn't work, you can try forcing the other drivers by specifying `pulseaudio` (or `pipewire`) instead of `alsa` in the above launch argument.
 
 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.
 
-- 
2.49.1


From a0eeee1194730e446a7ea8bc57f23360acb7ed7b Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Tue, 21 Oct 2025 19:42:30 +0000
Subject: [PATCH 18/22] formatting

---
 content/docs/resonite/_index.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index 34b36b5..a75c5cb 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -41,7 +41,7 @@ The game will default to the PipeWire API if it can, falling back to the PulseAu
 
 ### Crackling microphone
 
-Unfortunately, it seems that **every WiVRn user experiences crackling mic issues by default** before manually switching to the legacy ALSA driver:
+Unfortunately, it seems that **every WiVRn user** experiences crackling mic issues by default before manually switching to the legacy ALSA driver:
 
 1. Force Resonite to use ALSA:
 
@@ -52,7 +52,7 @@ Add the following to Resonite's Launch Options:
 
 2. Configure PipeWire for legacy mode:
 
-For most if not all users, using ALSA _will_ bork your audio until you've manually configured PipeWire to support your hardware's sample rates.
+For most if not all users, **using ALSA _will_ bork your audio** until you've manually configured PipeWire to support your hardware's sample rates.
 If this happens:
 
    1. Locate the directory or create it if it doesn't exist: `~/.config/pipewire/pipewire.conf.d/`.
-- 
2.49.1


From 2f67ce7b676eee969e8c1047f3a305c299d509a7 Mon Sep 17 00:00:00 2001
From: Dandrid Dandresis <23291246-dandrid_dandresis@users.noreply.gitlab.com>
Date: Wed, 22 Oct 2025 03:08:00 -0400
Subject: [PATCH 19/22] refactor(resonite): Clarify and format issues and
 resolutions better.

---
 content/docs/resonite/_index.md | 74 +++++++++++++++++++--------------
 1 file changed, 42 insertions(+), 32 deletions(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index a75c5cb..750a41e 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -39,35 +39,40 @@ It is recommended that you use PipeWire as your system's audio service, includin
 
 The game will default to the PipeWire API if it can, falling back to the PulseAudio API.
 
-### Crackling microphone
+### Crackling Microphone Audio
 
-Unfortunately, it seems that **every WiVRn user** experiences crackling mic issues by default before manually switching to the legacy ALSA driver:
+Currently there is an issue in Resonite for WiVRn users which results in their microphone audio becoming crackly / glitchy to others. In order to solve this issue one must adjust their pipewire sample rates as well as set Resonite to use the ALSA SDL audio backend.
 
-1. Force Resonite to use ALSA:
+Steps are as follows:
 
-Add the following to Resonite's Launch Options: 
-````SDL_AUDIO_DRIVER=alsa %command%````
+**NOTE:** If you have already set launch arguments for Resonite, simply add `SDL_AUDIO_DRIVER=alsa` next to other env var in your launch arguments.
 
-**Note:** If you already have `%command%` in your launch arguments, simply add `SDL_AUDIO_DRIVER=alsa` **before** it. Continue with step 2.
+1. Force Resonite to use ALSA SDL backend for audio:
 
-2. Configure PipeWire for legacy mode:
+    Add the following to Resonite's Launch Options in Steam:
 
-For most if not all users, **using ALSA _will_ bork your audio** until you've manually configured PipeWire to support your hardware's sample rates.
-If this happens:
+    ```
+    SDL_AUDIO_DRIVER=alsa %command%
+    ```
 
-   1. Locate the directory or create it if it doesn't exist: `~/.config/pipewire/pipewire.conf.d/`.
-   
-   Remember: The `~/.config` folder is normally hidden in file browsers and could be `$XDG_CONFIG_HOME` on some systems.
-   
-   2. Create the file `01-sample-rates.conf` in that folder. The full path should be `~/.config/pipewire/pipewire.conf.d/01-sample-rates.conf`.
-   
-   3. Paste the following content into the file to define supported sample rates, and save it:
-   ```
-   context.properties = {
-   default.clock.allowed-rates = [ 44100 48000 88200 96000 ]
-   default.clock.rate  = 48000
-   }
-   ```
+**NOTE:** If you have set `$XDG_CONFIG_HOME` to something other than `~/.config` then please adjust the paths according.
+
+2. Configure PipeWire Sampling Rates:
+
+    For most if not all users, **using ALSA _WILL_ bork your audio** until you've manually configured PipeWire to use a default sample rate of 48kHz. If this happens:
+
+    2.1. Locate the directory or create it if it doesn't exist: `~/.config/pipewire/pipewire.conf.d/`.
+
+    2.2 Create a configuration file (`01-sample-rates.conf` for this example) in that folder. The full path should be `~/.config/pipewire/pipewire.conf.d/01-sample-rates.conf`.
+
+    2.3 Paste the following content into the file to define supported sample rates, and save it:
+
+    ```
+    context.properties = {
+    default.clock.allowed-rates = [ 44100 48000 88200 96000 ]
+    default.clock.rate  = 48000
+    }
+    ```
 
 If that doesn't work, you can try forcing the other drivers by specifying `pulseaudio` (or `pipewire`) instead of `alsa` in the above launch argument.
 
@@ -86,9 +91,9 @@ Do note that for the Audio Stream feature of Resonite, you'll need to select a d
 
 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.
 
-### No mic audio after a crash
+### No WiVRn Mic Audio After Resonite Crashes
 
-If you're using WiVRn, close and reopen it (this will crash Resonite).
+If you're using WiVRn, close and reopen it.
 
 ## FlipVR controller support with Monado
 
@@ -145,6 +150,18 @@ It may be enough to just verify file integrity in some cases.
 
 On GE-Proton9-10 (for example), loading into a world with e.g. a YouTube video or live stream can crash the game. Try using the latest GE-Proton-RTSP release.
 
+### Hanging on Launch
+
+Steps to Reproduce:
+
+- Attempt to Launch Resonite via Steam
+
+Symptoms:
+
+- Steam reports Resonite is running but Resonite does not launch
+
+This issue can arise due to not having a default audio device selected. Select one and see if it works. This is likely caused by an SDL / Resonite issue.
+
 ### Crash after loading
 
 Although this is rare, some proton updates can start crashing Resonite repetitively.
@@ -153,15 +170,8 @@ Symptoms:
 - Crashes approximately 1 minute after successfully loading Resonite
 - Everything freezes in both desktop mode and VR, but you can still hear sounds, including the voices of other users
 
-If this happens, just switch Proton to another version in the compatibility options.
+If this happens, just switch Proton to another version such as Proton-GE or Proton-GE-rtsp.
 
-### Crash before loading
-
-Symptoms:
-- Resonite doesn't launch
-- Steam indefinitely shows Resonite is running and lets you press STOP
-
-Choose the correct default audio devices in your volume panel. This is likely caused by SDL.
 
 ## Controls busted after switching to desktop
 
-- 
2.49.1


From 8d576a535bc39096623c6725c36cd45b1c3a51e1 Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Wed, 22 Oct 2025 09:21:23 +0000
Subject: [PATCH 20/22] Reformatted the refactor

---
 content/docs/resonite/_index.md | 44 +++++++++++++++++++--------------
 1 file changed, 25 insertions(+), 19 deletions(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index 750a41e..1ac62c1 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -29,7 +29,7 @@ As of the splittening release, Resonite only supports copy/pasting text, and doe
 
 This mod provides full clipboard functionality, but only works on Wayland: https://github.com/GrandtheUK/ResoniteLinuxClipboard
 
-## Audio Issues
+## Audio issues
 
 Resonite uses SDL for audio on Linux, but the current implementation can be a bit flaky.
 
@@ -39,13 +39,11 @@ It is recommended that you use PipeWire as your system's audio service, includin
 
 The game will default to the PipeWire API if it can, falling back to the PulseAudio API.
 
-### Crackling Microphone Audio
+### Crackling microphone audio
 
-Currently there is an issue in Resonite for WiVRn users which results in their microphone audio becoming crackly / glitchy to others. In order to solve this issue one must adjust their pipewire sample rates as well as set Resonite to use the ALSA SDL audio backend.
+There is an issue WiVRn users have in Resonite, resulting in their microphone audio becoming crackly / glitchy to others. In order to solve this issue, it's necessary to set Resonite to use the ALSA SDL audio backend, and make sure PipeWire sample rates are configured properly.
 
-Steps are as follows:
-
-**NOTE:** If you have already set launch arguments for Resonite, simply add `SDL_AUDIO_DRIVER=alsa` next to other env var in your launch arguments.
+The steps are as follows:
 
 1. Force Resonite to use ALSA SDL backend for audio:
 
@@ -55,14 +53,17 @@ Steps are as follows:
     SDL_AUDIO_DRIVER=alsa %command%
     ```
 
-**NOTE:** If you have set `$XDG_CONFIG_HOME` to something other than `~/.config` then please adjust the paths according.
+    **NOTE:** If you have already set launch arguments for Resonite, simply add `SDL_AUDIO_DRIVER=alsa` next to other env vars in your launch arguments.
 
-2. Configure PipeWire Sampling Rates:
+
+2. Configure PipeWire sampling rates:
 
     For most if not all users, **using ALSA _WILL_ bork your audio** until you've manually configured PipeWire to use a default sample rate of 48kHz. If this happens:
 
     2.1. Locate the directory or create it if it doesn't exist: `~/.config/pipewire/pipewire.conf.d/`.
 
+    **NOTE:** If you have set `$XDG_CONFIG_HOME` to something other than `~/.config` then please adjust the paths according.
+
     2.2 Create a configuration file (`01-sample-rates.conf` for this example) in that folder. The full path should be `~/.config/pipewire/pipewire.conf.d/01-sample-rates.conf`.
 
     2.3 Paste the following content into the file to define supported sample rates, and save it:
@@ -82,7 +83,7 @@ If you want to use the PulseAudio driver, you may need `SDL_AUDIO_DRIVER=pulseau
 
 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).
+1. Use `SDL_AUDIO_INCLUDE_MONITORS=1`, but this works with the PulseAudio driver *only* (add it next to your other env vars 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.
@@ -91,9 +92,11 @@ Do note that for the Audio Stream feature of Resonite, you'll need to select a d
 
 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.
 
-### No WiVRn Mic Audio After Resonite Crashes
+### No WiVRn mic audio
 
-If you're using WiVRn, close and reopen it.
+If you're using WiVRn, close and reopen it. This mostly happens after Resonite has crashed.
+
+**NOTE:** Closing WiVRn will cause xrizer to crash Resonite if it's open.
 
 ## FlipVR controller support with Monado
 
@@ -152,23 +155,26 @@ On GE-Proton9-10 (for example), loading into a world with e.g. a YouTube video o
 
 ### Hanging on Launch
 
-Steps to Reproduce:
-
-- Attempt to Launch Resonite via Steam
-
 Symptoms:
 
-- Steam reports Resonite is running but Resonite does not launch
+- Steam reports Resonite is running but Resonite does not launch.
 
-This issue can arise due to not having a default audio device selected. Select one and see if it works. This is likely caused by an SDL / Resonite issue.
+Possible causes:
+- Not having a default audio device selected. 
+
+   **Solution:** Select an/another audio device in your volume panel and see if it works. This is likely an SDL issue.
+
+- Improperly configured mod loaders and plugins.
+
+   **Solution:** Try starting without Steam launch options and then re-add the env vars one by one. This is commonly caused by misconfigured MonkeyLoader.
 
 ### Crash after loading
 
 Although this is rare, some proton updates can start crashing Resonite repetitively.
 
 Symptoms:
-- Crashes approximately 1 minute after successfully loading Resonite
-- Everything freezes in both desktop mode and VR, but you can still hear sounds, including the voices of other users
+- Crashes approximately 1 minute after successfully loading Resonite.
+- Everything freezes in both desktop mode and VR, but you can still hear sounds, including the voices of other users.
 
 If this happens, just switch Proton to another version such as Proton-GE or Proton-GE-rtsp.
 
-- 
2.49.1


From 19af4937aa59a83b6916c6a7a247d21255a9c194 Mon Sep 17 00:00:00 2001
From: Krzeszny <krzeszny@gmail.com>
Date: Wed, 22 Oct 2025 13:48:49 +0000
Subject: [PATCH 21/22] Added another suggestion

---
 content/docs/resonite/_index.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index 1ac62c1..ba8e9b1 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -149,6 +149,8 @@ Navigate to compatdata in the folder above Resonite's folder (by default `.local
 
 It may be enough to just verify file integrity in some cases.
 
+This can also happen because of **incorrect Steam launch options**.
+
 ### Crash on loading into a world with video players
 
 On GE-Proton9-10 (for example), loading into a world with e.g. a YouTube video or live stream can crash the game. Try using the latest GE-Proton-RTSP release.
-- 
2.49.1


From ec229c88e22f0228297a6b70a1003b7f5c3e7bfe Mon Sep 17 00:00:00 2001
From: hypevhs <4498312-hypevhs@users.noreply.gitlab.com>
Date: Thu, 23 Oct 2025 18:24:41 -0500
Subject: [PATCH 22/22] Apply 1 suggestion(s) to 1 file(s)

---
 content/docs/resonite/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md
index ba8e9b1..8e95642 100644
--- a/content/docs/resonite/_index.md
+++ b/content/docs/resonite/_index.md
@@ -162,7 +162,7 @@ Symptoms:
 - Steam reports Resonite is running but Resonite does not launch.
 
 Possible causes:
-- Not having a default audio device selected. 
+- Not having a default audio device selected.
 
    **Solution:** Select an/another audio device in your volume panel and see if it works. This is likely an SDL issue.
 
-- 
2.49.1