From f729cc2b815446f7720a94047b7dcc4d6641445b Mon Sep 17 00:00:00 2001 From: LGUG2Z Date: Fri, 10 Oct 2025 14:25:14 -0700 Subject: [PATCH] docs(mkdocs): add notes about system configuration suggestions --- docs/installation.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/installation.md b/docs/installation.md index 5e296b6a..9788e221 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -18,6 +18,20 @@ using keyboard shortcuts. At this time users must compile `komorebi` from source. +## System settings suggestions + +Go to `System Settings -> Desktop & Dock -> Mission Control -> Displays have +separate Spaces` and disable this option if you are using more than one monitor. + +`komorebi` is scoped to a single macOS space (the one that is active when the +process is started), which means that you can still use other Spaces as if +`komorebi` were not running at all. If you are using monitors with the above +option enabled, komorebi will only be listening to events from the Space on the +monitor which it was launched on. + +Go to `System Settings -> Desktop & Dock -> Mission Control -> Group windows +by application` and disable this option if you like to use mission control. + ## Building from source Make sure you have installed [`rustup`](https://rustup.rs), and a stable `rust`