From 7cb8e4a9d2588e9784ae49cb6349d8eef04a3b47 Mon Sep 17 00:00:00 2001
From: galister <22305755+galister@users.noreply.github.com>
Date: Fri, 25 Oct 2024 08:39:25 +0000
Subject: [PATCH] docs: troubleshooting details

---
 README.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/README.md b/README.md
index 9c36e3d..45c5679 100644
--- a/README.md
+++ b/README.md
@@ -115,6 +115,10 @@ We would like to work with you and include additional bindings.
 
 ## Troubleshooting
 
+When an error is detected, we often print tips for fixing into the log file.
+
+Logs will be at `/tmp/wlx.log` for most distros.
+
 Check [here](https://github.com/galister/wlx-overlay-s/wiki/Troubleshooting) for tips.
 
 ## Known Issues
@@ -125,8 +129,22 @@ Hyprland users: Hyprland v0.41.0 changed their absolute input implementation to
 
 Niri users: use on Niri 0.1.7 or later.
 
+X11 users might be dealing with a [Phantom Monitor](https://wiki.archlinux.org/title/Xrandr#Disabling_phantom_monitor).
+
 Other desktops: The screens may have been selected in the wrong order, see [First Start](#first-start).
 
+### Crashes, blank screens
+
+There are some driver-desktop combinations that don't play nice with DMA-buf capture. 
+
+Disabling DMA-buf capture is a good first step to try when encountering an app crash or gpu driver reset.
+
+```bash
+echo 'capture_method: pw_fallback' > ~/.config/wlxoverlay/conf.d/pw_fallback.yaml
+```
+
+Without DMA-buf capture, capturing screens takes CPU power, so let's try and not show too many screens at the same time.
+
 ### Space-drag crashes SteamVR
 
 This has been idenfitied as an issue with SteamVR versions 2.5.5 and above (latest tested 2.7.2). One way to avoid the crash is by switching to the `temp-v1.27.5` branch of SteamVR (via beta selection) and selecting [Steam-Play-None](https://github.com/Scrumplex/Steam-Play-None) under the compatibility tab.