From 9da2158e15bbe4d237790db3f6e08adff4926157 Mon Sep 17 00:00:00 2001
From: primalmotion <208711+primalmotion@users.noreply.github.com>
Date: Fri, 31 May 2024 03:39:48 -0700
Subject: [PATCH] faq: added an entry about phantom monitor (#667)

---
 pages/FAQ/_index.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/pages/FAQ/_index.md b/pages/FAQ/_index.md
index 134e2da..3eb8d3b 100644
--- a/pages/FAQ/_index.md
+++ b/pages/FAQ/_index.md
@@ -383,3 +383,23 @@ from Steam.
 
 Steam has its own file picker, however, it's not functional. Install
 `xdg-desktop-portal-gtk` to show the desktop's file picker.
+
+# Workspaces or clients are disappearing or monitor related dispatchers cause crashes
+
+It seems there is a Kernel bug making the system think there is an extra
+phantom monitor, that causes all sorts of issues, crashes and weird behaviors
+like disapearing workspaces or clients when adding or removing an external
+monitor.
+
+First check the list of monitors detected by Hyprland by running:
+
+```ini
+hyprctl monitors
+```
+
+If you see a monitor that should not be there (usually named `Unknown-1`), you
+can work around the issue by adding in your `hyprland.conf`:
+
+```ini
+monitor=Unknown-1,disabled
+```