diff --git a/404.html b/404.html
index c0b8c610..ff7c7ae2 100644
--- a/404.html
+++ b/404.html
@@ -913,7 +913,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/adjust-container-padding.html b/cli/adjust-container-padding.html
index 12355447..8c5a6b2f 100644
--- a/cli/adjust-container-padding.html
+++ b/cli/adjust-container-padding.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/adjust-workspace-padding.html b/cli/adjust-workspace-padding.html
index f5366234..33f8a84a 100644
--- a/cli/adjust-workspace-padding.html
+++ b/cli/adjust-workspace-padding.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/ahk-app-specific-configuration.html b/cli/ahk-app-specific-configuration.html
index 435b62d1..b1aa7ed6 100644
--- a/cli/ahk-app-specific-configuration.html
+++ b/cli/ahk-app-specific-configuration.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/ahk-library.html b/cli/ahk-library.html
index 9c213f38..4ac58cbe 100644
--- a/cli/ahk-library.html
+++ b/cli/ahk-library.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/application-specific-configuration-schema.html b/cli/application-specific-configuration-schema.html
index b1691562..5779d55a 100644
--- a/cli/application-specific-configuration-schema.html
+++ b/cli/application-specific-configuration-schema.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/border-colour.html b/cli/border-colour.html
index ac968261..a7fbc8aa 100644
--- a/cli/border-colour.html
+++ b/cli/border-colour.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/border-offset.html b/cli/border-offset.html
index f377a174..ab9083ac 100644
--- a/cli/border-offset.html
+++ b/cli/border-offset.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/border-width.html b/cli/border-width.html
index 600a9950..58e34fd7 100644
--- a/cli/border-width.html
+++ b/cli/border-width.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/border.html b/cli/border.html
index f534fc75..d20f36de 100644
--- a/cli/border.html
+++ b/cli/border.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/change-layout.html b/cli/change-layout.html
index 243b2b28..be3a928b 100644
--- a/cli/change-layout.html
+++ b/cli/change-layout.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/check.html b/cli/check.html
index ff72eae1..a87e3293 100644
--- a/cli/check.html
+++ b/cli/check.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/clear-named-workspace-layout-rules.html b/cli/clear-named-workspace-layout-rules.html
index 05161842..5e320e91 100644
--- a/cli/clear-named-workspace-layout-rules.html
+++ b/cli/clear-named-workspace-layout-rules.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/clear-workspace-layout-rules.html b/cli/clear-workspace-layout-rules.html
index c2c2ace1..2569b7b4 100644
--- a/cli/clear-workspace-layout-rules.html
+++ b/cli/clear-workspace-layout-rules.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/close.html b/cli/close.html
index 248ca608..d07ad3e9 100644
--- a/cli/close.html
+++ b/cli/close.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/complete-configuration.html b/cli/complete-configuration.html
index 6ae5ace8..49b2b3ce 100644
--- a/cli/complete-configuration.html
+++ b/cli/complete-configuration.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/configuration.html b/cli/configuration.html
index 5f0ff255..9f239d9f 100644
--- a/cli/configuration.html
+++ b/cli/configuration.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/container-padding.html b/cli/container-padding.html
index 152dfde4..a162807b 100644
--- a/cli/container-padding.html
+++ b/cli/container-padding.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/cross-monitor-move-behaviour.html b/cli/cross-monitor-move-behaviour.html
index 3fa63b4e..60a8394d 100644
--- a/cli/cross-monitor-move-behaviour.html
+++ b/cli/cross-monitor-move-behaviour.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/cycle-focus.html b/cli/cycle-focus.html
index d7dda29f..14467f52 100644
--- a/cli/cycle-focus.html
+++ b/cli/cycle-focus.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/cycle-layout.html b/cli/cycle-layout.html
index 9dbf7fbc..cfa95ada 100644
--- a/cli/cycle-layout.html
+++ b/cli/cycle-layout.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/cycle-monitor.html b/cli/cycle-monitor.html
index 8c63a49c..0589377f 100644
--- a/cli/cycle-monitor.html
+++ b/cli/cycle-monitor.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/cycle-move-to-monitor.html b/cli/cycle-move-to-monitor.html
index 48d260d2..b0db0281 100644
--- a/cli/cycle-move-to-monitor.html
+++ b/cli/cycle-move-to-monitor.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/cycle-move-to-workspace.html b/cli/cycle-move-to-workspace.html
index 704dc387..48fae0d0 100644
--- a/cli/cycle-move-to-workspace.html
+++ b/cli/cycle-move-to-workspace.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/cycle-move-workspace-to-monitor.html b/cli/cycle-move-workspace-to-monitor.html
index 083e4f79..1dad5a10 100644
--- a/cli/cycle-move-workspace-to-monitor.html
+++ b/cli/cycle-move-workspace-to-monitor.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/cycle-move.html b/cli/cycle-move.html
index 22f9ea2a..05a993d2 100644
--- a/cli/cycle-move.html
+++ b/cli/cycle-move.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/cycle-send-to-monitor.html b/cli/cycle-send-to-monitor.html
index a1215edc..19824e01 100644
--- a/cli/cycle-send-to-monitor.html
+++ b/cli/cycle-send-to-monitor.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/cycle-send-to-workspace.html b/cli/cycle-send-to-workspace.html
index d6357373..4c1dbb5f 100644
--- a/cli/cycle-send-to-workspace.html
+++ b/cli/cycle-send-to-workspace.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/cycle-stack.html b/cli/cycle-stack.html
index 919eed5c..7e29c459 100644
--- a/cli/cycle-stack.html
+++ b/cli/cycle-stack.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/cycle-workspace.html b/cli/cycle-workspace.html
index 1c63e3db..41cbabf4 100644
--- a/cli/cycle-workspace.html
+++ b/cli/cycle-workspace.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/disable-autostart.html b/cli/disable-autostart.html
index 0b5ac181..bbc957f4 100644
--- a/cli/disable-autostart.html
+++ b/cli/disable-autostart.html
@@ -922,7 +922,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/display-index-preference.html b/cli/display-index-preference.html
index 7dc5c008..bff661b0 100644
--- a/cli/display-index-preference.html
+++ b/cli/display-index-preference.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/enable-autostart.html b/cli/enable-autostart.html
index 7f895829..66b39170 100644
--- a/cli/enable-autostart.html
+++ b/cli/enable-autostart.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/ensure-named-workspaces.html b/cli/ensure-named-workspaces.html
index 4596720c..3af2779e 100644
--- a/cli/ensure-named-workspaces.html
+++ b/cli/ensure-named-workspaces.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/ensure-workspaces.html b/cli/ensure-workspaces.html
index 13b9f0e7..8828e066 100644
--- a/cli/ensure-workspaces.html
+++ b/cli/ensure-workspaces.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/fetch-app-specific-configuration.html b/cli/fetch-app-specific-configuration.html
index a9388412..1661bf12 100644
--- a/cli/fetch-app-specific-configuration.html
+++ b/cli/fetch-app-specific-configuration.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/flip-layout.html b/cli/flip-layout.html
index d2d2027b..6f53c134 100644
--- a/cli/flip-layout.html
+++ b/cli/flip-layout.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/float-rule.html b/cli/float-rule.html
index 6ee7cb5c..c8e50503 100644
--- a/cli/float-rule.html
+++ b/cli/float-rule.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/focus-follows-mouse.html b/cli/focus-follows-mouse.html
index 4f32196c..17769f55 100644
--- a/cli/focus-follows-mouse.html
+++ b/cli/focus-follows-mouse.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/focus-last-workspace.html b/cli/focus-last-workspace.html
index 194a35fe..ad393644 100644
--- a/cli/focus-last-workspace.html
+++ b/cli/focus-last-workspace.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/focus-monitor-workspace.html b/cli/focus-monitor-workspace.html
index 614a8a79..438cb6f2 100644
--- a/cli/focus-monitor-workspace.html
+++ b/cli/focus-monitor-workspace.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/focus-monitor.html b/cli/focus-monitor.html
index 0b9b3214..207caf00 100644
--- a/cli/focus-monitor.html
+++ b/cli/focus-monitor.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/focus-named-workspace.html b/cli/focus-named-workspace.html
index 82b9585c..382a86a7 100644
--- a/cli/focus-named-workspace.html
+++ b/cli/focus-named-workspace.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/focus-workspace.html b/cli/focus-workspace.html
index b5cf3dd0..9cdbc8b2 100644
--- a/cli/focus-workspace.html
+++ b/cli/focus-workspace.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/focus-workspaces.html b/cli/focus-workspaces.html
index 30339d00..af776b5f 100644
--- a/cli/focus-workspaces.html
+++ b/cli/focus-workspaces.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/focus.html b/cli/focus.html
index 5b1d5c62..ffa1b357 100644
--- a/cli/focus.html
+++ b/cli/focus.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/focused-workspace-container-padding.html b/cli/focused-workspace-container-padding.html
index 40ef786c..8bbd9175 100644
--- a/cli/focused-workspace-container-padding.html
+++ b/cli/focused-workspace-container-padding.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/focused-workspace-padding.html b/cli/focused-workspace-padding.html
index 49a0eb2d..48329453 100644
--- a/cli/focused-workspace-padding.html
+++ b/cli/focused-workspace-padding.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/force-focus.html b/cli/force-focus.html
index 8ec58d40..1a636626 100644
--- a/cli/force-focus.html
+++ b/cli/force-focus.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/format-app-specific-configuration.html b/cli/format-app-specific-configuration.html
index ee9938f9..44fa3913 100644
--- a/cli/format-app-specific-configuration.html
+++ b/cli/format-app-specific-configuration.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/generate-static-config.html b/cli/generate-static-config.html
index 79af282c..62854498 100644
--- a/cli/generate-static-config.html
+++ b/cli/generate-static-config.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/global-state.html b/cli/global-state.html
index 11399a17..84fb0adc 100644
--- a/cli/global-state.html
+++ b/cli/global-state.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/global-work-area-offset.html b/cli/global-work-area-offset.html
index 02a89321..c3d45e4a 100644
--- a/cli/global-work-area-offset.html
+++ b/cli/global-work-area-offset.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/gui.html b/cli/gui.html
index 97ebf49b..793fec9b 100644
--- a/cli/gui.html
+++ b/cli/gui.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/identify-layered-application.html b/cli/identify-layered-application.html
index 37b381ea..15703b3a 100644
--- a/cli/identify-layered-application.html
+++ b/cli/identify-layered-application.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/identify-object-name-change-application.html b/cli/identify-object-name-change-application.html
index 4191feb0..3f865958 100644
--- a/cli/identify-object-name-change-application.html
+++ b/cli/identify-object-name-change-application.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/identify-tray-application.html b/cli/identify-tray-application.html
index 19c787d2..df294335 100644
--- a/cli/identify-tray-application.html
+++ b/cli/identify-tray-application.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/initial-named-workspace-rule.html b/cli/initial-named-workspace-rule.html
index 3a7bcfb8..645bfb98 100644
--- a/cli/initial-named-workspace-rule.html
+++ b/cli/initial-named-workspace-rule.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/initial-workspace-rule.html b/cli/initial-workspace-rule.html
index fed7c600..71973d08 100644
--- a/cli/initial-workspace-rule.html
+++ b/cli/initial-workspace-rule.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/invisible-borders.html b/cli/invisible-borders.html
index ae6289fe..6df9e606 100644
--- a/cli/invisible-borders.html
+++ b/cli/invisible-borders.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/load-custom-layout.html b/cli/load-custom-layout.html
index 33b356ff..5a98ab0a 100644
--- a/cli/load-custom-layout.html
+++ b/cli/load-custom-layout.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/load-resize.html b/cli/load-resize.html
index fbf9523e..02cc6551 100644
--- a/cli/load-resize.html
+++ b/cli/load-resize.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/log.html b/cli/log.html
index 5c214f87..de054644 100644
--- a/cli/log.html
+++ b/cli/log.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/manage-rule.html b/cli/manage-rule.html
index 861e2c8d..814cc1e6 100644
--- a/cli/manage-rule.html
+++ b/cli/manage-rule.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/manage.html b/cli/manage.html
index 595f13bd..acde2d54 100644
--- a/cli/manage.html
+++ b/cli/manage.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/minimize.html b/cli/minimize.html
index 3d38cb89..0ae03c62 100644
--- a/cli/minimize.html
+++ b/cli/minimize.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/monitor-index-preference.html b/cli/monitor-index-preference.html
index 0d11f8d1..ccbe625a 100644
--- a/cli/monitor-index-preference.html
+++ b/cli/monitor-index-preference.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/monitor-work-area-offset.html b/cli/monitor-work-area-offset.html
index e765c0e4..1969e7cb 100644
--- a/cli/monitor-work-area-offset.html
+++ b/cli/monitor-work-area-offset.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/mouse-follows-focus.html b/cli/mouse-follows-focus.html
index 6d36613f..ba83dd14 100644
--- a/cli/mouse-follows-focus.html
+++ b/cli/mouse-follows-focus.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/move-to-monitor-workspace.html b/cli/move-to-monitor-workspace.html
index 5f618144..9e96378d 100644
--- a/cli/move-to-monitor-workspace.html
+++ b/cli/move-to-monitor-workspace.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/move-to-monitor.html b/cli/move-to-monitor.html
index c4ed6e28..32828189 100644
--- a/cli/move-to-monitor.html
+++ b/cli/move-to-monitor.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/move-to-named-workspace.html b/cli/move-to-named-workspace.html
index 6e01ec7b..ce42b436 100644
--- a/cli/move-to-named-workspace.html
+++ b/cli/move-to-named-workspace.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/move-to-workspace.html b/cli/move-to-workspace.html
index 511488c7..dcbda961 100644
--- a/cli/move-to-workspace.html
+++ b/cli/move-to-workspace.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/move-workspace-to-monitor.html b/cli/move-workspace-to-monitor.html
index da5e1064..cfa9d530 100644
--- a/cli/move-workspace-to-monitor.html
+++ b/cli/move-workspace-to-monitor.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/move.html b/cli/move.html
index 4cd927c4..5a8b6d11 100644
--- a/cli/move.html
+++ b/cli/move.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/named-workspace-container-padding.html b/cli/named-workspace-container-padding.html
index 0a603b83..ed30e45b 100644
--- a/cli/named-workspace-container-padding.html
+++ b/cli/named-workspace-container-padding.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/named-workspace-custom-layout-rule.html b/cli/named-workspace-custom-layout-rule.html
index fcd55cf0..82f7c847 100644
--- a/cli/named-workspace-custom-layout-rule.html
+++ b/cli/named-workspace-custom-layout-rule.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/named-workspace-custom-layout.html b/cli/named-workspace-custom-layout.html
index 6e6bd9c6..962f022d 100644
--- a/cli/named-workspace-custom-layout.html
+++ b/cli/named-workspace-custom-layout.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/named-workspace-layout-rule.html b/cli/named-workspace-layout-rule.html
index b75187d4..96afec00 100644
--- a/cli/named-workspace-layout-rule.html
+++ b/cli/named-workspace-layout-rule.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/named-workspace-layout.html b/cli/named-workspace-layout.html
index 4338ccee..40409994 100644
--- a/cli/named-workspace-layout.html
+++ b/cli/named-workspace-layout.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/named-workspace-padding.html b/cli/named-workspace-padding.html
index 67b1801b..7f5616d0 100644
--- a/cli/named-workspace-padding.html
+++ b/cli/named-workspace-padding.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/named-workspace-rule.html b/cli/named-workspace-rule.html
index 1bc3b0bd..ef9924bc 100644
--- a/cli/named-workspace-rule.html
+++ b/cli/named-workspace-rule.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/named-workspace-tiling.html b/cli/named-workspace-tiling.html
index fd16ecb4..28dd3119 100644
--- a/cli/named-workspace-tiling.html
+++ b/cli/named-workspace-tiling.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/new-workspace.html b/cli/new-workspace.html
index b1ee5e39..c5414d38 100644
--- a/cli/new-workspace.html
+++ b/cli/new-workspace.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/notification-schema.html b/cli/notification-schema.html
index 22160c82..a4dddfa3 100644
--- a/cli/notification-schema.html
+++ b/cli/notification-schema.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/promote-focus.html b/cli/promote-focus.html
index 97ecdc90..e3e81c77 100644
--- a/cli/promote-focus.html
+++ b/cli/promote-focus.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/promote-window.html b/cli/promote-window.html
index 5cf2909b..4d7a0593 100644
--- a/cli/promote-window.html
+++ b/cli/promote-window.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/promote.html b/cli/promote.html
index 50db52d8..6afa3224 100644
--- a/cli/promote.html
+++ b/cli/promote.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/pwsh-app-specific-configuration.html b/cli/pwsh-app-specific-configuration.html
index 1ad4cd23..1331bba3 100644
--- a/cli/pwsh-app-specific-configuration.html
+++ b/cli/pwsh-app-specific-configuration.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/query.html b/cli/query.html
index 64897d15..bd8cc295 100644
--- a/cli/query.html
+++ b/cli/query.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/quick-load-resize.html b/cli/quick-load-resize.html
index 571bc853..0e6af4c5 100644
--- a/cli/quick-load-resize.html
+++ b/cli/quick-load-resize.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/quick-save-resize.html b/cli/quick-save-resize.html
index a60d6541..ee6f79b7 100644
--- a/cli/quick-save-resize.html
+++ b/cli/quick-save-resize.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/quickstart.html b/cli/quickstart.html
index 4d852d5e..e824b3d4 100644
--- a/cli/quickstart.html
+++ b/cli/quickstart.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
@@ -4182,7 +4182,7 @@ Options:
       <nav class="md-footer__inner md-grid" aria-label="Footer" >
         
           
-          <a href="../release/v0-1-22.html" class="md-footer__link md-footer__link--prev" aria-label="Previous: V0 1 22" rel="prev">
+          <a href="../release/v0-1-22.html" class="md-footer__link md-footer__link--prev" aria-label="Previous: v0.1.22" rel="prev">
             <div class="md-footer__button md-icon">
               
               <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
@@ -4192,7 +4192,7 @@ Options:
                 Previous
               </span>
               <div class="md-ellipsis">
-                V0 1 22
+                v0.1.22
               </div>
             </div>
           </a>
diff --git a/cli/reload-configuration.html b/cli/reload-configuration.html
index 1f69ee50..9e89a84f 100644
--- a/cli/reload-configuration.html
+++ b/cli/reload-configuration.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/remove-title-bar.html b/cli/remove-title-bar.html
index 871b4a64..c0d120bd 100644
--- a/cli/remove-title-bar.html
+++ b/cli/remove-title-bar.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/resize-axis.html b/cli/resize-axis.html
index 9620a9ae..c8eb4a75 100644
--- a/cli/resize-axis.html
+++ b/cli/resize-axis.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/resize-delta.html b/cli/resize-delta.html
index b390302f..08e785e1 100644
--- a/cli/resize-delta.html
+++ b/cli/resize-delta.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/resize-edge.html b/cli/resize-edge.html
index 9390b8ff..ce540126 100644
--- a/cli/resize-edge.html
+++ b/cli/resize-edge.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/restore-windows.html b/cli/restore-windows.html
index 7664751d..2e05d7f8 100644
--- a/cli/restore-windows.html
+++ b/cli/restore-windows.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/retile.html b/cli/retile.html
index 13c51861..675c8319 100644
--- a/cli/retile.html
+++ b/cli/retile.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/save-resize.html b/cli/save-resize.html
index 332b8a04..f62c8aa3 100644
--- a/cli/save-resize.html
+++ b/cli/save-resize.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/send-to-monitor-workspace.html b/cli/send-to-monitor-workspace.html
index 18bec725..44dfb81e 100644
--- a/cli/send-to-monitor-workspace.html
+++ b/cli/send-to-monitor-workspace.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/send-to-monitor.html b/cli/send-to-monitor.html
index 58e3fdfd..bc56ddb6 100644
--- a/cli/send-to-monitor.html
+++ b/cli/send-to-monitor.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/send-to-named-workspace.html b/cli/send-to-named-workspace.html
index 0acec16a..3f47a3eb 100644
--- a/cli/send-to-named-workspace.html
+++ b/cli/send-to-named-workspace.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/send-to-workspace.html b/cli/send-to-workspace.html
index 7b9d9368..c9960de1 100644
--- a/cli/send-to-workspace.html
+++ b/cli/send-to-workspace.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/socket-schema.html b/cli/socket-schema.html
index cb3c8495..af451419 100644
--- a/cli/socket-schema.html
+++ b/cli/socket-schema.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/stack.html b/cli/stack.html
index 300c5446..2b9a39f0 100644
--- a/cli/stack.html
+++ b/cli/stack.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/start.html b/cli/start.html
index 4d87b762..6338983a 100644
--- a/cli/start.html
+++ b/cli/start.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/state.html b/cli/state.html
index dbf01113..dc9c7ca3 100644
--- a/cli/state.html
+++ b/cli/state.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/static-config-schema.html b/cli/static-config-schema.html
index b6e2afab..72430ba6 100644
--- a/cli/static-config-schema.html
+++ b/cli/static-config-schema.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/stop.html b/cli/stop.html
index ce9eaaab..bb75794b 100644
--- a/cli/stop.html
+++ b/cli/stop.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/subscribe-pipe.html b/cli/subscribe-pipe.html
index 7bb99bd8..c854ea6c 100644
--- a/cli/subscribe-pipe.html
+++ b/cli/subscribe-pipe.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/subscribe-socket.html b/cli/subscribe-socket.html
index 236e0979..f90b8478 100644
--- a/cli/subscribe-socket.html
+++ b/cli/subscribe-socket.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/swap-workspaces-with-monitor.html b/cli/swap-workspaces-with-monitor.html
index 257b6232..f42d951a 100644
--- a/cli/swap-workspaces-with-monitor.html
+++ b/cli/swap-workspaces-with-monitor.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/toggle-cross-monitor-move-behaviour.html b/cli/toggle-cross-monitor-move-behaviour.html
index ac6ab081..5cf3b86d 100644
--- a/cli/toggle-cross-monitor-move-behaviour.html
+++ b/cli/toggle-cross-monitor-move-behaviour.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/toggle-float.html b/cli/toggle-float.html
index a5fad573..9193cf2d 100644
--- a/cli/toggle-float.html
+++ b/cli/toggle-float.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/toggle-focus-follows-mouse.html b/cli/toggle-focus-follows-mouse.html
index 7d48b0ba..6e60a860 100644
--- a/cli/toggle-focus-follows-mouse.html
+++ b/cli/toggle-focus-follows-mouse.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/toggle-maximize.html b/cli/toggle-maximize.html
index 359988b2..caa92f01 100644
--- a/cli/toggle-maximize.html
+++ b/cli/toggle-maximize.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/toggle-monocle.html b/cli/toggle-monocle.html
index 43c9e038..2f5770ca 100644
--- a/cli/toggle-monocle.html
+++ b/cli/toggle-monocle.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/toggle-mouse-follows-focus.html b/cli/toggle-mouse-follows-focus.html
index 5fde42d9..0fe18669 100644
--- a/cli/toggle-mouse-follows-focus.html
+++ b/cli/toggle-mouse-follows-focus.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/toggle-pause.html b/cli/toggle-pause.html
index 36ce917e..8176a912 100644
--- a/cli/toggle-pause.html
+++ b/cli/toggle-pause.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/toggle-tiling.html b/cli/toggle-tiling.html
index 8769a7d1..b82fee5a 100644
--- a/cli/toggle-tiling.html
+++ b/cli/toggle-tiling.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/toggle-title-bars.html b/cli/toggle-title-bars.html
index dac49a15..72deb895 100644
--- a/cli/toggle-title-bars.html
+++ b/cli/toggle-title-bars.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/toggle-window-container-behaviour.html b/cli/toggle-window-container-behaviour.html
index 1229b65f..489f2772 100644
--- a/cli/toggle-window-container-behaviour.html
+++ b/cli/toggle-window-container-behaviour.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/unmanage.html b/cli/unmanage.html
index 91501e48..2e74b505 100644
--- a/cli/unmanage.html
+++ b/cli/unmanage.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/unmanaged-window-operation-behaviour.html b/cli/unmanaged-window-operation-behaviour.html
index 57a92c31..dc6a5898 100644
--- a/cli/unmanaged-window-operation-behaviour.html
+++ b/cli/unmanaged-window-operation-behaviour.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/unstack.html b/cli/unstack.html
index db2d3ae7..44c684f6 100644
--- a/cli/unstack.html
+++ b/cli/unstack.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/unsubscribe-pipe.html b/cli/unsubscribe-pipe.html
index 65dee75c..9aed9fdd 100644
--- a/cli/unsubscribe-pipe.html
+++ b/cli/unsubscribe-pipe.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/unsubscribe-socket.html b/cli/unsubscribe-socket.html
index 99cb7561..881a9788 100644
--- a/cli/unsubscribe-socket.html
+++ b/cli/unsubscribe-socket.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/visible-windows.html b/cli/visible-windows.html
index 05a21382..7a7aee50 100644
--- a/cli/visible-windows.html
+++ b/cli/visible-windows.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/watch-configuration.html b/cli/watch-configuration.html
index 8fe3c9c5..3d683153 100644
--- a/cli/watch-configuration.html
+++ b/cli/watch-configuration.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/whkdrc.html b/cli/whkdrc.html
index a615636e..d465eda5 100644
--- a/cli/whkdrc.html
+++ b/cli/whkdrc.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/window-hiding-behaviour.html b/cli/window-hiding-behaviour.html
index fb8da0a5..496a5323 100644
--- a/cli/window-hiding-behaviour.html
+++ b/cli/window-hiding-behaviour.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/workspace-custom-layout-rule.html b/cli/workspace-custom-layout-rule.html
index a62d27db..f139a21e 100644
--- a/cli/workspace-custom-layout-rule.html
+++ b/cli/workspace-custom-layout-rule.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/workspace-custom-layout.html b/cli/workspace-custom-layout.html
index d9173056..52cc5cbf 100644
--- a/cli/workspace-custom-layout.html
+++ b/cli/workspace-custom-layout.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/workspace-layout-rule.html b/cli/workspace-layout-rule.html
index f4fccf1c..5bab5799 100644
--- a/cli/workspace-layout-rule.html
+++ b/cli/workspace-layout-rule.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/workspace-layout.html b/cli/workspace-layout.html
index 81ec61ee..baa79191 100644
--- a/cli/workspace-layout.html
+++ b/cli/workspace-layout.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/workspace-name.html b/cli/workspace-name.html
index 2ebd6ce5..997387fa 100644
--- a/cli/workspace-name.html
+++ b/cli/workspace-name.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/workspace-padding.html b/cli/workspace-padding.html
index 649a9199..f8d11e01 100644
--- a/cli/workspace-padding.html
+++ b/cli/workspace-padding.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/workspace-rule.html b/cli/workspace-rule.html
index 47308b11..3118fe3b 100644
--- a/cli/workspace-rule.html
+++ b/cli/workspace-rule.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/cli/workspace-tiling.html b/cli/workspace-tiling.html
index f488c8c3..41e3d29f 100644
--- a/cli/workspace-tiling.html
+++ b/cli/workspace-tiling.html
@@ -924,7 +924,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/common-workflows/autohotkey.html b/common-workflows/autohotkey.html
index ae523a9f..a79a4236 100644
--- a/common-workflows/autohotkey.html
+++ b/common-workflows/autohotkey.html
@@ -936,7 +936,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/common-workflows/borders.html b/common-workflows/borders.html
index ed2b0eeb..0ab557c5 100644
--- a/common-workflows/borders.html
+++ b/common-workflows/borders.html
@@ -936,7 +936,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/common-workflows/custom-layouts.html b/common-workflows/custom-layouts.html
index 2834c3c9..1db6d8c2 100644
--- a/common-workflows/custom-layouts.html
+++ b/common-workflows/custom-layouts.html
@@ -936,7 +936,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/common-workflows/dynamic-layout-switching.html b/common-workflows/dynamic-layout-switching.html
index 707199f9..0e15f121 100644
--- a/common-workflows/dynamic-layout-switching.html
+++ b/common-workflows/dynamic-layout-switching.html
@@ -936,7 +936,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
@@ -4220,13 +4220,13 @@ been cleared.</p>
         
         
           
-          <a href="../release/v0-1-22.html" class="md-footer__link md-footer__link--next" aria-label="Next: V0 1 22" rel="next">
+          <a href="../release/v0-1-22.html" class="md-footer__link md-footer__link--next" aria-label="Next: v0.1.22" rel="next">
             <div class="md-footer__title">
               <span class="md-footer__direction">
                 Next
               </span>
               <div class="md-ellipsis">
-                V0 1 22
+                v0.1.22
               </div>
             </div>
             <div class="md-footer__button md-icon">
diff --git a/common-workflows/focus-follows-mouse.html b/common-workflows/focus-follows-mouse.html
index 41742e81..52a2f906 100644
--- a/common-workflows/focus-follows-mouse.html
+++ b/common-workflows/focus-follows-mouse.html
@@ -936,7 +936,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/common-workflows/force-manage-windows.html b/common-workflows/force-manage-windows.html
index 36698c4a..d2f841d2 100644
--- a/common-workflows/force-manage-windows.html
+++ b/common-workflows/force-manage-windows.html
@@ -936,7 +936,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/common-workflows/ignore-windows.html b/common-workflows/ignore-windows.html
index 2a12692d..b1b5d9af 100644
--- a/common-workflows/ignore-windows.html
+++ b/common-workflows/ignore-windows.html
@@ -936,7 +936,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/common-workflows/komorebi-config-home.html b/common-workflows/komorebi-config-home.html
index 101a8c83..1b1be58d 100644
--- a/common-workflows/komorebi-config-home.html
+++ b/common-workflows/komorebi-config-home.html
@@ -936,7 +936,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/common-workflows/mouse-follows-focus.html b/common-workflows/mouse-follows-focus.html
index b18a31ce..538c6a9a 100644
--- a/common-workflows/mouse-follows-focus.html
+++ b/common-workflows/mouse-follows-focus.html
@@ -936,7 +936,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/common-workflows/remove-gaps.html b/common-workflows/remove-gaps.html
index fb05c14d..78a3f4c8 100644
--- a/common-workflows/remove-gaps.html
+++ b/common-workflows/remove-gaps.html
@@ -936,7 +936,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/common-workflows/stackbar.html b/common-workflows/stackbar.html
index d260db9b..1c642d66 100644
--- a/common-workflows/stackbar.html
+++ b/common-workflows/stackbar.html
@@ -936,7 +936,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/common-workflows/tray-and-multi-window-applications.html b/common-workflows/tray-and-multi-window-applications.html
index f89bacf5..1260f23c 100644
--- a/common-workflows/tray-and-multi-window-applications.html
+++ b/common-workflows/tray-and-multi-window-applications.html
@@ -936,7 +936,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/design.html b/design.html
index d8df24e3..cc2b9d75 100644
--- a/design.html
+++ b/design.html
@@ -978,7 +978,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/example-configurations.html b/example-configurations.html
index d42cef33..7b77db5c 100644
--- a/example-configurations.html
+++ b/example-configurations.html
@@ -1106,7 +1106,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/index.html b/index.html
index 604543ab..781c9b02 100644
--- a/index.html
+++ b/index.html
@@ -919,7 +919,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/installation.html b/installation.html
index ff0af820..fa3710bb 100644
--- a/installation.html
+++ b/installation.html
@@ -1047,7 +1047,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
diff --git a/release/v0-1-22.html b/release/v0-1-22.html
index 05bd4383..1898407d 100644
--- a/release/v0-1-22.html
+++ b/release/v0-1-22.html
@@ -22,7 +22,7 @@
     
     
       
-        <title>V0 1 22 - Komorebi</title>
+        <title>v0.1.22 - Komorebi</title>
       
     
     
@@ -77,7 +77,7 @@
     <div data-md-component="skip">
       
         
-        <a href="#tldr" class="md-skip">
+        <a href="#v0122" class="md-skip">
           Skip to content
         </a>
       
@@ -111,7 +111,7 @@
         <div class="md-header__topic" data-md-component="header-topic">
           <span class="md-ellipsis">
             
-              V0 1 22
+              v0.1.22
             
           </span>
         </div>
@@ -928,12 +928,14 @@
       <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
       
       
+        
+      
       
         <label class="md-nav__link md-nav__link--active" for="__toc">
           
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
@@ -944,7 +946,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>
   
 
@@ -956,6 +958,8 @@
   
   
   
+    
+  
   
     <label class="md-nav__title" for="__toc">
       <span class="md-nav__icon md-icon"></span>
@@ -4179,6 +4183,8 @@
   
   
   
+    
+  
   
     <label class="md-nav__title" for="__toc">
       <span class="md-nav__icon md-icon"></span>
@@ -4258,8 +4264,7 @@
   
 
 
-  <h1>V0 1 22</h1>
-
+<h1 id="v0122">v0.1.22</h1>
 <p>In addition to the <a href="https://github.com/LGUG2Z/komorebi/releases/tag/v0.1.22">changelog</a> of new features and fixes,
 please note the following changes from <code>v0.1.21</code> to adjust your configuration files accordingly.</p>
 <h2 id="tldr">tl;dr</h2>
diff --git a/search/search_index.json b/search/search_index.json
index 22fd1134..096ce41e 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"index.html","title":"Index","text":"<p><code>komorebi</code> is a tiling window manager that works as an extension to Microsoft's Desktop Window Manager in Windows 10 and above.</p> <p><code>komorebi</code> allows you to control application windows, virtual workspaces and display monitors with a CLI which can be used with third-party software such as AutoHotKey to set user-defined keyboard shortcuts.</p> <p><code>komorebi</code> aims to make as few modifications as possible to the operating system and desktop environment by default. Users are free to make such modifications in their own configuration files for <code>komorebi</code>, but these will always remain opt-in and off-by-default.</p> <p>There is a Discord server available for <code>komorebi</code>-related discussion, help, troubleshooting etc. If you have any specific feature requests or bugs to report, please create an issue on GitHub.</p> <p>There is also a YouTube channel where I share <code>komorebi</code> live programming videos and tutorial videos.</p>"},{"location":"design.html","title":"Design","text":""},{"location":"design.html#description","title":"Description","text":"<p>komorebi only responds to WinEvents and the messages it receives on a dedicated socket.</p> <p>komorebic is a CLI that writes messages on komorebi's socket.</p> <p>komorebi doesn't handle any keyboard or mouse inputs; a third party program (e.g. whkd) is needed in order to translate keyboard and mouse events to komorebic commands.</p> <p>This architecture, popularised by bspwm on Linux and yabai on macOS, is outlined as follows:</p> <pre><code>          PROCESS                SOCKET\nwhkd/ahk  --------&gt;  komorebic  &lt;------&gt;  komorebi\n</code></pre>"},{"location":"design.html#data-model","title":"Data Model","text":"<p>komorebi holds a list of physical monitors.</p> <p>A monitor is just a rectangle of the available work area which contains one or more virtual workspaces.</p> <p>A workspace holds a list of containers.</p> <p>A container is just a rectangle where one or more application windows can be displayed.</p> <p>This means that:</p> <ul> <li>Every monitor has its own collection of virtual workspaces</li> <li>Workspaces only know about containers and their dimensions, not about individual application windows</li> <li>Every application window must belong to a container, even if that container only contains one application window</li> <li>Many application windows can be stacked and cycled through in the same container within a workspace</li> </ul>"},{"location":"example-configurations.html","title":"Example configurations","text":"<p><code>komorebi</code>, and tiling window managers in general, are very complex pieces of software.</p> <p>In an attempt to reduce some of the initial configuration burden for users who are looking to try out the software for the first time, example configurations are provided and updated whenever appropriate.</p>"},{"location":"example-configurations.html#downloading-example-configurations","title":"Downloading example configurations","text":"<p>Run the following command to download example configuration files for <code>komorebi</code> and <code>whkd</code>. Pay attention to the output of the command to see where the example files have been downloaded. For most new users this will be in the <code>$Env:USERPROFILE</code> directory.</p> <pre><code>komorebic quickstart\n</code></pre> <p>With the example configurations downloaded, you can now start <code>komorebi</code> and `whkd.</p> <pre><code>komorebic start --whkd\n</code></pre>"},{"location":"example-configurations.html#komorebijson","title":"komorebi.json","text":"<p>The example window manager configuration sets some sane defaults and provides five preconfigured workspaces on the primary monitor each with a different layout.</p> <pre><code>{\n\"$schema\": \"https://raw.githubusercontent.com/LGUG2Z/komorebi/v0.1.25/schema.json\",\n\"app_specific_configuration_path\": \"$Env:USERPROFILE/applications.yaml\",\n\"window_hiding_behaviour\": \"Cloak\",\n\"cross_monitor_move_behaviour\": \"Insert\",\n\"default_workspace_padding\": 20,\n\"default_container_padding\": 20,\n\"border\": true,\n\"border_width\": 8,\n\"border_offset\": -1,\n\"border_colours\": {\n\"single\": \"#42a5f5\",\n\"stack\": \"#00a542\",\n\"monocle\": \"#ff3399\",\n\"unfocused\": \"#808080\"\n},\n\"stackbar\": {\n\"height\": 40,\n\"mode\": \"OnStack\",\n\"tabs\": {\n\"width\": 300,\n\"focused_text\": \"#00a542\",\n\"unfocused_text\": \"#b3b3b3\",\n\"background\": \"#141414\"\n}\n},\n\"monitors\": [\n{\n\"workspaces\": [\n{\n\"name\": \"I\",\n\"layout\": \"BSP\"\n},\n{\n\"name\": \"II\",\n\"layout\": \"VerticalStack\"\n},\n{\n\"name\": \"III\",\n\"layout\": \"HorizontalStack\"\n},\n{\n\"name\": \"IV\",\n\"layout\": \"UltrawideVerticalStack\"\n},\n{\n\"name\": \"V\",\n\"layout\": \"Rows\"\n},\n{\n\"name\": \"VI\",\n\"layout\": \"Grid\"\n},\n{\n\"name\": \"VII\",\n\"layout\": \"RightMainVerticalStack\"\n}\n]\n}\n]\n}\n</code></pre>"},{"location":"example-configurations.html#application-specific-configuration","title":"Application-specific configuration","text":"<p>There is a community-maintained repository of \"apps behaving badly\" that do not conform to Windows application development guidelines and behave erratically when used with <code>komorebi</code> without additional configuration.</p> <p>You can always download the latest version of these configurations by running <code>komorebic fetch-asc</code>. The output of this command will also provide a line that you can paste into <code>komorebi.json</code> to ensure that the window manager looks for the file in the correction location.</p> <p>When installing and running <code>komorebi</code> for the first time, the <code>komorebic quickstart</code> command will usually download this file to the <code>$Env:USERPROFILE</code> directory.</p>"},{"location":"example-configurations.html#padding","title":"Padding","text":"<p>While you can set the workspace padding (the space between the outer edges of the windows and the bezel of your monitor) and the container padding (the space between each of the tiled windows) for each workspace independently, you can also set a default for both of these values that will apply to all workspaces using <code>default_workspace_padding</code> and <code>default_container_padding</code>.</p>"},{"location":"example-configurations.html#active-window-border","title":"Active window border","text":"<p>You may have seen videos and screenshots of people using <code>komorebi</code> with a thick, colourful active window border. You can also enable this by setting <code>active_window_border</code> to <code>true</code>. However, please be warned that this feature is a crude hack trying to compensate for the insistence of Microsoft Windows design teams to make custom borders with widths that are actually visible to the user a thing of the past and removing this capability from the Win32 API.</p> <p>I know it's buggy, and I know that most of the it sucks, but this is something you should be bring up with the billion dollar company and not with me, the solo developer.</p>"},{"location":"example-configurations.html#border-colours","title":"Border colours","text":"<p>If you choose to use the active window border, you can set different colours to give you visual queues when you are focused on a single window, a stack of windows, or a window that is in monocole mode.</p> <p>The example colours given are blue single, green for stack and pink for monocle.</p>"},{"location":"example-configurations.html#layouts","title":"Layouts","text":""},{"location":"example-configurations.html#bsp","title":"BSP","text":"<pre><code>+-------+-----+\n|       |     |\n|       +--+--+\n|       |  |--|\n+-------+--+--+\n</code></pre>"},{"location":"example-configurations.html#vertical-stack","title":"Vertical Stack","text":"<pre><code>+-------+-----+\n|       |     |\n|       +-----+\n|       |     |\n+-------+-----+\n</code></pre>"},{"location":"example-configurations.html#rightmainverticalstack","title":"RightMainVerticalStack","text":"<pre><code>+-----+-------+\n|     |       |\n+-----+       |\n|     |       |\n+-----+-------+\n</code></pre>"},{"location":"example-configurations.html#horizontal-stack","title":"Horizontal Stack","text":"<pre><code>+------+------+\n|             |\n|------+------+\n|      |      |\n+------+------+\n</code></pre>"},{"location":"example-configurations.html#columns","title":"Columns","text":"<pre><code>+--+--+--+--+\n|  |  |  |  |\n|  |  |  |  |\n|  |  |  |  |\n+--+--+--+--+\n</code></pre>"},{"location":"example-configurations.html#rows","title":"Rows","text":"<p>If you have a vertical monitor, I recommend using this layout.</p> <pre><code>+-----------+\n|-----------|\n|-----------|\n|-----------|\n+-----------+\n</code></pre>"},{"location":"example-configurations.html#ultrawide-vertical-stack","title":"Ultrawide Vertical Stack","text":"<p>If you have an ultrawide monitor, I recommend using this layout.</p> <pre><code>+-----+-----------+-----+\n|     |           |     |\n|     |           +-----+\n|     |           |     |\n|     |           +-----+\n|     |           |     |\n+-----+-----------+-----+\n</code></pre>"},{"location":"example-configurations.html#grid","title":"Grid","text":"<p>If you like the <code>grid</code> layout in LeftWM this is almost exactly the same!</p> <pre><code>+-----+-----+   +---+---+---+   +---+---+---+   +---+---+---+\n|     |     |   |   |   |   |   |   |   |   |   |   |   |   |\n|     |     |   |   |   |   |   |   |   |   |   |   |   +---+\n+-----+-----+   |   +---+---+   +---+---+---+   +---+---|   |\n|     |     |   |   |   |   |   |   |   |   |   |   |   +---+\n|     |     |   |   |   |   |   |   |   |   |   |   |   |   |\n+-----+-----+   +---+---+---+   +---+---+---+   +---+---+---+\n  4 windows       5 windows       6 windows       7 windows\n</code></pre>"},{"location":"example-configurations.html#whkdrc","title":"whkdrc","text":"<p><code>whkd</code> is a fairly basic piece of software with a simple configuration format: key bindings go to the left of the colon, and shell commands go to the right of the colon. By default, the <code>whkdrc</code> file should be located in the <code>$Env:USERPROFILE/.config/</code> directory.</p> <p>Please remember that <code>whkd</code> does not support overriding Microsoft's limitations on hotkey bindings that include the <code>Windows</code> key. If this is important to you, I recommend using AutoHotKey to set up your key bindings for <code>komorebic</code> commands instead.</p> <pre><code>.shell powershell\n\n# Reload whkd configuration\n# alt + o                 : taskkill /f /im whkd.exe &amp;&amp; start /b whkd # if shell is cmd\nalt + o                 : taskkill /f /im whkd.exe; Start-Process whkd -WindowStyle hidden # if shell is pwsh / powershell\nalt + shift + o         : komorebic reload-configuration\n\n# App shortcuts - these require shell to be pwsh / powershell\n# The apps will be focused if open, or launched if not open\n# alt + f                 : if ($wshell.AppActivate('Firefox') -eq $False) { start firefox }\n# alt + b                 : if ($wshell.AppActivate('Chrome') -eq $False) { start chrome }\n\nalt + q                 : komorebic close\nalt + m                 : komorebic minimize\n\n# Focus windows\nalt + h                 : komorebic focus left\nalt + j                 : komorebic focus down\nalt + k                 : komorebic focus up\nalt + l                 : komorebic focus right\nalt + shift + oem_4     : komorebic cycle-focus previous # oem_4 is [\nalt + shift + oem_6     : komorebic cycle-focus next # oem_6 is ]\n\n# Move windows\nalt + shift + h         : komorebic move left\nalt + shift + j         : komorebic move down\nalt + shift + k         : komorebic move up\nalt + shift + l         : komorebic move right\nalt + shift + return    : komorebic promote\n\n# Stack windows\nalt + left              : komorebic stack left\nalt + down              : komorebic stack down\nalt + up                : komorebic stack up\nalt + right             : komorebic stack right\nalt + oem_1             : komorebic unstack # oem_1 is ;\nalt + oem_4             : komorebic cycle-stack previous # oem_4 is [\nalt + oem_6             : komorebic cycle-stack next # oem_6 is ]\n\n# Resize\nalt + oem_plus          : komorebic resize-axis horizontal increase\nalt + oem_minus         : komorebic resize-axis horizontal decrease\nalt + shift + oem_plus  : komorebic resize-axis vertical increase\nalt + shift + oem_minus : komorebic resize-axis vertical decrease\n\n# Manipulate windows\nalt + t                 : komorebic toggle-float\nalt + shift + f         : komorebic toggle-monocle\n\n# Window manager options\nalt + shift + r         : komorebic retile\nalt + p                 : komorebic toggle-pause\n\n# Layouts\nalt + x                 : komorebic flip-layout horizontal\nalt + y                 : komorebic flip-layout vertical\n\n# Workspaces\nalt + 1                 : komorebic focus-workspace 0\nalt + 2                 : komorebic focus-workspace 1\nalt + 3                 : komorebic focus-workspace 2\nalt + 4                 : komorebic focus-workspace 3\nalt + 5                 : komorebic focus-workspace 4\nalt + 6                 : komorebic focus-workspace 5\nalt + 7                 : komorebic focus-workspace 6\nalt + 8                 : komorebic focus-workspace 7\n\n# Move windows across workspaces\nalt + shift + 1         : komorebic move-to-workspace 0\nalt + shift + 2         : komorebic move-to-workspace 1\nalt + shift + 3         : komorebic move-to-workspace 2\nalt + shift + 4         : komorebic move-to-workspace 3\nalt + shift + 5         : komorebic move-to-workspace 4\nalt + shift + 6         : komorebic move-to-workspace 5\nalt + shift + 7         : komorebic move-to-workspace 6\nalt + shift + 8         : komorebic move-to-workspace 7\n</code></pre>"},{"location":"example-configurations.html#setting-shell","title":"Setting .shell","text":"<p>There is one special directive at the top of the file, <code>.shell</code> which can be set to either <code>powershell</code>, <code>pwsh</code> or <code>cmd</code>. Which one you use will depend on which shell you use in your terminal.</p> <ul> <li> <p><code>powershell</code> - set this if you are using the version of PowerShell that comes   installed with Windows 10+ (the executable file for this is <code>powershell.exe</code>)</p> </li> <li> <p><code>pwsh</code> - set this if you are using PowerShell 7+, which you have installed yourself either through the Windows Store   or WinGet (the executable file for this is <code>pwsh.exe</code>)</p> </li> <li> <p><code>cmd</code> - set this if you don't want to use PowerShell at all and instead you   want to call commands through the shell used by the old-school Command   Prompt (the executable file for this is <code>cmd.exe</code>)</p> </li> </ul>"},{"location":"example-configurations.html#key-codes","title":"Key codes","text":"<p>Key codes for alphanumeric and arrow keys are just what you would expect. For punctuation and other keys, please refer to the Virtual Key Codes reference.</p> <p>If you want to use one of those key codes, put them into lower case and remove the <code>VK_</code> prefix. For example, the keycode <code>VK_OEM_PLUS</code> becomes <code>oem_plus</code> in the sample configuration above.</p>"},{"location":"installation.html","title":"Getting started","text":"<p><code>komorebi</code> is a tiling window manager for Windows that is comprised comprised of two main binaries, <code>komorebi.exe</code>, which contains the window manager itself, and <code>komorebic.exe</code>, which is the main way to send commands to the tiling window manager.</p> <p>It is important to note that neither <code>komorebi.exe</code> or <code>komorebic.exe</code> handle key bindings, because <code>komorebi</code> is a tiling window manager and not a hotkey daemon.</p> <p>This getting started guide suggests the installation of <code>whkd</code> to allow you to bind <code>komorebic.exe</code> commands to hotkeys to allow you to communicate with the tiling window manager using keyboard shortcuts.</p> <p>However, <code>whkd</code> is a very simple hotkey daemon, and notably, does not include workarounds for Microsoft's restrictions on hotkey combinations that can use the <code>Windows</code> key.</p> <p>If using hotkey combinations with the <code>Windows</code> key is important to you, I suggest that once you are familiar with the main <code>komorebic.exe</code> commands used to manipulate the window manager, you use AutoHotKey to handle your key bindings.</p>"},{"location":"installation.html#installation","title":"Installation","text":"<p><code>komorebi</code> is available pre-built to install via Scoop and WinGet, and you may also built it from source if you would prefer.</p> <ul> <li>Scoop</li> <li>WinGet</li> <li>Building from source</li> <li>Offline</li> </ul>"},{"location":"installation.html#long-path-support","title":"Long path support","text":"<p>It highly recommended that you enable support for long paths in Windows by running the following command in an Administrator Terminal before installing <code>komorebi</code>.</p> <pre><code>Set-ItemProperty 'HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem' -Name 'LongPathsEnabled' -Value 1\n</code></pre>"},{"location":"installation.html#disabling-unnecessary-system-animations","title":"Disabling unnecessary system animations","text":"<p>It is highly recommended that you enable the \"Turn off all unnecessary animations (when possible)\" option in \"Control Panel &gt; Ease of Access &gt; Ease of Access Centre / Make the computer easier to see\" for the best performance with komorebi.</p>"},{"location":"installation.html#scoop","title":"Scoop","text":"<p>Make sure you have installed <code>scoop</code> and verified that installed binaries are available in your <code>$PATH</code> before proceeding.</p> <p>Issues with <code>komorebi</code> and related commands not being recognized in the terminal ultimately come down to the <code>$PATH</code> environment variable not being correctly configured by your package manager and should not be raised as bugs or issues either on the <code>komorebi</code> GitHub repository or Discord server.</p>"},{"location":"installation.html#install-komorebi-and-whkd","title":"Install komorebi and whkd","text":"<p>First add the extras bucket</p> <pre><code>scoop bucket add extras\n</code></pre> <p>Then install the <code>komorebi</code> and <code>whkd</code> packages using <code>scoop install</code></p> <pre><code>scoop install komorebi whkd\n</code></pre> <p>Once komorebi is installed, proceed to get the example configurations.</p>"},{"location":"installation.html#winget","title":"WinGet","text":"<p>Make sure you have installed the latest version of <code>winget</code> and verified that installed binaries are available in your <code>$PATH</code> before proceeding.</p> <p>Issues with <code>komorebi</code> and related commands not being recognized in the terminal ultimately come down to the <code>$PATH</code> environment variable not being correctly configured by your package manager and should not be raised as bugs or issues either on the <code>komorebi</code> GitHub repository or Discord server.</p>"},{"location":"installation.html#install-komorebi-and-whkd_1","title":"Install komorebi and whkd","text":"<p>Install the <code>komorebi</code> and <code>whkd</code> packages using <code>winget install</code></p> <pre><code>winget install LGUG2Z.komorebi\nwinget install LGUG2Z.whkd\n</code></pre> <p>Once komorebi is installed, proceed to get the example configurations.</p>"},{"location":"installation.html#building-from-source","title":"Building from source","text":"<p>Make sure you have installed <code>rustup</code>, a stable <code>rust</code> compiler toolchain, and the Visual Studio Visual Studio prerequisites.</p> <p>Clone the git repository, enter the directory, and build the following binaries:</p> <pre><code>cargo +stable install --path komorebi --locked\ncargo +stable install --path komorebic --locked\ncargo +stable install --path komorebic-no-console --locked\ncargo +stable install --path komorebi-gui --locked\n</code></pre> <p>If the binaries have been built and added to your <code>$PATH</code> correctly, you should see some output when running <code>komorebi --help</code> and <code>komorebic --help</code></p>"},{"location":"installation.html#offline","title":"Offline","text":"<p>Download the latest komorebi and whkd MSI installers on an internet-connected computer, then copy them to an offline machine to install.</p> <p>Once installed, proceed to get the example configurations (none of the commands for first-time set up and running komorebi require an internet connection).</p>"},{"location":"troubleshooting.html","title":"Troubleshooting","text":""},{"location":"troubleshooting.html#autohotkey-executable-not-found","title":"AutoHotKey executable not found","text":"<p>If you try to start komorebi with AHK using <code>komorebic start --ahk</code>, and you have not installed AHK using <code>scoop</code>, you'll probably receive an error:</p> <pre><code>Error: could not find autohotkey, please make sure it is installed before using the --ahk flag\n</code></pre> <p>Depending on how AHK is installed the executable on your system may have a different name. In order to account for this, you may set the <code>KOMOREBI_AHK_EXE</code> environment variable in your PowerShell profile to match the name of the executable as it is found on your system.</p> <p>After setting <code>KOMOREBI_AHK_EXE</code> make sure to either reload your PowerShell profile or open a new terminal tab.</p>"},{"location":"troubleshooting.html#komorebi-is-unresponsive-when-the-display-wakes-from-sleep","title":"Komorebi is unresponsive when the display wakes from sleep","text":"<p>This can happen in rare cases when your monitor state is not preserved after it wakes from sleep.</p>"},{"location":"troubleshooting.html#problem","title":"Problem","text":"<p>Your hotkeys in whkd work, but it feels as if komorebi knows nothing about the previous state (you can't control previous windows, although newly launched ones can be manipulated as normal).</p>"},{"location":"troubleshooting.html#solution","title":"Solution","text":"<p>Some monitors, such as the Samsung G8/G9 (LED, Neo, OLED) have an adaptive sync or variable refresh rate setting within the actual monitor OSD that can disrupt how the device is persisted in the komorebi state following suspension.</p> <p>To fix this, please try to disable Adaptive Sync or any other VRR branded alias by referring to the manufacturer's documentation.</p> <p>Warning</p> <p>Disabling VRR within Windows (e.g. Nvidia Control Panel) may work and can indeed change the configuration you see within your monitor's OSD, but some monitors will re-enable the setting regardless following suspension.</p>"},{"location":"troubleshooting.html#reproducing","title":"Reproducing","text":"<p>Ensure komorebi is in an operational state by executing <code>komorebic start</code> as normal.</p> <p>If komorebi is already unresponsive, then please restart komorebi first by running <code>komorebic stop</code> and <code>komorebic start</code>.</p> <ol> <li><code>komorebic state</code></li> </ol> <pre><code>{\n\"monitors\": {\n\"elements\": [\n{\n\"id\": 65537,\n\"name\": \"DISPLAY1\",\n\"device\": \"SAM71AA\",\n\"device_id\": \"SAM71AA-5&amp;a1a3e88&amp;0&amp;UID24834\",\n\"size\": {\n\"left\": 0,\n\"top\": 0,\n\"right\": 5120,\n\"bottom\": 1440\n}\n}\n]\n}\n}\n</code></pre> <p>This appears to be fine -- komorebi is aware of the device and associated    window handles.</p> <ol> <li>Let your display go to sleep.</li> </ol> <p>Simply turning the monitor off is not enough to reproduce the problem; you must    let Windows turn off the display itself.</p> <p>To avoid waiting an eternity:</p> <ul> <li> <p>Control Panel -&gt; Hardware and Sound -&gt; Power Options -&gt; Edit Plan      Settings</p> <p>Turn off the display: 1 minute</p> </li> </ul> <p>Allow a minute for the display to reset, then once it actually shuts off    allow for any additional time as prompted by your monitor for the cycle to    complete.</p> <ol> <li>Wake your display again by pressing any key.</li> </ol> <p>komorebi should now be unresponsive.</p> <ol> <li><code>komorebic state</code></li> </ol> <p>Don't stop komorebi just yet.</p> <p>Since it's unresponsive, you can open another shell instead to execute the above command.</p> <pre><code>{\n\"monitors\": {\n\"elements\": [\n{\n\"id\": 65537,\n\"name\": \"DISPLAY1\",\n\"device\": null,\n\"device_id\": null\n}\n]\n}\n}\n</code></pre> <p>We can see the komorebi state is no longer associated with the previous    device: <code>null</code>, suggesting an issue when the display resumes from a suspended    state.</p>"},{"location":"cli/adjust-container-padding.html","title":"adjust-container-padding","text":"<pre><code>Adjust container padding on the focused workspace\n\nUsage: komorebic.exe adjust-container-padding &lt;SIZING&gt; &lt;ADJUSTMENT&gt;\n\nArguments:\n  &lt;SIZING&gt;\n          [possible values: increase, decrease]\n\n  &lt;ADJUSTMENT&gt;\n          Pixels to adjust by as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/adjust-workspace-padding.html","title":"adjust-workspace-padding","text":"<pre><code>Adjust workspace padding on the focused workspace\n\nUsage: komorebic.exe adjust-workspace-padding &lt;SIZING&gt; &lt;ADJUSTMENT&gt;\n\nArguments:\n  &lt;SIZING&gt;\n          [possible values: increase, decrease]\n\n  &lt;ADJUSTMENT&gt;\n          Pixels to adjust by as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/ahk-app-specific-configuration.html","title":"ahk-app-specific-configuration","text":"<pre><code>Generate common app-specific configurations and fixes to use in komorebi.ahk\n\nUsage: komorebic.exe ahk-app-specific-configuration &lt;PATH&gt; [OVERRIDE_PATH]\n\nArguments:\n  &lt;PATH&gt;\n          YAML file from which the application-specific configurations should be loaded\n\n  [OVERRIDE_PATH]\n          Optional YAML file of overrides to apply over the first file\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/ahk-library.html","title":"ahk-library","text":"<pre><code>Generate a library of AutoHotKey helper functions\n\nUsage: komorebic.exe ahk-library\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/application-specific-configuration-schema.html","title":"application-specific-configuration-schema","text":"<pre><code>Generate a JSON Schema for applications.yaml\n\nUsage: komorebic.exe application-specific-configuration-schema\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/border-colour.html","title":"border-colour","text":"<pre><code>Set the colour for a window border kind\n\nUsage: komorebic.exe border-colour [OPTIONS] &lt;R&gt; &lt;G&gt; &lt;B&gt;\n\nArguments:\n  &lt;R&gt;\n          Red\n\n  &lt;G&gt;\n          Green\n\n  &lt;B&gt;\n          Blue\n\nOptions:\n  -w, --window-kind &lt;WINDOW_KIND&gt;\n          [default: single]\n          [possible values: single, stack, monocle, unfocused]\n\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/border-offset.html","title":"border-offset","text":"<pre><code>Set the border offset\n\nUsage: komorebic.exe border-offset &lt;OFFSET&gt;\n\nArguments:\n  &lt;OFFSET&gt;\n          Desired offset of the window border\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/border-width.html","title":"border-width","text":"<pre><code>Set the border width\n\nUsage: komorebic.exe border-width &lt;WIDTH&gt;\n\nArguments:\n  &lt;WIDTH&gt;\n          Desired width of the window border\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/border.html","title":"border","text":"<pre><code>Enable or disable borders\n\nUsage: komorebic.exe border &lt;BOOLEAN_STATE&gt;\n\nArguments:\n  &lt;BOOLEAN_STATE&gt;\n          [possible values: enable, disable]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/change-layout.html","title":"change-layout","text":"<pre><code>Set the layout on the focused workspace\n\nUsage: komorebic.exe change-layout &lt;DEFAULT_LAYOUT&gt;\n\nArguments:\n  &lt;DEFAULT_LAYOUT&gt;\n          [possible values: bsp, columns, rows, vertical-stack, horizontal-stack, ultrawide-vertical-stack, grid, right-main-vertical-stack]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/check.html","title":"check","text":"<pre><code>Check komorebi configuration and related files for common errors\n\nUsage: komorebic.exe check\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/clear-named-workspace-layout-rules.html","title":"clear-named-workspace-layout-rules","text":"<pre><code>Clear all dynamic layout rules for the specified workspace\n\nUsage: komorebic.exe clear-named-workspace-layout-rules &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/clear-workspace-layout-rules.html","title":"clear-workspace-layout-rules","text":"<pre><code>Clear all dynamic layout rules for the specified workspace\n\nUsage: komorebic.exe clear-workspace-layout-rules &lt;MONITOR&gt; &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/close.html","title":"close","text":"<pre><code>Close the focused window\n\nUsage: komorebic.exe close\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/complete-configuration.html","title":"complete-configuration","text":"<pre><code>Signal that the final configuration option has been sent\n\nUsage: komorebic.exe complete-configuration\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/configuration.html","title":"configuration","text":"<pre><code>Show the path to komorebi.json\n\nUsage: komorebic.exe configuration\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/container-padding.html","title":"container-padding","text":"<pre><code>Set the container padding for the specified workspace\n\nUsage: komorebic.exe container-padding &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;SIZE&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;SIZE&gt;\n          Pixels to pad with as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cross-monitor-move-behaviour.html","title":"cross-monitor-move-behaviour","text":"<pre><code>Set the behaviour when moving windows across monitor boundaries\n\nUsage: komorebic.exe cross-monitor-move-behaviour &lt;MOVE_BEHAVIOUR&gt;\n\nArguments:\n  &lt;MOVE_BEHAVIOUR&gt;\n          Possible values:\n          - swap:   Swap the window container with the window container at the edge of the adjacent monitor\n          - insert: Insert the window container into the focused workspace on the adjacent monitor\n          - no-op:  Do nothing if trying to move a window container in the direction of an adjacent monitor\n\nOptions:\n  -h, --help\n          Print help (see a summary with '-h')\n</code></pre>"},{"location":"cli/cycle-focus.html","title":"cycle-focus","text":"<pre><code>Change focus to the window in the specified cycle direction\n\nUsage: komorebic.exe cycle-focus &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-layout.html","title":"cycle-layout","text":"<pre><code>Cycle between available layouts\n\nUsage: komorebic.exe cycle-layout &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-monitor.html","title":"cycle-monitor","text":"<pre><code>Focus the monitor in the given cycle direction\n\nUsage: komorebic.exe cycle-monitor &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-move-to-monitor.html","title":"cycle-move-to-monitor","text":"<pre><code>Move the focused window to the monitor in the given cycle direction\n\nUsage: komorebic.exe cycle-move-to-monitor &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-move-to-workspace.html","title":"cycle-move-to-workspace","text":"<pre><code>Move the focused window to the workspace in the given cycle direction\n\nUsage: komorebic.exe cycle-move-to-workspace &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-move-workspace-to-monitor.html","title":"cycle-move-workspace-to-monitor","text":"<pre><code>Move the focused workspace monitor in the given cycle direction\n\nUsage: komorebic.exe cycle-move-workspace-to-monitor &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-move.html","title":"cycle-move","text":"<pre><code>Move the focused window in the specified cycle direction\n\nUsage: komorebic.exe cycle-move &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-send-to-monitor.html","title":"cycle-send-to-monitor","text":"<pre><code>Send the focused window to the monitor in the given cycle direction\n\nUsage: komorebic.exe cycle-send-to-monitor &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-send-to-workspace.html","title":"cycle-send-to-workspace","text":"<pre><code>Send the focused window to the workspace in the given cycle direction\n\nUsage: komorebic.exe cycle-send-to-workspace &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-stack.html","title":"cycle-stack","text":"<pre><code>Cycle the focused stack in the specified cycle direction\n\nUsage: komorebic.exe cycle-stack &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-workspace.html","title":"cycle-workspace","text":"<pre><code>Focus the workspace in the given cycle direction\n\nUsage: komorebic.exe cycle-workspace &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/disable-autostart.html","title":"disable-autostart","text":"<pre><code>Deletes the komorebi.lnk shortcut in shell:startup to disable autostart\n\nUsage: komorebic.exe disable-autostart\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/display-index-preference.html","title":"display-index-preference","text":"<pre><code>Set the display index preference for a monitor identified using its display name\n\nUsage: komorebic.exe display-index-preference &lt;INDEX_PREFERENCE&gt; &lt;DISPLAY&gt;\n\nArguments:\n  &lt;INDEX_PREFERENCE&gt;\n          Preferred monitor index (zero-indexed)\n\n  &lt;DISPLAY&gt;\n          Display name as identified in komorebic state\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/enable-autostart.html","title":"enable-autostart","text":"<pre><code>Generates the komorebi.lnk shortcut in shell:startup to autostart komorebi\n\nUsage: komorebic.exe enable-autostart [OPTIONS]\n\nOptions:\n  -c, --config &lt;CONFIG&gt;\n          Path to a static configuration JSON file\n\n  -f, --ffm\n          Enable komorebi's custom focus-follows-mouse implementation\n\n      --whkd\n          Enable autostart of whkd\n\n      --ahk\n          Enable autostart of ahk\n\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/ensure-named-workspaces.html","title":"ensure-named-workspaces","text":"<pre><code>Create these many named workspaces for the specified monitor\n\nUsage: komorebic.exe ensure-named-workspaces &lt;MONITOR&gt; [NAMES]...\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  [NAMES]...\n          Names of desired workspaces\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/ensure-workspaces.html","title":"ensure-workspaces","text":"<pre><code>Create at least this many workspaces for the specified monitor\n\nUsage: komorebic.exe ensure-workspaces &lt;MONITOR&gt; &lt;WORKSPACE_COUNT&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE_COUNT&gt;\n          Number of desired workspaces\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/fetch-app-specific-configuration.html","title":"fetch-app-specific-configuration","text":"<pre><code>Fetch the latest version of applications.yaml from komorebi-application-specific-configuration\n\nUsage: komorebic.exe fetch-app-specific-configuration\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/flip-layout.html","title":"flip-layout","text":"<pre><code>Flip the layout on the focused workspace (BSP only)\n\nUsage: komorebic.exe flip-layout &lt;AXIS&gt;\n\nArguments:\n  &lt;AXIS&gt;\n          [possible values: horizontal, vertical, horizontal-and-vertical]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/float-rule.html","title":"float-rule","text":"<pre><code>Add a rule to always float the specified application\n\nUsage: komorebic.exe float-rule &lt;IDENTIFIER&gt; &lt;ID&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focus-follows-mouse.html","title":"focus-follows-mouse","text":"<pre><code>Enable or disable focus follows mouse for the operating system\n\nUsage: komorebic.exe focus-follows-mouse [OPTIONS] &lt;BOOLEAN_STATE&gt;\n\nArguments:\n  &lt;BOOLEAN_STATE&gt;\n          [possible values: enable, disable]\n\nOptions:\n  -i, --implementation &lt;IMPLEMENTATION&gt;\n          [default: windows]\n\n          Possible values:\n          - komorebi: A custom FFM implementation (slightly more CPU-intensive)\n          - windows:  The native (legacy) Windows FFM implementation\n\n  -h, --help\n          Print help (see a summary with '-h')\n</code></pre>"},{"location":"cli/focus-last-workspace.html","title":"focus-last-workspace","text":"<pre><code>Focus the last focused workspace on the focused monitor\n\nUsage: komorebic.exe focus-last-workspace\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focus-monitor-workspace.html","title":"focus-monitor-workspace","text":"<pre><code>Focus the specified workspace on the target monitor\n\nUsage: komorebic.exe focus-monitor-workspace &lt;TARGET_MONITOR&gt; &lt;TARGET_WORKSPACE&gt;\n\nArguments:\n  &lt;TARGET_MONITOR&gt;\n          Target monitor index (zero-indexed)\n\n  &lt;TARGET_WORKSPACE&gt;\n          Workspace index on the target monitor (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focus-monitor.html","title":"focus-monitor","text":"<pre><code>Focus the specified monitor\n\nUsage: komorebic.exe focus-monitor &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focus-named-workspace.html","title":"focus-named-workspace","text":"<pre><code>Focus the specified workspace\n\nUsage: komorebic.exe focus-named-workspace &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focus-workspace.html","title":"focus-workspace","text":"<pre><code>Focus the specified workspace on the focused monitor\n\nUsage: komorebic.exe focus-workspace &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focus-workspaces.html","title":"focus-workspaces","text":"<pre><code>Focus the specified workspace on all monitors\n\nUsage: komorebic.exe focus-workspaces &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focus.html","title":"focus","text":"<pre><code>Change focus to the window in the specified direction\n\nUsage: komorebic.exe focus &lt;OPERATION_DIRECTION&gt;\n\nArguments:\n  &lt;OPERATION_DIRECTION&gt;\n          [possible values: left, right, up, down]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focused-workspace-container-padding.html","title":"focused-workspace-container-padding","text":"<pre><code>Set container padding on the focused workspace\n\nUsage: komorebic.exe focused-workspace-container-padding &lt;SIZE&gt;\n\nArguments:\n  &lt;SIZE&gt;\n          Pixels size to set as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focused-workspace-padding.html","title":"focused-workspace-padding","text":"<pre><code>Set workspace padding on the focused workspace\n\nUsage: komorebic.exe focused-workspace-padding &lt;SIZE&gt;\n\nArguments:\n  &lt;SIZE&gt;\n          Pixels size to set as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/force-focus.html","title":"force-focus","text":"<pre><code>Forcibly focus the window at the cursor with a left mouse click\n\nUsage: komorebic.exe force-focus\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/format-app-specific-configuration.html","title":"format-app-specific-configuration","text":"<pre><code>Format a YAML file for use with the 'ahk-app-specific-configuration' command\n\nUsage: komorebic.exe format-app-specific-configuration &lt;PATH&gt;\n\nArguments:\n  &lt;PATH&gt;\n          YAML file from which the application-specific configurations should be loaded\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/generate-static-config.html","title":"generate-static-config","text":"<pre><code>Generates a static configuration JSON file based on the current window manager state\n\nUsage: komorebic.exe generate-static-config\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/global-state.html","title":"global-state","text":"<pre><code>Show a JSON representation of the current global state\n\nUsage: komorebic.exe global-state\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/global-work-area-offset.html","title":"global-work-area-offset","text":"<pre><code>Set offsets to exclude parts of the work area from tiling\n\nUsage: komorebic.exe global-work-area-offset &lt;LEFT&gt; &lt;TOP&gt; &lt;RIGHT&gt; &lt;BOTTOM&gt;\n\nArguments:\n  &lt;LEFT&gt;\n          Size of the left work area offset (set right to left * 2 to maintain right padding)\n\n  &lt;TOP&gt;\n          Size of the top work area offset (set bottom to the same value to maintain bottom padding)\n\n  &lt;RIGHT&gt;\n          Size of the right work area offset\n\n  &lt;BOTTOM&gt;\n          Size of the bottom work area offset\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/gui.html","title":"gui","text":"<pre><code>Launch the komorebi-gui debugging tool\n\nUsage: komorebic.exe gui\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/identify-layered-application.html","title":"identify-layered-application","text":"<pre><code>Identify an application that has WS_EX_LAYERED, but should still be managed\n\nUsage: komorebic.exe identify-layered-application &lt;IDENTIFIER&gt; &lt;ID&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/identify-object-name-change-application.html","title":"identify-object-name-change-application","text":"<pre><code>Identify an application that sends EVENT_OBJECT_NAMECHANGE on launch\n\nUsage: komorebic.exe identify-object-name-change-application &lt;IDENTIFIER&gt; &lt;ID&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/identify-tray-application.html","title":"identify-tray-application","text":"<pre><code>Identify an application that closes to the system tray\n\nUsage: komorebic.exe identify-tray-application &lt;IDENTIFIER&gt; &lt;ID&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/initial-named-workspace-rule.html","title":"initial-named-workspace-rule","text":"<pre><code>Add a rule to associate an application with a named workspace on first show\n\nUsage: komorebic.exe initial-named-workspace-rule &lt;IDENTIFIER&gt; &lt;ID&gt; &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\n  &lt;WORKSPACE&gt;\n          Name of a workspace\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/initial-workspace-rule.html","title":"initial-workspace-rule","text":"<pre><code>Add a rule to associate an application with a workspace on first show\n\nUsage: komorebic.exe initial-workspace-rule &lt;IDENTIFIER&gt; &lt;ID&gt; &lt;MONITOR&gt; &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/invisible-borders.html","title":"invisible-borders","text":"<pre><code>Set the invisible border dimensions around each window\n\nUsage: komorebic.exe invisible-borders &lt;LEFT&gt; &lt;TOP&gt; &lt;RIGHT&gt; &lt;BOTTOM&gt;\n\nArguments:\n  &lt;LEFT&gt;\n          Size of the left invisible border\n\n  &lt;TOP&gt;\n          Size of the top invisible border (usually 0)\n\n  &lt;RIGHT&gt;\n          Size of the right invisible border (usually left * 2)\n\n  &lt;BOTTOM&gt;\n          Size of the bottom invisible border (usually the same as left)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/load-custom-layout.html","title":"load-custom-layout","text":"<pre><code>Load a custom layout from file for the focused workspace\n\nUsage: komorebic.exe load-custom-layout &lt;PATH&gt;\n\nArguments:\n  &lt;PATH&gt;\n          JSON or YAML file from which the custom layout definition should be loaded\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/load-resize.html","title":"load-resize","text":"<pre><code>Load the resize layout dimensions from a file\n\nUsage: komorebic.exe load-resize &lt;PATH&gt;\n\nArguments:\n  &lt;PATH&gt;\n          File from which the resize layout dimensions should be loaded\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/log.html","title":"log","text":"<pre><code>Tail komorebi.exe's process logs (cancel with Ctrl-C)\n\nUsage: komorebic.exe log\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/manage-rule.html","title":"manage-rule","text":"<pre><code>Add a rule to always manage the specified application\n\nUsage: komorebic.exe manage-rule &lt;IDENTIFIER&gt; &lt;ID&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/manage.html","title":"manage","text":"<pre><code>Force komorebi to manage the focused window\n\nUsage: komorebic.exe manage\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/minimize.html","title":"minimize","text":"<pre><code>Minimize the focused window\n\nUsage: komorebic.exe minimize\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/monitor-index-preference.html","title":"monitor-index-preference","text":"<pre><code>Set the monitor index preference for a monitor identified using its size\n\nUsage: komorebic.exe monitor-index-preference &lt;INDEX_PREFERENCE&gt; &lt;LEFT&gt; &lt;TOP&gt; &lt;RIGHT&gt; &lt;BOTTOM&gt;\n\nArguments:\n  &lt;INDEX_PREFERENCE&gt;\n          Preferred monitor index (zero-indexed)\n\n  &lt;LEFT&gt;\n          Left value of the monitor's size Rect\n\n  &lt;TOP&gt;\n          Top value of the monitor's size Rect\n\n  &lt;RIGHT&gt;\n          Right value of the monitor's size Rect\n\n  &lt;BOTTOM&gt;\n          Bottom value of the monitor's size Rect\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/monitor-work-area-offset.html","title":"monitor-work-area-offset","text":"<pre><code>Set offsets for a monitor to exclude parts of the work area from tiling\n\nUsage: komorebic.exe monitor-work-area-offset &lt;MONITOR&gt; &lt;LEFT&gt; &lt;TOP&gt; &lt;RIGHT&gt; &lt;BOTTOM&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;LEFT&gt;\n          Size of the left work area offset (set right to left * 2 to maintain right padding)\n\n  &lt;TOP&gt;\n          Size of the top work area offset (set bottom to the same value to maintain bottom padding)\n\n  &lt;RIGHT&gt;\n          Size of the right work area offset\n\n  &lt;BOTTOM&gt;\n          Size of the bottom work area offset\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/mouse-follows-focus.html","title":"mouse-follows-focus","text":"<pre><code>Enable or disable mouse follows focus on all workspaces\n\nUsage: komorebic.exe mouse-follows-focus &lt;BOOLEAN_STATE&gt;\n\nArguments:\n  &lt;BOOLEAN_STATE&gt;\n          [possible values: enable, disable]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/move-to-monitor-workspace.html","title":"move-to-monitor-workspace","text":"<pre><code>Move the focused window to the specified monitor workspace\n\nUsage: komorebic.exe move-to-monitor-workspace &lt;TARGET_MONITOR&gt; &lt;TARGET_WORKSPACE&gt;\n\nArguments:\n  &lt;TARGET_MONITOR&gt;\n          Target monitor index (zero-indexed)\n\n  &lt;TARGET_WORKSPACE&gt;\n          Workspace index on the target monitor (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/move-to-monitor.html","title":"move-to-monitor","text":"<pre><code>Move the focused window to the specified monitor\n\nUsage: komorebic.exe move-to-monitor &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/move-to-named-workspace.html","title":"move-to-named-workspace","text":"<pre><code>Move the focused window to the specified workspace\n\nUsage: komorebic.exe move-to-named-workspace &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/move-to-workspace.html","title":"move-to-workspace","text":"<pre><code>Move the focused window to the specified workspace\n\nUsage: komorebic.exe move-to-workspace &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/move-workspace-to-monitor.html","title":"move-workspace-to-monitor","text":"<pre><code>Move the focused workspace to the specified monitor\n\nUsage: komorebic.exe move-workspace-to-monitor &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/move.html","title":"move","text":"<pre><code>Move the focused window in the specified direction\n\nUsage: komorebic.exe move &lt;OPERATION_DIRECTION&gt;\n\nArguments:\n  &lt;OPERATION_DIRECTION&gt;\n          [possible values: left, right, up, down]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-container-padding.html","title":"named-workspace-container-padding","text":"<pre><code>Set the container padding for the specified workspace\n\nUsage: komorebic.exe named-workspace-container-padding &lt;WORKSPACE&gt; &lt;SIZE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\n  &lt;SIZE&gt;\n          Pixels to pad with as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-custom-layout-rule.html","title":"named-workspace-custom-layout-rule","text":"<pre><code>Add a dynamic custom layout for the specified workspace\n\nUsage: komorebic.exe named-workspace-custom-layout-rule &lt;WORKSPACE&gt; &lt;AT_CONTAINER_COUNT&gt; &lt;PATH&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\n  &lt;AT_CONTAINER_COUNT&gt;\n          The number of window containers on-screen required to trigger this layout rule\n\n  &lt;PATH&gt;\n          JSON or YAML file from which the custom layout definition should be loaded\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-custom-layout.html","title":"named-workspace-custom-layout","text":"<pre><code>Set a custom layout for the specified workspace\n\nUsage: komorebic.exe named-workspace-custom-layout &lt;WORKSPACE&gt; &lt;PATH&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\n  &lt;PATH&gt;\n          JSON or YAML file from which the custom layout definition should be loaded\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-layout-rule.html","title":"named-workspace-layout-rule","text":"<pre><code>Add a dynamic layout rule for the specified workspace\n\nUsage: komorebic.exe named-workspace-layout-rule &lt;WORKSPACE&gt; &lt;AT_CONTAINER_COUNT&gt; &lt;LAYOUT&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\n  &lt;AT_CONTAINER_COUNT&gt;\n          The number of window containers on-screen required to trigger this layout rule\n\n  &lt;LAYOUT&gt;\n          [possible values: bsp, columns, rows, vertical-stack, horizontal-stack, ultrawide-vertical-stack, grid, right-main-vertical-stack]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-layout.html","title":"named-workspace-layout","text":"<pre><code>Set the layout for the specified workspace\n\nUsage: komorebic.exe named-workspace-layout &lt;WORKSPACE&gt; &lt;VALUE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\n  &lt;VALUE&gt;\n          [possible values: bsp, columns, rows, vertical-stack, horizontal-stack, ultrawide-vertical-stack, grid, right-main-vertical-stack]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-padding.html","title":"named-workspace-padding","text":"<pre><code>Set the workspace padding for the specified workspace\n\nUsage: komorebic.exe named-workspace-padding &lt;WORKSPACE&gt; &lt;SIZE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\n  &lt;SIZE&gt;\n          Pixels to pad with as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-rule.html","title":"named-workspace-rule","text":"<pre><code>Add a rule to associate an application with a named workspace\n\nUsage: komorebic.exe named-workspace-rule &lt;IDENTIFIER&gt; &lt;ID&gt; &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\n  &lt;WORKSPACE&gt;\n          Name of a workspace\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-tiling.html","title":"named-workspace-tiling","text":"<pre><code>Enable or disable window tiling for the specified workspace\n\nUsage: komorebic.exe named-workspace-tiling &lt;WORKSPACE&gt; &lt;VALUE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\n  &lt;VALUE&gt;\n          [possible values: enable, disable]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/new-workspace.html","title":"new-workspace","text":"<pre><code>Create and append a new workspace on the focused monitor\n\nUsage: komorebic.exe new-workspace\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/notification-schema.html","title":"notification-schema","text":"<pre><code>Generate a JSON Schema of subscription notifications\n\nUsage: komorebic.exe notification-schema\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/promote-focus.html","title":"promote-focus","text":"<pre><code>Promote the user focus to the top of the tree\n\nUsage: komorebic.exe promote-focus\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/promote-window.html","title":"promote-window","text":"<pre><code>Promote the window in the specified direction\n\nUsage: komorebic.exe promote-window &lt;OPERATION_DIRECTION&gt;\n\nArguments:\n  &lt;OPERATION_DIRECTION&gt;\n          [possible values: left, right, up, down]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/promote.html","title":"promote","text":"<pre><code>Promote the focused window to the top of the tree\n\nUsage: komorebic.exe promote\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/pwsh-app-specific-configuration.html","title":"pwsh-app-specific-configuration","text":"<pre><code>Generate common app-specific configurations and fixes in a PowerShell script\n\nUsage: komorebic.exe pwsh-app-specific-configuration &lt;PATH&gt; [OVERRIDE_PATH]\n\nArguments:\n  &lt;PATH&gt;\n          YAML file from which the application-specific configurations should be loaded\n\n  [OVERRIDE_PATH]\n          Optional YAML file of overrides to apply over the first file\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/query.html","title":"query","text":"<pre><code>Query the current window manager state\n\nUsage: komorebic.exe query &lt;STATE_QUERY&gt;\n\nArguments:\n  &lt;STATE_QUERY&gt;\n          [possible values: focused-monitor-index, focused-workspace-index, focused-container-index, focused-window-index]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/quick-load-resize.html","title":"quick-load-resize","text":"<pre><code>Load the last quicksaved resize layout dimensions\n\nUsage: komorebic.exe quick-load-resize\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/quick-save-resize.html","title":"quick-save-resize","text":"<pre><code>Quicksave the current resize layout dimensions\n\nUsage: komorebic.exe quick-save-resize\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/quickstart.html","title":"quickstart","text":"<pre><code>Gather example configurations for a new-user quickstart\n\nUsage: komorebic.exe quickstart\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/reload-configuration.html","title":"reload-configuration","text":"<pre><code>Reload ~/komorebi.ahk (if it exists)\n\nUsage: komorebic.exe reload-configuration\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/remove-title-bar.html","title":"remove-title-bar","text":"<pre><code>Whitelist an application for title bar removal\n\nUsage: komorebic.exe remove-title-bar &lt;IDENTIFIER&gt; &lt;ID&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/resize-axis.html","title":"resize-axis","text":"<pre><code>Resize the focused window or primary column along the specified axis\n\nUsage: komorebic.exe resize-axis &lt;AXIS&gt; &lt;SIZING&gt;\n\nArguments:\n  &lt;AXIS&gt;\n          [possible values: horizontal, vertical, horizontal-and-vertical]\n\n  &lt;SIZING&gt;\n          [possible values: increase, decrease]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/resize-delta.html","title":"resize-delta","text":"<pre><code>Set the resize delta (used by resize-edge and resize-axis)\n\nUsage: komorebic.exe resize-delta &lt;PIXELS&gt;\n\nArguments:\n  &lt;PIXELS&gt;\n          The delta of pixels by which to increase or decrease window dimensions when resizing\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/resize-edge.html","title":"resize-edge","text":"<pre><code>Resize the focused window in the specified direction\n\nUsage: komorebic.exe resize-edge &lt;EDGE&gt; &lt;SIZING&gt;\n\nArguments:\n  &lt;EDGE&gt;\n          [possible values: left, right, up, down]\n\n  &lt;SIZING&gt;\n          [possible values: increase, decrease]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/restore-windows.html","title":"restore-windows","text":"<pre><code>Restore all hidden windows (debugging command)\n\nUsage: komorebic.exe restore-windows\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/retile.html","title":"retile","text":"<pre><code>Force the retiling of all managed windows\n\nUsage: komorebic.exe retile\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/save-resize.html","title":"save-resize","text":"<pre><code>Save the current resize layout dimensions to a file\n\nUsage: komorebic.exe save-resize &lt;PATH&gt;\n\nArguments:\n  &lt;PATH&gt;\n          File to which the resize layout dimensions should be saved\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/send-to-monitor-workspace.html","title":"send-to-monitor-workspace","text":"<pre><code>Send the focused window to the specified monitor workspace\n\nUsage: komorebic.exe send-to-monitor-workspace &lt;TARGET_MONITOR&gt; &lt;TARGET_WORKSPACE&gt;\n\nArguments:\n  &lt;TARGET_MONITOR&gt;\n          Target monitor index (zero-indexed)\n\n  &lt;TARGET_WORKSPACE&gt;\n          Workspace index on the target monitor (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/send-to-monitor.html","title":"send-to-monitor","text":"<pre><code>Send the focused window to the specified monitor\n\nUsage: komorebic.exe send-to-monitor &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/send-to-named-workspace.html","title":"send-to-named-workspace","text":"<pre><code>Send the focused window to the specified workspace\n\nUsage: komorebic.exe send-to-named-workspace &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/send-to-workspace.html","title":"send-to-workspace","text":"<pre><code>Send the focused window to the specified workspace\n\nUsage: komorebic.exe send-to-workspace &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/socket-schema.html","title":"socket-schema","text":"<pre><code>Generate a JSON Schema of socket messages\n\nUsage: komorebic.exe socket-schema\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/stack.html","title":"stack","text":"<pre><code>Stack the focused window in the specified direction\n\nUsage: komorebic.exe stack &lt;OPERATION_DIRECTION&gt;\n\nArguments:\n  &lt;OPERATION_DIRECTION&gt;\n          [possible values: left, right, up, down]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/start.html","title":"start","text":"<pre><code>Start komorebi.exe as a background process\n\nUsage: komorebic.exe start [OPTIONS]\n\nOptions:\n  -f, --ffm\n          Allow the use of komorebi's custom focus-follows-mouse implementation\n\n  -c, --config &lt;CONFIG&gt;\n          Path to a static configuration JSON file\n\n  -a, --await-configuration\n          Wait for 'komorebic complete-configuration' to be sent before processing events\n\n  -t, --tcp-port &lt;TCP_PORT&gt;\n          Start a TCP server on the given port to allow the direct sending of SocketMessages\n\n      --whkd\n          Start whkd in a background process\n\n      --ahk\n          Start autohotkey configuration file\n\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/state.html","title":"state","text":"<pre><code>Show a JSON representation of the current window manager state\n\nUsage: komorebic.exe state\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/static-config-schema.html","title":"static-config-schema","text":"<pre><code>Generate a JSON Schema of the static configuration file\n\nUsage: komorebic.exe static-config-schema\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/stop.html","title":"stop","text":"<pre><code>Stop the komorebi.exe process and restore all hidden windows\n\nUsage: komorebic.exe stop [OPTIONS]\n\nOptions:\n      --whkd\n          Stop whkd if it is running as a background process\n\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/subscribe-pipe.html","title":"subscribe-pipe","text":"<pre><code>Subscribe to komorebi events using a Named Pipe\n\nUsage: komorebic.exe subscribe-pipe &lt;NAMED_PIPE&gt;\n\nArguments:\n  &lt;NAMED_PIPE&gt;\n          Name of the pipe to send event notifications to (without \"\\\\.\\pipe\\\" prepended)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/subscribe-socket.html","title":"subscribe-socket","text":"<pre><code>Subscribe to komorebi events using a Unix Domain Socket\n\nUsage: komorebic.exe subscribe-socket &lt;SOCKET&gt;\n\nArguments:\n  &lt;SOCKET&gt;\n          Name of the socket to send event notifications to\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/swap-workspaces-with-monitor.html","title":"swap-workspaces-with-monitor","text":"<pre><code>Swap focused monitor workspaces with specified monitor\n\nUsage: komorebic.exe swap-workspaces-with-monitor &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-cross-monitor-move-behaviour.html","title":"toggle-cross-monitor-move-behaviour","text":"<pre><code>Toggle the behaviour when moving windows across monitor boundaries\n\nUsage: komorebic.exe toggle-cross-monitor-move-behaviour\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-float.html","title":"toggle-float","text":"<pre><code>Toggle floating mode for the focused window\n\nUsage: komorebic.exe toggle-float\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-focus-follows-mouse.html","title":"toggle-focus-follows-mouse","text":"<pre><code>Toggle focus follows mouse for the operating system\n\nUsage: komorebic.exe toggle-focus-follows-mouse [OPTIONS]\n\nOptions:\n  -i, --implementation &lt;IMPLEMENTATION&gt;\n          [default: windows]\n\n          Possible values:\n          - komorebi: A custom FFM implementation (slightly more CPU-intensive)\n          - windows:  The native (legacy) Windows FFM implementation\n\n  -h, --help\n          Print help (see a summary with '-h')\n</code></pre>"},{"location":"cli/toggle-maximize.html","title":"toggle-maximize","text":"<pre><code>Toggle native maximization for the focused window\n\nUsage: komorebic.exe toggle-maximize\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-monocle.html","title":"toggle-monocle","text":"<pre><code>Toggle monocle mode for the focused container\n\nUsage: komorebic.exe toggle-monocle\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-mouse-follows-focus.html","title":"toggle-mouse-follows-focus","text":"<pre><code>Toggle mouse follows focus on all workspaces\n\nUsage: komorebic.exe toggle-mouse-follows-focus\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-pause.html","title":"toggle-pause","text":"<pre><code>Toggle window tiling on the focused workspace\n\nUsage: komorebic.exe toggle-pause\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-tiling.html","title":"toggle-tiling","text":"<pre><code>Toggle window tiling on the focused workspace\n\nUsage: komorebic.exe toggle-tiling\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-title-bars.html","title":"toggle-title-bars","text":"<pre><code>Toggle title bars for whitelisted applications\n\nUsage: komorebic.exe toggle-title-bars\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-window-container-behaviour.html","title":"toggle-window-container-behaviour","text":"<pre><code>Toggle the behaviour for new windows (stacking or dynamic tiling)\n\nUsage: komorebic.exe toggle-window-container-behaviour\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/unmanage.html","title":"unmanage","text":"<pre><code>Unmanage a window that was forcibly managed\n\nUsage: komorebic.exe unmanage\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/unmanaged-window-operation-behaviour.html","title":"unmanaged-window-operation-behaviour","text":"<pre><code>Set the operation behaviour when the focused window is not managed\n\nUsage: komorebic.exe unmanaged-window-operation-behaviour &lt;OPERATION_BEHAVIOUR&gt;\n\nArguments:\n  &lt;OPERATION_BEHAVIOUR&gt;\n          Possible values:\n          - op:    Process komorebic commands on temporarily unmanaged/floated windows\n          - no-op: Ignore komorebic commands on temporarily unmanaged/floated windows\n\nOptions:\n  -h, --help\n          Print help (see a summary with '-h')\n</code></pre>"},{"location":"cli/unstack.html","title":"unstack","text":"<pre><code>Unstack the focused window\n\nUsage: komorebic.exe unstack\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/unsubscribe-pipe.html","title":"unsubscribe-pipe","text":"<pre><code>Unsubscribe from komorebi events\n\nUsage: komorebic.exe unsubscribe-pipe &lt;NAMED_PIPE&gt;\n\nArguments:\n  &lt;NAMED_PIPE&gt;\n          Name of the pipe to stop sending event notifications to (without \"\\\\.\\pipe\\\" prepended)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/unsubscribe-socket.html","title":"unsubscribe-socket","text":"<pre><code>Unsubscribe from komorebi events\n\nUsage: komorebic.exe unsubscribe-socket &lt;SOCKET&gt;\n\nArguments:\n  &lt;SOCKET&gt;\n          Name of the socket to stop sending event notifications to\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/visible-windows.html","title":"visible-windows","text":"<pre><code>Show a JSON representation of visible windows\n\nUsage: komorebic.exe visible-windows\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/watch-configuration.html","title":"watch-configuration","text":"<pre><code>Enable or disable watching of ~/komorebi.ahk (if it exists)\n\nUsage: komorebic.exe watch-configuration &lt;BOOLEAN_STATE&gt;\n\nArguments:\n  &lt;BOOLEAN_STATE&gt;\n          [possible values: enable, disable]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/whkdrc.html","title":"whkdrc","text":"<pre><code>Show the path to whkdrc\n\nUsage: komorebic.exe whkdrc\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/window-hiding-behaviour.html","title":"window-hiding-behaviour","text":"<pre><code>Set the window behaviour when switching workspaces / cycling stacks\n\nUsage: komorebic.exe window-hiding-behaviour &lt;HIDING_BEHAVIOUR&gt;\n\nArguments:\n  &lt;HIDING_BEHAVIOUR&gt;\n          Possible values:\n          - hide:     Use the SW_HIDE flag to hide windows when switching workspaces (has issues with Electron apps)\n          - minimize: Use the SW_MINIMIZE flag to hide windows when switching workspaces (has issues with frequent workspace switching)\n          - cloak:    Use the undocumented SetCloak Win32 function to hide windows when switching workspaces (has foregrounding issues)\n\nOptions:\n  -h, --help\n          Print help (see a summary with '-h')\n</code></pre>"},{"location":"cli/workspace-custom-layout-rule.html","title":"workspace-custom-layout-rule","text":"<pre><code>Add a dynamic custom layout for the specified workspace\n\nUsage: komorebic.exe workspace-custom-layout-rule &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;AT_CONTAINER_COUNT&gt; &lt;PATH&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;AT_CONTAINER_COUNT&gt;\n          The number of window containers on-screen required to trigger this layout rule\n\n  &lt;PATH&gt;\n          JSON or YAML file from which the custom layout definition should be loaded\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/workspace-custom-layout.html","title":"workspace-custom-layout","text":"<pre><code>Set a custom layout for the specified workspace\n\nUsage: komorebic.exe workspace-custom-layout &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;PATH&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;PATH&gt;\n          JSON or YAML file from which the custom layout definition should be loaded\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/workspace-layout-rule.html","title":"workspace-layout-rule","text":"<pre><code>Add a dynamic layout rule for the specified workspace\n\nUsage: komorebic.exe workspace-layout-rule &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;AT_CONTAINER_COUNT&gt; &lt;LAYOUT&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;AT_CONTAINER_COUNT&gt;\n          The number of window containers on-screen required to trigger this layout rule\n\n  &lt;LAYOUT&gt;\n          [possible values: bsp, columns, rows, vertical-stack, horizontal-stack, ultrawide-vertical-stack, grid, right-main-vertical-stack]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/workspace-layout.html","title":"workspace-layout","text":"<pre><code>Set the layout for the specified workspace\n\nUsage: komorebic.exe workspace-layout &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;VALUE&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;VALUE&gt;\n          [possible values: bsp, columns, rows, vertical-stack, horizontal-stack, ultrawide-vertical-stack, grid, right-main-vertical-stack]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/workspace-name.html","title":"workspace-name","text":"<pre><code>Set the workspace name for the specified workspace\n\nUsage: komorebic.exe workspace-name &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;VALUE&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;VALUE&gt;\n          Name of the workspace as a String\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/workspace-padding.html","title":"workspace-padding","text":"<pre><code>Set the workspace padding for the specified workspace\n\nUsage: komorebic.exe workspace-padding &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;SIZE&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;SIZE&gt;\n          Pixels to pad with as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/workspace-rule.html","title":"workspace-rule","text":"<pre><code>Add a rule to associate an application with a workspace\n\nUsage: komorebic.exe workspace-rule &lt;IDENTIFIER&gt; &lt;ID&gt; &lt;MONITOR&gt; &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/workspace-tiling.html","title":"workspace-tiling","text":"<pre><code>Enable or disable window tiling for the specified workspace\n\nUsage: komorebic.exe workspace-tiling &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;VALUE&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;VALUE&gt;\n          [possible values: enable, disable]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"common-workflows/autohotkey.html","title":"AutoHotkey","text":"<p>If you would like to use Autohotkey, please make sure you have AutoHotKey v2 installed.</p> <p>Generally, users who opt for AHK will have specific needs that can only be addressed by the advanced functionality of AHK, and so they are assumed to be able to craft their own configuration files.</p> <p>If you would like to try out AHK, here is a simple sample configuration which largely matches the <code>whkdrc</code> sample configuration.</p> <pre><code>#Requires AutoHotkey v2.0.2\n#SingleInstance Force\n\nKomorebic(cmd) {\n    RunWait(format(\"komorebic.exe {}\", cmd), , \"Hide\")\n}\n\n!q::Komorebic(\"close\")\n!m::Komorebic(\"minimize\")\n\n; Focus windows\n!h::Komorebic(\"focus left\")\n!j::Komorebic(\"focus down\")\n!k::Komorebic(\"focus up\")\n!l::Komorebic(\"focus right\")\n\n!+[::Komorebic(\"cycle-focus previous\")\n!+]::Komorebic(\"cycle-focus next\")\n\n; Move windows\n!+h::Komorebic(\"move left\")\n!+j::Komorebic(\"move down\")\n!+k::Komorebic(\"move up\")\n!+l::Komorebic(\"move right\")\n\n; Stack windows\n!Left::Komorebic(\"stack left\")\n!Down::Komorebic(\"stack down\")\n!Up::Komorebic(\"stack up\")\n!Right::Komorebic(\"stack right\")\n!;::Komorebic(\"unstack\")\n![::Komorebic(\"cycle-stack previous\")\n!]::Komorebic(\"cycle-stack next\")\n\n; Resize\n!=::Komorebic(\"resize-axis horizontal increase\")\n!-::Komorebic(\"resize-axis horizontal decrease\")\n!+=::Komorebic(\"resize-axis vertical increase\")\n!+_::Komorebic(\"resize-axis vertical decrease\")\n\n; Manipulate windows\n!t::Komorebic(\"toggle-float\")\n!f::Komorebic(\"toggle-monocle\")\n\n; Window manager options\n!+r::Komorebic(\"retile\")\n!p::Komorebic(\"toggle-pause\")\n\n; Layouts\n!x::Komorebic(\"flip-layout horizontal\")\n!y::Komorebic(\"flip-layout vertical\")\n\n; Workspaces\n!1::Komorebic(\"focus-workspace 0\")\n!2::Komorebic(\"focus-workspace 1\")\n!3::Komorebic(\"focus-workspace 2\")\n!4::Komorebic(\"focus-workspace 3\")\n!5::Komorebic(\"focus-workspace 4\")\n!6::Komorebic(\"focus-workspace 5\")\n!7::Komorebic(\"focus-workspace 6\")\n!8::Komorebic(\"focus-workspace 7\")\n\n; Move windows across workspaces\n!+1::Komorebic(\"move-to-workspace 0\")\n!+2::Komorebic(\"move-to-workspace 1\")\n!+3::Komorebic(\"move-to-workspace 2\")\n!+4::Komorebic(\"move-to-workspace 3\")\n!+5::Komorebic(\"move-to-workspace 4\")\n!+6::Komorebic(\"move-to-workspace 5\")\n!+7::Komorebic(\"move-to-workspace 6\")\n!+8::Komorebic(\"move-to-workspace 7\")\n</code></pre> <p>By default, the <code>komorebi.ahk</code> file should be located in the <code>$Env:USERPROFILE</code> directory, however, if <code>$Env:KOMOREBI_CONFIG_HOME</code> is set, it should be located there.</p> <p>Once the file is in place, you can stop komorebi and whkd by running <code>komorebic stop --whkd</code>, and then start komorebi with Autohotkey by running <code>komorebic start --ahk</code>.</p>"},{"location":"common-workflows/borders.html","title":"Borders","text":"<p>If you would like to add a visual border around both the currently focused window and unfocused windows ensure the following options are defined in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"border\": true,\n\"border_width\": 8,\n\"border_offset\": -1,\n\"border_style\": \"System\",\n\"border_colours\": {\n\"single\": \"#42a5f5\",\n\"stack\": \"#00a542\",\n\"monocle\": \"#ff3399\",\n\"unfocused\": \"#808080\"\n}\n}\n</code></pre> <p>It is important to note that borders will only apply to windows managed by <code>komorebi</code>.</p> <p>This feature is not considered stable, and you may encounter visual artifacts from time to time.</p> <p></p>"},{"location":"common-workflows/custom-layouts.html","title":"Custom Layouts","text":"<p>Particularly for users of ultrawide monitors, traditional tiling layouts may not seem like the most efficient use of screen space. If you feel this is the case with any of the default layouts, you are also welcome to create your own custom layouts and save them as JSON or YAML.</p> <p>If you're not comfortable writing the layouts directly in JSON or YAML, you can use the komorebi Custom Layout Generator to interactively define a custom layout, and then copy the generated JSON content.</p> <p>Custom layouts can be loaded on the current workspace or configured for a specific workspace in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"monitors\": [\n{\n\"workspaces\": [\n{\n\"name\": \"personal\",\n\"custom_layout\": \"C:/Users/LGUG2Z/my-custom-layout.json\"\n},\n]\n}\n]\n}\n</code></pre> <p>The fundamental building block of a custom komorebi layout is the Column.</p> <p>Columns come in three variants:</p> <ul> <li>Primary: This is where your primary focus will be on the screen most of   the time. There must be exactly one Primary Column in any custom layout.   Optionally, you can specify the percentage of the screen width that you want   the Primary Column to occupy.</li> <li>Secondary: This is an optional column that can either be full height of   split horizontally into a fixed number of maximum rows. There can be any   number of Secondary Columns in a custom layout.</li> <li>Tertiary: This is the final column where any remaining windows will be   split horizontally into rows as they get added.</li> </ul> <p>If there is only one window on the screen when a custom layout is selected, that window will take up the full work area of the screen.</p> <p>If the number of windows is equal to or less than the total number of columns defined in a custom layout, the windows will be arranged in an equal-width columns.</p> <p>When the number of windows is greater than the number of columns defined in the custom layout, the windows will begin to be arranged according to the constraints set on the Primary and Secondary columns of the layout.</p> <p>Here is an example custom layout that can be used as a starting point for your own:</p> <pre><code>- column: Secondary\nconfiguration: !Horizontal 2 # max number of rows\n- column: Primary\nconfiguration: !WidthPercentage 50 # percentage of screen\n- column: Tertiary\nconfiguration: Horizontal\n</code></pre> <p></p>"},{"location":"common-workflows/dynamic-layout-switching.html","title":"Dynamic Layout Switching","text":"<p>With <code>komorebi</code> it is possible to define rules to automatically change the layout on a specified workspace when a threshold of window containers is met.</p> <pre><code>{\n\"monitors\": [\n{\n\"workspaces\": [\n{\n\"name\": \"personal\",\n\"layout_rules\": {\n\"1\": \"BSP\"\n}\n\"custom_layout_rules\": {\n\"5\": \"C:/Users/LGUG2Z/my-custom-layout.json\"\n}\n},\n]\n}\n]\n}\n</code></pre> <p>In this example, when there are one or more window containers visible on the screen, the BSP layout is used, and when there are five or more window containers visible, a custom layout is used.</p> <p>However, if you add workspace layout rules, you will not be able to manually change the layout of a workspace until all layout rules for that workspace have been cleared.</p> <pre><code># for example, to clear rules from monitor 0, workspace 0\nkomorebic clear-workspace-layout-rules 0 0\n</code></pre>"},{"location":"common-workflows/focus-follows-mouse.html","title":"Focus Follows Mouse","text":"<p><code>komorebi</code> supports two focus-follows-mouse implementations; the native Windows Xmouse implementation, which treats the desktop, the task bar, and the system tray as windows and switches focus to them eagerly, and a custom <code>komorebi</code> implementation, which only considers windows managed by <code>komorebi</code> as valid targets to switch focus to when moving the mouse.</p> <p>To enable the <code>komorebi</code> implementation you must start the process with the <code>--ffm</code> flag to explicitly enable the feature. This is because the mouse tracking required for this feature significantly increases the CPU usage of the process (on my machine, it jumps from &lt;1% to ~4~), and this CPU increase persists regardless of whether focus-follows-mouse is enabled or disabled at any given time via <code>komorebic</code>'s configuration commands.</p> <p>If the <code>komorebi</code> process has been started with the <code>--ffm</code> flag, you can enable focus follows mouse behaviour in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"focus_follows_mouse\": \"Komorebi\"\n}\n</code></pre> <p>When calling any of the <code>komorebic</code> commands related to focus-follows-mouse functionality, the <code>windows</code> implementation will be chosen as the default implementation. You can optionally specify the <code>komorebi</code> implementation by passing it as an argument to the <code>--implementation</code> flag:</p> <pre><code>komorebic.exe toggle-focus-follows-mouse --implementation komorebi\n</code></pre>"},{"location":"common-workflows/force-manage-windows.html","title":"Force Manage Windows","text":"<p>\u2757\ufe0fNOTE: A significant number of force-manage window rules for the most common applications are already generated for you</p> <p>In some rare cases, a window may not automatically be registered to be managed by <code>komorebi</code>. You can add rules to enforce this behaviour in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"manage_rules\": [\n{\n\"kind\": \"Title\",\n\"id\": \"Media Player\",\n\"matching_strategy\": \"Equals\"\n}\n]\n}\n</code></pre>"},{"location":"common-workflows/ignore-windows.html","title":"Ignore Windows","text":"<p>\u2757\ufe0fNOTE: A significant number of ignored window rules for the most common applications are already generated for you</p> <p>Sometimes you will want a specific application to never be tiled, and instead float all the time. You can add rules to enforce this behaviour in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"float_rules\": [\n{\n\"kind\": \"Title\",\n\"id\": \"Media Player\",\n\"matching_strategy\": \"Equals\"\n}\n]\n}\n</code></pre>"},{"location":"common-workflows/komorebi-config-home.html","title":"<code>KOMOREBI_CONFIG_HOME</code>","text":"<p>If you do not want to keep komorebi-related files in your <code>$Env:USERPROFILE</code> directory, you can specify a custom directory by setting the <code>$Env:KOMOREBI_CONFIG_HOME</code> environment variable.</p> <p>For example, to use the <code>~/.config/komorebi</code> directory:</p> <pre><code># Run this command to make sure that the directory has been created\nmkdir -p ~/.config/komorebi\n\n# Run this command to open up your PowerShell profile configuration in Notepad\nnotepad $PROFILE\n\n# Add this line (with your login user!) to the bottom of your PowerShell profile configuration\n$Env:KOMOREBI_CONFIG_HOME = 'C:\\Users\\LGUG2Z\\.config\\komorebi'\n\n# Save the changes and then reload the PowerShell profile\n. $PROFILE\n</code></pre> <p>If you already have configuration files that you wish to keep, move them to the <code>~/.config/komorebi</code> directory.</p> <p>The next time you run <code>komorebic start</code>, any files created by or loaded by komorebi will be placed or expected to exist in this folder.</p> <p></p>"},{"location":"common-workflows/mouse-follows-focus.html","title":"Mouse Follows Focus","text":"<p>By default, the mouse will move to the center of the window when the focus is changed in a given direction. This behaviour is know as 'mouse follows focus'. This behaviour can be disabled in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"mouse_follows_focus\": false,\n}\n</code></pre> <p></p>"},{"location":"common-workflows/remove-gaps.html","title":"Remove Gaps","text":"<p>If you would like to remove all gaps by default, both between windows themselves, and between the monitor edges and the windows, you can set the following configuration options to <code>0</code> and <code>-1</code> in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"default_workspace_padding\": 0,\n\"default_container_padding\": 0,\n\"border_width\": 0,\n\"border_offset\": -1\n}\n</code></pre> <p>A restart of <code>komorebi</code> is required after changing these settings.</p> <p></p>"},{"location":"common-workflows/stackbar.html","title":"Stackbar","text":"<p>If you would like to add a visual stackbar to show which windows are in a container stack ensure the following options are defined in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"stackbar\": {\n\"height\": 40,\n\"mode\": \"OnStack\",\n\"tabs\": {\n\"width\": 300,\n\"focused_text\": \"#00a542\",\n\"unfocused_text\": \"#b3b3b3\",\n\"background\": \"#141414\"\n}\n}\n}\n</code></pre> <p>This feature is not considered stable, and you may encounter visual artifacts from time to time.</p>"},{"location":"common-workflows/tray-and-multi-window-applications.html","title":"Tray and Multi-Window Applications","text":"<p>\u2757\ufe0fNOTE: A significant number of tray and multi-window application rules for the most common applications are already generated for you</p> <p>If you are experiencing behaviour where closing a window leaves a blank tile, but minimizing the same window does not, you have probably enabled a 'close/minimize to tray' option for that application. You can tell <code>komorebi</code> to handle this application appropriately by identifying it via the executable name or the window class.</p> <pre><code>{\n\"tray_and_multi_window_applications\": [\n{\n\"kind\": \"Class\",\n\"id\": \"SDL_app\",\n\"matching_strategy\": \"Equals\"\n}\n]\n}\n</code></pre>"},{"location":"release/v0-1-22.html","title":"V0 1 22","text":"<p>In addition to the changelog of new features and fixes, please note the following changes from <code>v0.1.21</code> to adjust your configuration files accordingly.</p>"},{"location":"release/v0-1-22.html#tldr","title":"tl;dr","text":"<p>The way windows are sized and drawn has been improved to remove the need to manually specify and remove invisible borders for applications that overflow them. If you use the active window border, the first time you launch <code>v0.1.22</code> you may end up with a huge border due to these changes.</p> <p><code>active_window_border_width</code> and <code>active_window_border_offset</code> have been renamed to <code>border_width</code> and <code>border_offset</code> as they now also apply outside the context of the active window border.</p> <pre><code>{\n\"active_window_border\": true,\n\"border_width\": 8,\n\"border_offset\": -1\n}\n</code></pre> <p>Users of the active window border should start from these settings and read the notes below before making further adjustments.</p>"},{"location":"release/v0-1-22.html#changes-to-active_window_border-and-window-sizing","title":"Changes to <code>active_window_border</code>, and window sizing:","text":"<ul> <li>The border no longer creates a second drop-shadow around the active window</li> <li>Windows are now sized to fill the layout region entirely, ignoring window decorations such as drop shadows</li> <li>Border offset now starts exactly at the paint edge of the window on all sides</li> <li>Windows are sized such that the border offset and border width are taken into account</li> </ul>"},{"location":"release/v0-1-22.html#recommended-patterns","title":"Recommended patterns","text":""},{"location":"release/v0-1-22.html#gapless","title":"Gapless","text":"<ul> <li>Disable \"transparency effects\" Personalization &gt; Colors</li> <li>Set the following settings in <code>komorebi.json</code>: <pre><code>{\n\"default_workspace_padding\": 0,\n\"default_container_padding\": 0,\n\"border_offset\": -1,\n\"border_width\": 0\n}\n</code></pre></li> </ul>"},{"location":"release/v0-1-22.html#1px-border","title":"1px border","text":"<p>A 1px border is drawn around the window edge. Users may see a gap for a single pixel, if the system theme has a transparent edge - this is the windows themed edge, and is not present for all applications.</p> <pre><code>  {\n\"border_offset\": 0,\n\"border_width\": 1\n}\n</code></pre>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"index.html","title":"Index","text":"<p><code>komorebi</code> is a tiling window manager that works as an extension to Microsoft's Desktop Window Manager in Windows 10 and above.</p> <p><code>komorebi</code> allows you to control application windows, virtual workspaces and display monitors with a CLI which can be used with third-party software such as AutoHotKey to set user-defined keyboard shortcuts.</p> <p><code>komorebi</code> aims to make as few modifications as possible to the operating system and desktop environment by default. Users are free to make such modifications in their own configuration files for <code>komorebi</code>, but these will always remain opt-in and off-by-default.</p> <p>There is a Discord server available for <code>komorebi</code>-related discussion, help, troubleshooting etc. If you have any specific feature requests or bugs to report, please create an issue on GitHub.</p> <p>There is also a YouTube channel where I share <code>komorebi</code> live programming videos and tutorial videos.</p>"},{"location":"design.html","title":"Design","text":""},{"location":"design.html#description","title":"Description","text":"<p>komorebi only responds to WinEvents and the messages it receives on a dedicated socket.</p> <p>komorebic is a CLI that writes messages on komorebi's socket.</p> <p>komorebi doesn't handle any keyboard or mouse inputs; a third party program (e.g. whkd) is needed in order to translate keyboard and mouse events to komorebic commands.</p> <p>This architecture, popularised by bspwm on Linux and yabai on macOS, is outlined as follows:</p> <pre><code>          PROCESS                SOCKET\nwhkd/ahk  --------&gt;  komorebic  &lt;------&gt;  komorebi\n</code></pre>"},{"location":"design.html#data-model","title":"Data Model","text":"<p>komorebi holds a list of physical monitors.</p> <p>A monitor is just a rectangle of the available work area which contains one or more virtual workspaces.</p> <p>A workspace holds a list of containers.</p> <p>A container is just a rectangle where one or more application windows can be displayed.</p> <p>This means that:</p> <ul> <li>Every monitor has its own collection of virtual workspaces</li> <li>Workspaces only know about containers and their dimensions, not about individual application windows</li> <li>Every application window must belong to a container, even if that container only contains one application window</li> <li>Many application windows can be stacked and cycled through in the same container within a workspace</li> </ul>"},{"location":"example-configurations.html","title":"Example configurations","text":"<p><code>komorebi</code>, and tiling window managers in general, are very complex pieces of software.</p> <p>In an attempt to reduce some of the initial configuration burden for users who are looking to try out the software for the first time, example configurations are provided and updated whenever appropriate.</p>"},{"location":"example-configurations.html#downloading-example-configurations","title":"Downloading example configurations","text":"<p>Run the following command to download example configuration files for <code>komorebi</code> and <code>whkd</code>. Pay attention to the output of the command to see where the example files have been downloaded. For most new users this will be in the <code>$Env:USERPROFILE</code> directory.</p> <pre><code>komorebic quickstart\n</code></pre> <p>With the example configurations downloaded, you can now start <code>komorebi</code> and `whkd.</p> <pre><code>komorebic start --whkd\n</code></pre>"},{"location":"example-configurations.html#komorebijson","title":"komorebi.json","text":"<p>The example window manager configuration sets some sane defaults and provides five preconfigured workspaces on the primary monitor each with a different layout.</p> <pre><code>{\n\"$schema\": \"https://raw.githubusercontent.com/LGUG2Z/komorebi/v0.1.25/schema.json\",\n\"app_specific_configuration_path\": \"$Env:USERPROFILE/applications.yaml\",\n\"window_hiding_behaviour\": \"Cloak\",\n\"cross_monitor_move_behaviour\": \"Insert\",\n\"default_workspace_padding\": 20,\n\"default_container_padding\": 20,\n\"border\": true,\n\"border_width\": 8,\n\"border_offset\": -1,\n\"border_colours\": {\n\"single\": \"#42a5f5\",\n\"stack\": \"#00a542\",\n\"monocle\": \"#ff3399\",\n\"unfocused\": \"#808080\"\n},\n\"stackbar\": {\n\"height\": 40,\n\"mode\": \"OnStack\",\n\"tabs\": {\n\"width\": 300,\n\"focused_text\": \"#00a542\",\n\"unfocused_text\": \"#b3b3b3\",\n\"background\": \"#141414\"\n}\n},\n\"monitors\": [\n{\n\"workspaces\": [\n{\n\"name\": \"I\",\n\"layout\": \"BSP\"\n},\n{\n\"name\": \"II\",\n\"layout\": \"VerticalStack\"\n},\n{\n\"name\": \"III\",\n\"layout\": \"HorizontalStack\"\n},\n{\n\"name\": \"IV\",\n\"layout\": \"UltrawideVerticalStack\"\n},\n{\n\"name\": \"V\",\n\"layout\": \"Rows\"\n},\n{\n\"name\": \"VI\",\n\"layout\": \"Grid\"\n},\n{\n\"name\": \"VII\",\n\"layout\": \"RightMainVerticalStack\"\n}\n]\n}\n]\n}\n</code></pre>"},{"location":"example-configurations.html#application-specific-configuration","title":"Application-specific configuration","text":"<p>There is a community-maintained repository of \"apps behaving badly\" that do not conform to Windows application development guidelines and behave erratically when used with <code>komorebi</code> without additional configuration.</p> <p>You can always download the latest version of these configurations by running <code>komorebic fetch-asc</code>. The output of this command will also provide a line that you can paste into <code>komorebi.json</code> to ensure that the window manager looks for the file in the correction location.</p> <p>When installing and running <code>komorebi</code> for the first time, the <code>komorebic quickstart</code> command will usually download this file to the <code>$Env:USERPROFILE</code> directory.</p>"},{"location":"example-configurations.html#padding","title":"Padding","text":"<p>While you can set the workspace padding (the space between the outer edges of the windows and the bezel of your monitor) and the container padding (the space between each of the tiled windows) for each workspace independently, you can also set a default for both of these values that will apply to all workspaces using <code>default_workspace_padding</code> and <code>default_container_padding</code>.</p>"},{"location":"example-configurations.html#active-window-border","title":"Active window border","text":"<p>You may have seen videos and screenshots of people using <code>komorebi</code> with a thick, colourful active window border. You can also enable this by setting <code>active_window_border</code> to <code>true</code>. However, please be warned that this feature is a crude hack trying to compensate for the insistence of Microsoft Windows design teams to make custom borders with widths that are actually visible to the user a thing of the past and removing this capability from the Win32 API.</p> <p>I know it's buggy, and I know that most of the it sucks, but this is something you should be bring up with the billion dollar company and not with me, the solo developer.</p>"},{"location":"example-configurations.html#border-colours","title":"Border colours","text":"<p>If you choose to use the active window border, you can set different colours to give you visual queues when you are focused on a single window, a stack of windows, or a window that is in monocole mode.</p> <p>The example colours given are blue single, green for stack and pink for monocle.</p>"},{"location":"example-configurations.html#layouts","title":"Layouts","text":""},{"location":"example-configurations.html#bsp","title":"BSP","text":"<pre><code>+-------+-----+\n|       |     |\n|       +--+--+\n|       |  |--|\n+-------+--+--+\n</code></pre>"},{"location":"example-configurations.html#vertical-stack","title":"Vertical Stack","text":"<pre><code>+-------+-----+\n|       |     |\n|       +-----+\n|       |     |\n+-------+-----+\n</code></pre>"},{"location":"example-configurations.html#rightmainverticalstack","title":"RightMainVerticalStack","text":"<pre><code>+-----+-------+\n|     |       |\n+-----+       |\n|     |       |\n+-----+-------+\n</code></pre>"},{"location":"example-configurations.html#horizontal-stack","title":"Horizontal Stack","text":"<pre><code>+------+------+\n|             |\n|------+------+\n|      |      |\n+------+------+\n</code></pre>"},{"location":"example-configurations.html#columns","title":"Columns","text":"<pre><code>+--+--+--+--+\n|  |  |  |  |\n|  |  |  |  |\n|  |  |  |  |\n+--+--+--+--+\n</code></pre>"},{"location":"example-configurations.html#rows","title":"Rows","text":"<p>If you have a vertical monitor, I recommend using this layout.</p> <pre><code>+-----------+\n|-----------|\n|-----------|\n|-----------|\n+-----------+\n</code></pre>"},{"location":"example-configurations.html#ultrawide-vertical-stack","title":"Ultrawide Vertical Stack","text":"<p>If you have an ultrawide monitor, I recommend using this layout.</p> <pre><code>+-----+-----------+-----+\n|     |           |     |\n|     |           +-----+\n|     |           |     |\n|     |           +-----+\n|     |           |     |\n+-----+-----------+-----+\n</code></pre>"},{"location":"example-configurations.html#grid","title":"Grid","text":"<p>If you like the <code>grid</code> layout in LeftWM this is almost exactly the same!</p> <pre><code>+-----+-----+   +---+---+---+   +---+---+---+   +---+---+---+\n|     |     |   |   |   |   |   |   |   |   |   |   |   |   |\n|     |     |   |   |   |   |   |   |   |   |   |   |   +---+\n+-----+-----+   |   +---+---+   +---+---+---+   +---+---|   |\n|     |     |   |   |   |   |   |   |   |   |   |   |   +---+\n|     |     |   |   |   |   |   |   |   |   |   |   |   |   |\n+-----+-----+   +---+---+---+   +---+---+---+   +---+---+---+\n  4 windows       5 windows       6 windows       7 windows\n</code></pre>"},{"location":"example-configurations.html#whkdrc","title":"whkdrc","text":"<p><code>whkd</code> is a fairly basic piece of software with a simple configuration format: key bindings go to the left of the colon, and shell commands go to the right of the colon. By default, the <code>whkdrc</code> file should be located in the <code>$Env:USERPROFILE/.config/</code> directory.</p> <p>Please remember that <code>whkd</code> does not support overriding Microsoft's limitations on hotkey bindings that include the <code>Windows</code> key. If this is important to you, I recommend using AutoHotKey to set up your key bindings for <code>komorebic</code> commands instead.</p> <pre><code>.shell powershell\n\n# Reload whkd configuration\n# alt + o                 : taskkill /f /im whkd.exe &amp;&amp; start /b whkd # if shell is cmd\nalt + o                 : taskkill /f /im whkd.exe; Start-Process whkd -WindowStyle hidden # if shell is pwsh / powershell\nalt + shift + o         : komorebic reload-configuration\n\n# App shortcuts - these require shell to be pwsh / powershell\n# The apps will be focused if open, or launched if not open\n# alt + f                 : if ($wshell.AppActivate('Firefox') -eq $False) { start firefox }\n# alt + b                 : if ($wshell.AppActivate('Chrome') -eq $False) { start chrome }\n\nalt + q                 : komorebic close\nalt + m                 : komorebic minimize\n\n# Focus windows\nalt + h                 : komorebic focus left\nalt + j                 : komorebic focus down\nalt + k                 : komorebic focus up\nalt + l                 : komorebic focus right\nalt + shift + oem_4     : komorebic cycle-focus previous # oem_4 is [\nalt + shift + oem_6     : komorebic cycle-focus next # oem_6 is ]\n\n# Move windows\nalt + shift + h         : komorebic move left\nalt + shift + j         : komorebic move down\nalt + shift + k         : komorebic move up\nalt + shift + l         : komorebic move right\nalt + shift + return    : komorebic promote\n\n# Stack windows\nalt + left              : komorebic stack left\nalt + down              : komorebic stack down\nalt + up                : komorebic stack up\nalt + right             : komorebic stack right\nalt + oem_1             : komorebic unstack # oem_1 is ;\nalt + oem_4             : komorebic cycle-stack previous # oem_4 is [\nalt + oem_6             : komorebic cycle-stack next # oem_6 is ]\n\n# Resize\nalt + oem_plus          : komorebic resize-axis horizontal increase\nalt + oem_minus         : komorebic resize-axis horizontal decrease\nalt + shift + oem_plus  : komorebic resize-axis vertical increase\nalt + shift + oem_minus : komorebic resize-axis vertical decrease\n\n# Manipulate windows\nalt + t                 : komorebic toggle-float\nalt + shift + f         : komorebic toggle-monocle\n\n# Window manager options\nalt + shift + r         : komorebic retile\nalt + p                 : komorebic toggle-pause\n\n# Layouts\nalt + x                 : komorebic flip-layout horizontal\nalt + y                 : komorebic flip-layout vertical\n\n# Workspaces\nalt + 1                 : komorebic focus-workspace 0\nalt + 2                 : komorebic focus-workspace 1\nalt + 3                 : komorebic focus-workspace 2\nalt + 4                 : komorebic focus-workspace 3\nalt + 5                 : komorebic focus-workspace 4\nalt + 6                 : komorebic focus-workspace 5\nalt + 7                 : komorebic focus-workspace 6\nalt + 8                 : komorebic focus-workspace 7\n\n# Move windows across workspaces\nalt + shift + 1         : komorebic move-to-workspace 0\nalt + shift + 2         : komorebic move-to-workspace 1\nalt + shift + 3         : komorebic move-to-workspace 2\nalt + shift + 4         : komorebic move-to-workspace 3\nalt + shift + 5         : komorebic move-to-workspace 4\nalt + shift + 6         : komorebic move-to-workspace 5\nalt + shift + 7         : komorebic move-to-workspace 6\nalt + shift + 8         : komorebic move-to-workspace 7\n</code></pre>"},{"location":"example-configurations.html#setting-shell","title":"Setting .shell","text":"<p>There is one special directive at the top of the file, <code>.shell</code> which can be set to either <code>powershell</code>, <code>pwsh</code> or <code>cmd</code>. Which one you use will depend on which shell you use in your terminal.</p> <ul> <li> <p><code>powershell</code> - set this if you are using the version of PowerShell that comes   installed with Windows 10+ (the executable file for this is <code>powershell.exe</code>)</p> </li> <li> <p><code>pwsh</code> - set this if you are using PowerShell 7+, which you have installed yourself either through the Windows Store   or WinGet (the executable file for this is <code>pwsh.exe</code>)</p> </li> <li> <p><code>cmd</code> - set this if you don't want to use PowerShell at all and instead you   want to call commands through the shell used by the old-school Command   Prompt (the executable file for this is <code>cmd.exe</code>)</p> </li> </ul>"},{"location":"example-configurations.html#key-codes","title":"Key codes","text":"<p>Key codes for alphanumeric and arrow keys are just what you would expect. For punctuation and other keys, please refer to the Virtual Key Codes reference.</p> <p>If you want to use one of those key codes, put them into lower case and remove the <code>VK_</code> prefix. For example, the keycode <code>VK_OEM_PLUS</code> becomes <code>oem_plus</code> in the sample configuration above.</p>"},{"location":"installation.html","title":"Getting started","text":"<p><code>komorebi</code> is a tiling window manager for Windows that is comprised comprised of two main binaries, <code>komorebi.exe</code>, which contains the window manager itself, and <code>komorebic.exe</code>, which is the main way to send commands to the tiling window manager.</p> <p>It is important to note that neither <code>komorebi.exe</code> or <code>komorebic.exe</code> handle key bindings, because <code>komorebi</code> is a tiling window manager and not a hotkey daemon.</p> <p>This getting started guide suggests the installation of <code>whkd</code> to allow you to bind <code>komorebic.exe</code> commands to hotkeys to allow you to communicate with the tiling window manager using keyboard shortcuts.</p> <p>However, <code>whkd</code> is a very simple hotkey daemon, and notably, does not include workarounds for Microsoft's restrictions on hotkey combinations that can use the <code>Windows</code> key.</p> <p>If using hotkey combinations with the <code>Windows</code> key is important to you, I suggest that once you are familiar with the main <code>komorebic.exe</code> commands used to manipulate the window manager, you use AutoHotKey to handle your key bindings.</p>"},{"location":"installation.html#installation","title":"Installation","text":"<p><code>komorebi</code> is available pre-built to install via Scoop and WinGet, and you may also built it from source if you would prefer.</p> <ul> <li>Scoop</li> <li>WinGet</li> <li>Building from source</li> <li>Offline</li> </ul>"},{"location":"installation.html#long-path-support","title":"Long path support","text":"<p>It highly recommended that you enable support for long paths in Windows by running the following command in an Administrator Terminal before installing <code>komorebi</code>.</p> <pre><code>Set-ItemProperty 'HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem' -Name 'LongPathsEnabled' -Value 1\n</code></pre>"},{"location":"installation.html#disabling-unnecessary-system-animations","title":"Disabling unnecessary system animations","text":"<p>It is highly recommended that you enable the \"Turn off all unnecessary animations (when possible)\" option in \"Control Panel &gt; Ease of Access &gt; Ease of Access Centre / Make the computer easier to see\" for the best performance with komorebi.</p>"},{"location":"installation.html#scoop","title":"Scoop","text":"<p>Make sure you have installed <code>scoop</code> and verified that installed binaries are available in your <code>$PATH</code> before proceeding.</p> <p>Issues with <code>komorebi</code> and related commands not being recognized in the terminal ultimately come down to the <code>$PATH</code> environment variable not being correctly configured by your package manager and should not be raised as bugs or issues either on the <code>komorebi</code> GitHub repository or Discord server.</p>"},{"location":"installation.html#install-komorebi-and-whkd","title":"Install komorebi and whkd","text":"<p>First add the extras bucket</p> <pre><code>scoop bucket add extras\n</code></pre> <p>Then install the <code>komorebi</code> and <code>whkd</code> packages using <code>scoop install</code></p> <pre><code>scoop install komorebi whkd\n</code></pre> <p>Once komorebi is installed, proceed to get the example configurations.</p>"},{"location":"installation.html#winget","title":"WinGet","text":"<p>Make sure you have installed the latest version of <code>winget</code> and verified that installed binaries are available in your <code>$PATH</code> before proceeding.</p> <p>Issues with <code>komorebi</code> and related commands not being recognized in the terminal ultimately come down to the <code>$PATH</code> environment variable not being correctly configured by your package manager and should not be raised as bugs or issues either on the <code>komorebi</code> GitHub repository or Discord server.</p>"},{"location":"installation.html#install-komorebi-and-whkd_1","title":"Install komorebi and whkd","text":"<p>Install the <code>komorebi</code> and <code>whkd</code> packages using <code>winget install</code></p> <pre><code>winget install LGUG2Z.komorebi\nwinget install LGUG2Z.whkd\n</code></pre> <p>Once komorebi is installed, proceed to get the example configurations.</p>"},{"location":"installation.html#building-from-source","title":"Building from source","text":"<p>Make sure you have installed <code>rustup</code>, a stable <code>rust</code> compiler toolchain, and the Visual Studio Visual Studio prerequisites.</p> <p>Clone the git repository, enter the directory, and build the following binaries:</p> <pre><code>cargo +stable install --path komorebi --locked\ncargo +stable install --path komorebic --locked\ncargo +stable install --path komorebic-no-console --locked\ncargo +stable install --path komorebi-gui --locked\n</code></pre> <p>If the binaries have been built and added to your <code>$PATH</code> correctly, you should see some output when running <code>komorebi --help</code> and <code>komorebic --help</code></p>"},{"location":"installation.html#offline","title":"Offline","text":"<p>Download the latest komorebi and whkd MSI installers on an internet-connected computer, then copy them to an offline machine to install.</p> <p>Once installed, proceed to get the example configurations (none of the commands for first-time set up and running komorebi require an internet connection).</p>"},{"location":"troubleshooting.html","title":"Troubleshooting","text":""},{"location":"troubleshooting.html#autohotkey-executable-not-found","title":"AutoHotKey executable not found","text":"<p>If you try to start komorebi with AHK using <code>komorebic start --ahk</code>, and you have not installed AHK using <code>scoop</code>, you'll probably receive an error:</p> <pre><code>Error: could not find autohotkey, please make sure it is installed before using the --ahk flag\n</code></pre> <p>Depending on how AHK is installed the executable on your system may have a different name. In order to account for this, you may set the <code>KOMOREBI_AHK_EXE</code> environment variable in your PowerShell profile to match the name of the executable as it is found on your system.</p> <p>After setting <code>KOMOREBI_AHK_EXE</code> make sure to either reload your PowerShell profile or open a new terminal tab.</p>"},{"location":"troubleshooting.html#komorebi-is-unresponsive-when-the-display-wakes-from-sleep","title":"Komorebi is unresponsive when the display wakes from sleep","text":"<p>This can happen in rare cases when your monitor state is not preserved after it wakes from sleep.</p>"},{"location":"troubleshooting.html#problem","title":"Problem","text":"<p>Your hotkeys in whkd work, but it feels as if komorebi knows nothing about the previous state (you can't control previous windows, although newly launched ones can be manipulated as normal).</p>"},{"location":"troubleshooting.html#solution","title":"Solution","text":"<p>Some monitors, such as the Samsung G8/G9 (LED, Neo, OLED) have an adaptive sync or variable refresh rate setting within the actual monitor OSD that can disrupt how the device is persisted in the komorebi state following suspension.</p> <p>To fix this, please try to disable Adaptive Sync or any other VRR branded alias by referring to the manufacturer's documentation.</p> <p>Warning</p> <p>Disabling VRR within Windows (e.g. Nvidia Control Panel) may work and can indeed change the configuration you see within your monitor's OSD, but some monitors will re-enable the setting regardless following suspension.</p>"},{"location":"troubleshooting.html#reproducing","title":"Reproducing","text":"<p>Ensure komorebi is in an operational state by executing <code>komorebic start</code> as normal.</p> <p>If komorebi is already unresponsive, then please restart komorebi first by running <code>komorebic stop</code> and <code>komorebic start</code>.</p> <ol> <li><code>komorebic state</code></li> </ol> <pre><code>{\n\"monitors\": {\n\"elements\": [\n{\n\"id\": 65537,\n\"name\": \"DISPLAY1\",\n\"device\": \"SAM71AA\",\n\"device_id\": \"SAM71AA-5&amp;a1a3e88&amp;0&amp;UID24834\",\n\"size\": {\n\"left\": 0,\n\"top\": 0,\n\"right\": 5120,\n\"bottom\": 1440\n}\n}\n]\n}\n}\n</code></pre> <p>This appears to be fine -- komorebi is aware of the device and associated    window handles.</p> <ol> <li>Let your display go to sleep.</li> </ol> <p>Simply turning the monitor off is not enough to reproduce the problem; you must    let Windows turn off the display itself.</p> <p>To avoid waiting an eternity:</p> <ul> <li> <p>Control Panel -&gt; Hardware and Sound -&gt; Power Options -&gt; Edit Plan      Settings</p> <p>Turn off the display: 1 minute</p> </li> </ul> <p>Allow a minute for the display to reset, then once it actually shuts off    allow for any additional time as prompted by your monitor for the cycle to    complete.</p> <ol> <li>Wake your display again by pressing any key.</li> </ol> <p>komorebi should now be unresponsive.</p> <ol> <li><code>komorebic state</code></li> </ol> <p>Don't stop komorebi just yet.</p> <p>Since it's unresponsive, you can open another shell instead to execute the above command.</p> <pre><code>{\n\"monitors\": {\n\"elements\": [\n{\n\"id\": 65537,\n\"name\": \"DISPLAY1\",\n\"device\": null,\n\"device_id\": null\n}\n]\n}\n}\n</code></pre> <p>We can see the komorebi state is no longer associated with the previous    device: <code>null</code>, suggesting an issue when the display resumes from a suspended    state.</p>"},{"location":"cli/adjust-container-padding.html","title":"adjust-container-padding","text":"<pre><code>Adjust container padding on the focused workspace\n\nUsage: komorebic.exe adjust-container-padding &lt;SIZING&gt; &lt;ADJUSTMENT&gt;\n\nArguments:\n  &lt;SIZING&gt;\n          [possible values: increase, decrease]\n\n  &lt;ADJUSTMENT&gt;\n          Pixels to adjust by as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/adjust-workspace-padding.html","title":"adjust-workspace-padding","text":"<pre><code>Adjust workspace padding on the focused workspace\n\nUsage: komorebic.exe adjust-workspace-padding &lt;SIZING&gt; &lt;ADJUSTMENT&gt;\n\nArguments:\n  &lt;SIZING&gt;\n          [possible values: increase, decrease]\n\n  &lt;ADJUSTMENT&gt;\n          Pixels to adjust by as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/ahk-app-specific-configuration.html","title":"ahk-app-specific-configuration","text":"<pre><code>Generate common app-specific configurations and fixes to use in komorebi.ahk\n\nUsage: komorebic.exe ahk-app-specific-configuration &lt;PATH&gt; [OVERRIDE_PATH]\n\nArguments:\n  &lt;PATH&gt;\n          YAML file from which the application-specific configurations should be loaded\n\n  [OVERRIDE_PATH]\n          Optional YAML file of overrides to apply over the first file\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/ahk-library.html","title":"ahk-library","text":"<pre><code>Generate a library of AutoHotKey helper functions\n\nUsage: komorebic.exe ahk-library\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/application-specific-configuration-schema.html","title":"application-specific-configuration-schema","text":"<pre><code>Generate a JSON Schema for applications.yaml\n\nUsage: komorebic.exe application-specific-configuration-schema\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/border-colour.html","title":"border-colour","text":"<pre><code>Set the colour for a window border kind\n\nUsage: komorebic.exe border-colour [OPTIONS] &lt;R&gt; &lt;G&gt; &lt;B&gt;\n\nArguments:\n  &lt;R&gt;\n          Red\n\n  &lt;G&gt;\n          Green\n\n  &lt;B&gt;\n          Blue\n\nOptions:\n  -w, --window-kind &lt;WINDOW_KIND&gt;\n          [default: single]\n          [possible values: single, stack, monocle, unfocused]\n\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/border-offset.html","title":"border-offset","text":"<pre><code>Set the border offset\n\nUsage: komorebic.exe border-offset &lt;OFFSET&gt;\n\nArguments:\n  &lt;OFFSET&gt;\n          Desired offset of the window border\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/border-width.html","title":"border-width","text":"<pre><code>Set the border width\n\nUsage: komorebic.exe border-width &lt;WIDTH&gt;\n\nArguments:\n  &lt;WIDTH&gt;\n          Desired width of the window border\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/border.html","title":"border","text":"<pre><code>Enable or disable borders\n\nUsage: komorebic.exe border &lt;BOOLEAN_STATE&gt;\n\nArguments:\n  &lt;BOOLEAN_STATE&gt;\n          [possible values: enable, disable]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/change-layout.html","title":"change-layout","text":"<pre><code>Set the layout on the focused workspace\n\nUsage: komorebic.exe change-layout &lt;DEFAULT_LAYOUT&gt;\n\nArguments:\n  &lt;DEFAULT_LAYOUT&gt;\n          [possible values: bsp, columns, rows, vertical-stack, horizontal-stack, ultrawide-vertical-stack, grid, right-main-vertical-stack]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/check.html","title":"check","text":"<pre><code>Check komorebi configuration and related files for common errors\n\nUsage: komorebic.exe check\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/clear-named-workspace-layout-rules.html","title":"clear-named-workspace-layout-rules","text":"<pre><code>Clear all dynamic layout rules for the specified workspace\n\nUsage: komorebic.exe clear-named-workspace-layout-rules &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/clear-workspace-layout-rules.html","title":"clear-workspace-layout-rules","text":"<pre><code>Clear all dynamic layout rules for the specified workspace\n\nUsage: komorebic.exe clear-workspace-layout-rules &lt;MONITOR&gt; &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/close.html","title":"close","text":"<pre><code>Close the focused window\n\nUsage: komorebic.exe close\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/complete-configuration.html","title":"complete-configuration","text":"<pre><code>Signal that the final configuration option has been sent\n\nUsage: komorebic.exe complete-configuration\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/configuration.html","title":"configuration","text":"<pre><code>Show the path to komorebi.json\n\nUsage: komorebic.exe configuration\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/container-padding.html","title":"container-padding","text":"<pre><code>Set the container padding for the specified workspace\n\nUsage: komorebic.exe container-padding &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;SIZE&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;SIZE&gt;\n          Pixels to pad with as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cross-monitor-move-behaviour.html","title":"cross-monitor-move-behaviour","text":"<pre><code>Set the behaviour when moving windows across monitor boundaries\n\nUsage: komorebic.exe cross-monitor-move-behaviour &lt;MOVE_BEHAVIOUR&gt;\n\nArguments:\n  &lt;MOVE_BEHAVIOUR&gt;\n          Possible values:\n          - swap:   Swap the window container with the window container at the edge of the adjacent monitor\n          - insert: Insert the window container into the focused workspace on the adjacent monitor\n          - no-op:  Do nothing if trying to move a window container in the direction of an adjacent monitor\n\nOptions:\n  -h, --help\n          Print help (see a summary with '-h')\n</code></pre>"},{"location":"cli/cycle-focus.html","title":"cycle-focus","text":"<pre><code>Change focus to the window in the specified cycle direction\n\nUsage: komorebic.exe cycle-focus &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-layout.html","title":"cycle-layout","text":"<pre><code>Cycle between available layouts\n\nUsage: komorebic.exe cycle-layout &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-monitor.html","title":"cycle-monitor","text":"<pre><code>Focus the monitor in the given cycle direction\n\nUsage: komorebic.exe cycle-monitor &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-move-to-monitor.html","title":"cycle-move-to-monitor","text":"<pre><code>Move the focused window to the monitor in the given cycle direction\n\nUsage: komorebic.exe cycle-move-to-monitor &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-move-to-workspace.html","title":"cycle-move-to-workspace","text":"<pre><code>Move the focused window to the workspace in the given cycle direction\n\nUsage: komorebic.exe cycle-move-to-workspace &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-move-workspace-to-monitor.html","title":"cycle-move-workspace-to-monitor","text":"<pre><code>Move the focused workspace monitor in the given cycle direction\n\nUsage: komorebic.exe cycle-move-workspace-to-monitor &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-move.html","title":"cycle-move","text":"<pre><code>Move the focused window in the specified cycle direction\n\nUsage: komorebic.exe cycle-move &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-send-to-monitor.html","title":"cycle-send-to-monitor","text":"<pre><code>Send the focused window to the monitor in the given cycle direction\n\nUsage: komorebic.exe cycle-send-to-monitor &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-send-to-workspace.html","title":"cycle-send-to-workspace","text":"<pre><code>Send the focused window to the workspace in the given cycle direction\n\nUsage: komorebic.exe cycle-send-to-workspace &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-stack.html","title":"cycle-stack","text":"<pre><code>Cycle the focused stack in the specified cycle direction\n\nUsage: komorebic.exe cycle-stack &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/cycle-workspace.html","title":"cycle-workspace","text":"<pre><code>Focus the workspace in the given cycle direction\n\nUsage: komorebic.exe cycle-workspace &lt;CYCLE_DIRECTION&gt;\n\nArguments:\n  &lt;CYCLE_DIRECTION&gt;\n          [possible values: previous, next]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/disable-autostart.html","title":"disable-autostart","text":"<pre><code>Deletes the komorebi.lnk shortcut in shell:startup to disable autostart\n\nUsage: komorebic.exe disable-autostart\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/display-index-preference.html","title":"display-index-preference","text":"<pre><code>Set the display index preference for a monitor identified using its display name\n\nUsage: komorebic.exe display-index-preference &lt;INDEX_PREFERENCE&gt; &lt;DISPLAY&gt;\n\nArguments:\n  &lt;INDEX_PREFERENCE&gt;\n          Preferred monitor index (zero-indexed)\n\n  &lt;DISPLAY&gt;\n          Display name as identified in komorebic state\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/enable-autostart.html","title":"enable-autostart","text":"<pre><code>Generates the komorebi.lnk shortcut in shell:startup to autostart komorebi\n\nUsage: komorebic.exe enable-autostart [OPTIONS]\n\nOptions:\n  -c, --config &lt;CONFIG&gt;\n          Path to a static configuration JSON file\n\n  -f, --ffm\n          Enable komorebi's custom focus-follows-mouse implementation\n\n      --whkd\n          Enable autostart of whkd\n\n      --ahk\n          Enable autostart of ahk\n\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/ensure-named-workspaces.html","title":"ensure-named-workspaces","text":"<pre><code>Create these many named workspaces for the specified monitor\n\nUsage: komorebic.exe ensure-named-workspaces &lt;MONITOR&gt; [NAMES]...\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  [NAMES]...\n          Names of desired workspaces\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/ensure-workspaces.html","title":"ensure-workspaces","text":"<pre><code>Create at least this many workspaces for the specified monitor\n\nUsage: komorebic.exe ensure-workspaces &lt;MONITOR&gt; &lt;WORKSPACE_COUNT&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE_COUNT&gt;\n          Number of desired workspaces\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/fetch-app-specific-configuration.html","title":"fetch-app-specific-configuration","text":"<pre><code>Fetch the latest version of applications.yaml from komorebi-application-specific-configuration\n\nUsage: komorebic.exe fetch-app-specific-configuration\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/flip-layout.html","title":"flip-layout","text":"<pre><code>Flip the layout on the focused workspace (BSP only)\n\nUsage: komorebic.exe flip-layout &lt;AXIS&gt;\n\nArguments:\n  &lt;AXIS&gt;\n          [possible values: horizontal, vertical, horizontal-and-vertical]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/float-rule.html","title":"float-rule","text":"<pre><code>Add a rule to always float the specified application\n\nUsage: komorebic.exe float-rule &lt;IDENTIFIER&gt; &lt;ID&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focus-follows-mouse.html","title":"focus-follows-mouse","text":"<pre><code>Enable or disable focus follows mouse for the operating system\n\nUsage: komorebic.exe focus-follows-mouse [OPTIONS] &lt;BOOLEAN_STATE&gt;\n\nArguments:\n  &lt;BOOLEAN_STATE&gt;\n          [possible values: enable, disable]\n\nOptions:\n  -i, --implementation &lt;IMPLEMENTATION&gt;\n          [default: windows]\n\n          Possible values:\n          - komorebi: A custom FFM implementation (slightly more CPU-intensive)\n          - windows:  The native (legacy) Windows FFM implementation\n\n  -h, --help\n          Print help (see a summary with '-h')\n</code></pre>"},{"location":"cli/focus-last-workspace.html","title":"focus-last-workspace","text":"<pre><code>Focus the last focused workspace on the focused monitor\n\nUsage: komorebic.exe focus-last-workspace\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focus-monitor-workspace.html","title":"focus-monitor-workspace","text":"<pre><code>Focus the specified workspace on the target monitor\n\nUsage: komorebic.exe focus-monitor-workspace &lt;TARGET_MONITOR&gt; &lt;TARGET_WORKSPACE&gt;\n\nArguments:\n  &lt;TARGET_MONITOR&gt;\n          Target monitor index (zero-indexed)\n\n  &lt;TARGET_WORKSPACE&gt;\n          Workspace index on the target monitor (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focus-monitor.html","title":"focus-monitor","text":"<pre><code>Focus the specified monitor\n\nUsage: komorebic.exe focus-monitor &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focus-named-workspace.html","title":"focus-named-workspace","text":"<pre><code>Focus the specified workspace\n\nUsage: komorebic.exe focus-named-workspace &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focus-workspace.html","title":"focus-workspace","text":"<pre><code>Focus the specified workspace on the focused monitor\n\nUsage: komorebic.exe focus-workspace &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focus-workspaces.html","title":"focus-workspaces","text":"<pre><code>Focus the specified workspace on all monitors\n\nUsage: komorebic.exe focus-workspaces &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focus.html","title":"focus","text":"<pre><code>Change focus to the window in the specified direction\n\nUsage: komorebic.exe focus &lt;OPERATION_DIRECTION&gt;\n\nArguments:\n  &lt;OPERATION_DIRECTION&gt;\n          [possible values: left, right, up, down]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focused-workspace-container-padding.html","title":"focused-workspace-container-padding","text":"<pre><code>Set container padding on the focused workspace\n\nUsage: komorebic.exe focused-workspace-container-padding &lt;SIZE&gt;\n\nArguments:\n  &lt;SIZE&gt;\n          Pixels size to set as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/focused-workspace-padding.html","title":"focused-workspace-padding","text":"<pre><code>Set workspace padding on the focused workspace\n\nUsage: komorebic.exe focused-workspace-padding &lt;SIZE&gt;\n\nArguments:\n  &lt;SIZE&gt;\n          Pixels size to set as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/force-focus.html","title":"force-focus","text":"<pre><code>Forcibly focus the window at the cursor with a left mouse click\n\nUsage: komorebic.exe force-focus\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/format-app-specific-configuration.html","title":"format-app-specific-configuration","text":"<pre><code>Format a YAML file for use with the 'ahk-app-specific-configuration' command\n\nUsage: komorebic.exe format-app-specific-configuration &lt;PATH&gt;\n\nArguments:\n  &lt;PATH&gt;\n          YAML file from which the application-specific configurations should be loaded\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/generate-static-config.html","title":"generate-static-config","text":"<pre><code>Generates a static configuration JSON file based on the current window manager state\n\nUsage: komorebic.exe generate-static-config\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/global-state.html","title":"global-state","text":"<pre><code>Show a JSON representation of the current global state\n\nUsage: komorebic.exe global-state\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/global-work-area-offset.html","title":"global-work-area-offset","text":"<pre><code>Set offsets to exclude parts of the work area from tiling\n\nUsage: komorebic.exe global-work-area-offset &lt;LEFT&gt; &lt;TOP&gt; &lt;RIGHT&gt; &lt;BOTTOM&gt;\n\nArguments:\n  &lt;LEFT&gt;\n          Size of the left work area offset (set right to left * 2 to maintain right padding)\n\n  &lt;TOP&gt;\n          Size of the top work area offset (set bottom to the same value to maintain bottom padding)\n\n  &lt;RIGHT&gt;\n          Size of the right work area offset\n\n  &lt;BOTTOM&gt;\n          Size of the bottom work area offset\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/gui.html","title":"gui","text":"<pre><code>Launch the komorebi-gui debugging tool\n\nUsage: komorebic.exe gui\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/identify-layered-application.html","title":"identify-layered-application","text":"<pre><code>Identify an application that has WS_EX_LAYERED, but should still be managed\n\nUsage: komorebic.exe identify-layered-application &lt;IDENTIFIER&gt; &lt;ID&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/identify-object-name-change-application.html","title":"identify-object-name-change-application","text":"<pre><code>Identify an application that sends EVENT_OBJECT_NAMECHANGE on launch\n\nUsage: komorebic.exe identify-object-name-change-application &lt;IDENTIFIER&gt; &lt;ID&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/identify-tray-application.html","title":"identify-tray-application","text":"<pre><code>Identify an application that closes to the system tray\n\nUsage: komorebic.exe identify-tray-application &lt;IDENTIFIER&gt; &lt;ID&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/initial-named-workspace-rule.html","title":"initial-named-workspace-rule","text":"<pre><code>Add a rule to associate an application with a named workspace on first show\n\nUsage: komorebic.exe initial-named-workspace-rule &lt;IDENTIFIER&gt; &lt;ID&gt; &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\n  &lt;WORKSPACE&gt;\n          Name of a workspace\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/initial-workspace-rule.html","title":"initial-workspace-rule","text":"<pre><code>Add a rule to associate an application with a workspace on first show\n\nUsage: komorebic.exe initial-workspace-rule &lt;IDENTIFIER&gt; &lt;ID&gt; &lt;MONITOR&gt; &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/invisible-borders.html","title":"invisible-borders","text":"<pre><code>Set the invisible border dimensions around each window\n\nUsage: komorebic.exe invisible-borders &lt;LEFT&gt; &lt;TOP&gt; &lt;RIGHT&gt; &lt;BOTTOM&gt;\n\nArguments:\n  &lt;LEFT&gt;\n          Size of the left invisible border\n\n  &lt;TOP&gt;\n          Size of the top invisible border (usually 0)\n\n  &lt;RIGHT&gt;\n          Size of the right invisible border (usually left * 2)\n\n  &lt;BOTTOM&gt;\n          Size of the bottom invisible border (usually the same as left)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/load-custom-layout.html","title":"load-custom-layout","text":"<pre><code>Load a custom layout from file for the focused workspace\n\nUsage: komorebic.exe load-custom-layout &lt;PATH&gt;\n\nArguments:\n  &lt;PATH&gt;\n          JSON or YAML file from which the custom layout definition should be loaded\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/load-resize.html","title":"load-resize","text":"<pre><code>Load the resize layout dimensions from a file\n\nUsage: komorebic.exe load-resize &lt;PATH&gt;\n\nArguments:\n  &lt;PATH&gt;\n          File from which the resize layout dimensions should be loaded\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/log.html","title":"log","text":"<pre><code>Tail komorebi.exe's process logs (cancel with Ctrl-C)\n\nUsage: komorebic.exe log\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/manage-rule.html","title":"manage-rule","text":"<pre><code>Add a rule to always manage the specified application\n\nUsage: komorebic.exe manage-rule &lt;IDENTIFIER&gt; &lt;ID&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/manage.html","title":"manage","text":"<pre><code>Force komorebi to manage the focused window\n\nUsage: komorebic.exe manage\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/minimize.html","title":"minimize","text":"<pre><code>Minimize the focused window\n\nUsage: komorebic.exe minimize\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/monitor-index-preference.html","title":"monitor-index-preference","text":"<pre><code>Set the monitor index preference for a monitor identified using its size\n\nUsage: komorebic.exe monitor-index-preference &lt;INDEX_PREFERENCE&gt; &lt;LEFT&gt; &lt;TOP&gt; &lt;RIGHT&gt; &lt;BOTTOM&gt;\n\nArguments:\n  &lt;INDEX_PREFERENCE&gt;\n          Preferred monitor index (zero-indexed)\n\n  &lt;LEFT&gt;\n          Left value of the monitor's size Rect\n\n  &lt;TOP&gt;\n          Top value of the monitor's size Rect\n\n  &lt;RIGHT&gt;\n          Right value of the monitor's size Rect\n\n  &lt;BOTTOM&gt;\n          Bottom value of the monitor's size Rect\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/monitor-work-area-offset.html","title":"monitor-work-area-offset","text":"<pre><code>Set offsets for a monitor to exclude parts of the work area from tiling\n\nUsage: komorebic.exe monitor-work-area-offset &lt;MONITOR&gt; &lt;LEFT&gt; &lt;TOP&gt; &lt;RIGHT&gt; &lt;BOTTOM&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;LEFT&gt;\n          Size of the left work area offset (set right to left * 2 to maintain right padding)\n\n  &lt;TOP&gt;\n          Size of the top work area offset (set bottom to the same value to maintain bottom padding)\n\n  &lt;RIGHT&gt;\n          Size of the right work area offset\n\n  &lt;BOTTOM&gt;\n          Size of the bottom work area offset\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/mouse-follows-focus.html","title":"mouse-follows-focus","text":"<pre><code>Enable or disable mouse follows focus on all workspaces\n\nUsage: komorebic.exe mouse-follows-focus &lt;BOOLEAN_STATE&gt;\n\nArguments:\n  &lt;BOOLEAN_STATE&gt;\n          [possible values: enable, disable]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/move-to-monitor-workspace.html","title":"move-to-monitor-workspace","text":"<pre><code>Move the focused window to the specified monitor workspace\n\nUsage: komorebic.exe move-to-monitor-workspace &lt;TARGET_MONITOR&gt; &lt;TARGET_WORKSPACE&gt;\n\nArguments:\n  &lt;TARGET_MONITOR&gt;\n          Target monitor index (zero-indexed)\n\n  &lt;TARGET_WORKSPACE&gt;\n          Workspace index on the target monitor (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/move-to-monitor.html","title":"move-to-monitor","text":"<pre><code>Move the focused window to the specified monitor\n\nUsage: komorebic.exe move-to-monitor &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/move-to-named-workspace.html","title":"move-to-named-workspace","text":"<pre><code>Move the focused window to the specified workspace\n\nUsage: komorebic.exe move-to-named-workspace &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/move-to-workspace.html","title":"move-to-workspace","text":"<pre><code>Move the focused window to the specified workspace\n\nUsage: komorebic.exe move-to-workspace &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/move-workspace-to-monitor.html","title":"move-workspace-to-monitor","text":"<pre><code>Move the focused workspace to the specified monitor\n\nUsage: komorebic.exe move-workspace-to-monitor &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/move.html","title":"move","text":"<pre><code>Move the focused window in the specified direction\n\nUsage: komorebic.exe move &lt;OPERATION_DIRECTION&gt;\n\nArguments:\n  &lt;OPERATION_DIRECTION&gt;\n          [possible values: left, right, up, down]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-container-padding.html","title":"named-workspace-container-padding","text":"<pre><code>Set the container padding for the specified workspace\n\nUsage: komorebic.exe named-workspace-container-padding &lt;WORKSPACE&gt; &lt;SIZE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\n  &lt;SIZE&gt;\n          Pixels to pad with as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-custom-layout-rule.html","title":"named-workspace-custom-layout-rule","text":"<pre><code>Add a dynamic custom layout for the specified workspace\n\nUsage: komorebic.exe named-workspace-custom-layout-rule &lt;WORKSPACE&gt; &lt;AT_CONTAINER_COUNT&gt; &lt;PATH&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\n  &lt;AT_CONTAINER_COUNT&gt;\n          The number of window containers on-screen required to trigger this layout rule\n\n  &lt;PATH&gt;\n          JSON or YAML file from which the custom layout definition should be loaded\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-custom-layout.html","title":"named-workspace-custom-layout","text":"<pre><code>Set a custom layout for the specified workspace\n\nUsage: komorebic.exe named-workspace-custom-layout &lt;WORKSPACE&gt; &lt;PATH&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\n  &lt;PATH&gt;\n          JSON or YAML file from which the custom layout definition should be loaded\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-layout-rule.html","title":"named-workspace-layout-rule","text":"<pre><code>Add a dynamic layout rule for the specified workspace\n\nUsage: komorebic.exe named-workspace-layout-rule &lt;WORKSPACE&gt; &lt;AT_CONTAINER_COUNT&gt; &lt;LAYOUT&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\n  &lt;AT_CONTAINER_COUNT&gt;\n          The number of window containers on-screen required to trigger this layout rule\n\n  &lt;LAYOUT&gt;\n          [possible values: bsp, columns, rows, vertical-stack, horizontal-stack, ultrawide-vertical-stack, grid, right-main-vertical-stack]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-layout.html","title":"named-workspace-layout","text":"<pre><code>Set the layout for the specified workspace\n\nUsage: komorebic.exe named-workspace-layout &lt;WORKSPACE&gt; &lt;VALUE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\n  &lt;VALUE&gt;\n          [possible values: bsp, columns, rows, vertical-stack, horizontal-stack, ultrawide-vertical-stack, grid, right-main-vertical-stack]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-padding.html","title":"named-workspace-padding","text":"<pre><code>Set the workspace padding for the specified workspace\n\nUsage: komorebic.exe named-workspace-padding &lt;WORKSPACE&gt; &lt;SIZE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\n  &lt;SIZE&gt;\n          Pixels to pad with as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-rule.html","title":"named-workspace-rule","text":"<pre><code>Add a rule to associate an application with a named workspace\n\nUsage: komorebic.exe named-workspace-rule &lt;IDENTIFIER&gt; &lt;ID&gt; &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\n  &lt;WORKSPACE&gt;\n          Name of a workspace\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/named-workspace-tiling.html","title":"named-workspace-tiling","text":"<pre><code>Enable or disable window tiling for the specified workspace\n\nUsage: komorebic.exe named-workspace-tiling &lt;WORKSPACE&gt; &lt;VALUE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\n  &lt;VALUE&gt;\n          [possible values: enable, disable]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/new-workspace.html","title":"new-workspace","text":"<pre><code>Create and append a new workspace on the focused monitor\n\nUsage: komorebic.exe new-workspace\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/notification-schema.html","title":"notification-schema","text":"<pre><code>Generate a JSON Schema of subscription notifications\n\nUsage: komorebic.exe notification-schema\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/promote-focus.html","title":"promote-focus","text":"<pre><code>Promote the user focus to the top of the tree\n\nUsage: komorebic.exe promote-focus\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/promote-window.html","title":"promote-window","text":"<pre><code>Promote the window in the specified direction\n\nUsage: komorebic.exe promote-window &lt;OPERATION_DIRECTION&gt;\n\nArguments:\n  &lt;OPERATION_DIRECTION&gt;\n          [possible values: left, right, up, down]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/promote.html","title":"promote","text":"<pre><code>Promote the focused window to the top of the tree\n\nUsage: komorebic.exe promote\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/pwsh-app-specific-configuration.html","title":"pwsh-app-specific-configuration","text":"<pre><code>Generate common app-specific configurations and fixes in a PowerShell script\n\nUsage: komorebic.exe pwsh-app-specific-configuration &lt;PATH&gt; [OVERRIDE_PATH]\n\nArguments:\n  &lt;PATH&gt;\n          YAML file from which the application-specific configurations should be loaded\n\n  [OVERRIDE_PATH]\n          Optional YAML file of overrides to apply over the first file\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/query.html","title":"query","text":"<pre><code>Query the current window manager state\n\nUsage: komorebic.exe query &lt;STATE_QUERY&gt;\n\nArguments:\n  &lt;STATE_QUERY&gt;\n          [possible values: focused-monitor-index, focused-workspace-index, focused-container-index, focused-window-index]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/quick-load-resize.html","title":"quick-load-resize","text":"<pre><code>Load the last quicksaved resize layout dimensions\n\nUsage: komorebic.exe quick-load-resize\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/quick-save-resize.html","title":"quick-save-resize","text":"<pre><code>Quicksave the current resize layout dimensions\n\nUsage: komorebic.exe quick-save-resize\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/quickstart.html","title":"quickstart","text":"<pre><code>Gather example configurations for a new-user quickstart\n\nUsage: komorebic.exe quickstart\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/reload-configuration.html","title":"reload-configuration","text":"<pre><code>Reload ~/komorebi.ahk (if it exists)\n\nUsage: komorebic.exe reload-configuration\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/remove-title-bar.html","title":"remove-title-bar","text":"<pre><code>Whitelist an application for title bar removal\n\nUsage: komorebic.exe remove-title-bar &lt;IDENTIFIER&gt; &lt;ID&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/resize-axis.html","title":"resize-axis","text":"<pre><code>Resize the focused window or primary column along the specified axis\n\nUsage: komorebic.exe resize-axis &lt;AXIS&gt; &lt;SIZING&gt;\n\nArguments:\n  &lt;AXIS&gt;\n          [possible values: horizontal, vertical, horizontal-and-vertical]\n\n  &lt;SIZING&gt;\n          [possible values: increase, decrease]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/resize-delta.html","title":"resize-delta","text":"<pre><code>Set the resize delta (used by resize-edge and resize-axis)\n\nUsage: komorebic.exe resize-delta &lt;PIXELS&gt;\n\nArguments:\n  &lt;PIXELS&gt;\n          The delta of pixels by which to increase or decrease window dimensions when resizing\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/resize-edge.html","title":"resize-edge","text":"<pre><code>Resize the focused window in the specified direction\n\nUsage: komorebic.exe resize-edge &lt;EDGE&gt; &lt;SIZING&gt;\n\nArguments:\n  &lt;EDGE&gt;\n          [possible values: left, right, up, down]\n\n  &lt;SIZING&gt;\n          [possible values: increase, decrease]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/restore-windows.html","title":"restore-windows","text":"<pre><code>Restore all hidden windows (debugging command)\n\nUsage: komorebic.exe restore-windows\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/retile.html","title":"retile","text":"<pre><code>Force the retiling of all managed windows\n\nUsage: komorebic.exe retile\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/save-resize.html","title":"save-resize","text":"<pre><code>Save the current resize layout dimensions to a file\n\nUsage: komorebic.exe save-resize &lt;PATH&gt;\n\nArguments:\n  &lt;PATH&gt;\n          File to which the resize layout dimensions should be saved\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/send-to-monitor-workspace.html","title":"send-to-monitor-workspace","text":"<pre><code>Send the focused window to the specified monitor workspace\n\nUsage: komorebic.exe send-to-monitor-workspace &lt;TARGET_MONITOR&gt; &lt;TARGET_WORKSPACE&gt;\n\nArguments:\n  &lt;TARGET_MONITOR&gt;\n          Target monitor index (zero-indexed)\n\n  &lt;TARGET_WORKSPACE&gt;\n          Workspace index on the target monitor (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/send-to-monitor.html","title":"send-to-monitor","text":"<pre><code>Send the focused window to the specified monitor\n\nUsage: komorebic.exe send-to-monitor &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/send-to-named-workspace.html","title":"send-to-named-workspace","text":"<pre><code>Send the focused window to the specified workspace\n\nUsage: komorebic.exe send-to-named-workspace &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;WORKSPACE&gt;\n          Target workspace name\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/send-to-workspace.html","title":"send-to-workspace","text":"<pre><code>Send the focused window to the specified workspace\n\nUsage: komorebic.exe send-to-workspace &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/socket-schema.html","title":"socket-schema","text":"<pre><code>Generate a JSON Schema of socket messages\n\nUsage: komorebic.exe socket-schema\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/stack.html","title":"stack","text":"<pre><code>Stack the focused window in the specified direction\n\nUsage: komorebic.exe stack &lt;OPERATION_DIRECTION&gt;\n\nArguments:\n  &lt;OPERATION_DIRECTION&gt;\n          [possible values: left, right, up, down]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/start.html","title":"start","text":"<pre><code>Start komorebi.exe as a background process\n\nUsage: komorebic.exe start [OPTIONS]\n\nOptions:\n  -f, --ffm\n          Allow the use of komorebi's custom focus-follows-mouse implementation\n\n  -c, --config &lt;CONFIG&gt;\n          Path to a static configuration JSON file\n\n  -a, --await-configuration\n          Wait for 'komorebic complete-configuration' to be sent before processing events\n\n  -t, --tcp-port &lt;TCP_PORT&gt;\n          Start a TCP server on the given port to allow the direct sending of SocketMessages\n\n      --whkd\n          Start whkd in a background process\n\n      --ahk\n          Start autohotkey configuration file\n\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/state.html","title":"state","text":"<pre><code>Show a JSON representation of the current window manager state\n\nUsage: komorebic.exe state\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/static-config-schema.html","title":"static-config-schema","text":"<pre><code>Generate a JSON Schema of the static configuration file\n\nUsage: komorebic.exe static-config-schema\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/stop.html","title":"stop","text":"<pre><code>Stop the komorebi.exe process and restore all hidden windows\n\nUsage: komorebic.exe stop [OPTIONS]\n\nOptions:\n      --whkd\n          Stop whkd if it is running as a background process\n\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/subscribe-pipe.html","title":"subscribe-pipe","text":"<pre><code>Subscribe to komorebi events using a Named Pipe\n\nUsage: komorebic.exe subscribe-pipe &lt;NAMED_PIPE&gt;\n\nArguments:\n  &lt;NAMED_PIPE&gt;\n          Name of the pipe to send event notifications to (without \"\\\\.\\pipe\\\" prepended)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/subscribe-socket.html","title":"subscribe-socket","text":"<pre><code>Subscribe to komorebi events using a Unix Domain Socket\n\nUsage: komorebic.exe subscribe-socket &lt;SOCKET&gt;\n\nArguments:\n  &lt;SOCKET&gt;\n          Name of the socket to send event notifications to\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/swap-workspaces-with-monitor.html","title":"swap-workspaces-with-monitor","text":"<pre><code>Swap focused monitor workspaces with specified monitor\n\nUsage: komorebic.exe swap-workspaces-with-monitor &lt;TARGET&gt;\n\nArguments:\n  &lt;TARGET&gt;\n          Target index (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-cross-monitor-move-behaviour.html","title":"toggle-cross-monitor-move-behaviour","text":"<pre><code>Toggle the behaviour when moving windows across monitor boundaries\n\nUsage: komorebic.exe toggle-cross-monitor-move-behaviour\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-float.html","title":"toggle-float","text":"<pre><code>Toggle floating mode for the focused window\n\nUsage: komorebic.exe toggle-float\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-focus-follows-mouse.html","title":"toggle-focus-follows-mouse","text":"<pre><code>Toggle focus follows mouse for the operating system\n\nUsage: komorebic.exe toggle-focus-follows-mouse [OPTIONS]\n\nOptions:\n  -i, --implementation &lt;IMPLEMENTATION&gt;\n          [default: windows]\n\n          Possible values:\n          - komorebi: A custom FFM implementation (slightly more CPU-intensive)\n          - windows:  The native (legacy) Windows FFM implementation\n\n  -h, --help\n          Print help (see a summary with '-h')\n</code></pre>"},{"location":"cli/toggle-maximize.html","title":"toggle-maximize","text":"<pre><code>Toggle native maximization for the focused window\n\nUsage: komorebic.exe toggle-maximize\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-monocle.html","title":"toggle-monocle","text":"<pre><code>Toggle monocle mode for the focused container\n\nUsage: komorebic.exe toggle-monocle\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-mouse-follows-focus.html","title":"toggle-mouse-follows-focus","text":"<pre><code>Toggle mouse follows focus on all workspaces\n\nUsage: komorebic.exe toggle-mouse-follows-focus\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-pause.html","title":"toggle-pause","text":"<pre><code>Toggle window tiling on the focused workspace\n\nUsage: komorebic.exe toggle-pause\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-tiling.html","title":"toggle-tiling","text":"<pre><code>Toggle window tiling on the focused workspace\n\nUsage: komorebic.exe toggle-tiling\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-title-bars.html","title":"toggle-title-bars","text":"<pre><code>Toggle title bars for whitelisted applications\n\nUsage: komorebic.exe toggle-title-bars\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/toggle-window-container-behaviour.html","title":"toggle-window-container-behaviour","text":"<pre><code>Toggle the behaviour for new windows (stacking or dynamic tiling)\n\nUsage: komorebic.exe toggle-window-container-behaviour\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/unmanage.html","title":"unmanage","text":"<pre><code>Unmanage a window that was forcibly managed\n\nUsage: komorebic.exe unmanage\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/unmanaged-window-operation-behaviour.html","title":"unmanaged-window-operation-behaviour","text":"<pre><code>Set the operation behaviour when the focused window is not managed\n\nUsage: komorebic.exe unmanaged-window-operation-behaviour &lt;OPERATION_BEHAVIOUR&gt;\n\nArguments:\n  &lt;OPERATION_BEHAVIOUR&gt;\n          Possible values:\n          - op:    Process komorebic commands on temporarily unmanaged/floated windows\n          - no-op: Ignore komorebic commands on temporarily unmanaged/floated windows\n\nOptions:\n  -h, --help\n          Print help (see a summary with '-h')\n</code></pre>"},{"location":"cli/unstack.html","title":"unstack","text":"<pre><code>Unstack the focused window\n\nUsage: komorebic.exe unstack\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/unsubscribe-pipe.html","title":"unsubscribe-pipe","text":"<pre><code>Unsubscribe from komorebi events\n\nUsage: komorebic.exe unsubscribe-pipe &lt;NAMED_PIPE&gt;\n\nArguments:\n  &lt;NAMED_PIPE&gt;\n          Name of the pipe to stop sending event notifications to (without \"\\\\.\\pipe\\\" prepended)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/unsubscribe-socket.html","title":"unsubscribe-socket","text":"<pre><code>Unsubscribe from komorebi events\n\nUsage: komorebic.exe unsubscribe-socket &lt;SOCKET&gt;\n\nArguments:\n  &lt;SOCKET&gt;\n          Name of the socket to stop sending event notifications to\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/visible-windows.html","title":"visible-windows","text":"<pre><code>Show a JSON representation of visible windows\n\nUsage: komorebic.exe visible-windows\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/watch-configuration.html","title":"watch-configuration","text":"<pre><code>Enable or disable watching of ~/komorebi.ahk (if it exists)\n\nUsage: komorebic.exe watch-configuration &lt;BOOLEAN_STATE&gt;\n\nArguments:\n  &lt;BOOLEAN_STATE&gt;\n          [possible values: enable, disable]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/whkdrc.html","title":"whkdrc","text":"<pre><code>Show the path to whkdrc\n\nUsage: komorebic.exe whkdrc\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/window-hiding-behaviour.html","title":"window-hiding-behaviour","text":"<pre><code>Set the window behaviour when switching workspaces / cycling stacks\n\nUsage: komorebic.exe window-hiding-behaviour &lt;HIDING_BEHAVIOUR&gt;\n\nArguments:\n  &lt;HIDING_BEHAVIOUR&gt;\n          Possible values:\n          - hide:     Use the SW_HIDE flag to hide windows when switching workspaces (has issues with Electron apps)\n          - minimize: Use the SW_MINIMIZE flag to hide windows when switching workspaces (has issues with frequent workspace switching)\n          - cloak:    Use the undocumented SetCloak Win32 function to hide windows when switching workspaces (has foregrounding issues)\n\nOptions:\n  -h, --help\n          Print help (see a summary with '-h')\n</code></pre>"},{"location":"cli/workspace-custom-layout-rule.html","title":"workspace-custom-layout-rule","text":"<pre><code>Add a dynamic custom layout for the specified workspace\n\nUsage: komorebic.exe workspace-custom-layout-rule &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;AT_CONTAINER_COUNT&gt; &lt;PATH&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;AT_CONTAINER_COUNT&gt;\n          The number of window containers on-screen required to trigger this layout rule\n\n  &lt;PATH&gt;\n          JSON or YAML file from which the custom layout definition should be loaded\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/workspace-custom-layout.html","title":"workspace-custom-layout","text":"<pre><code>Set a custom layout for the specified workspace\n\nUsage: komorebic.exe workspace-custom-layout &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;PATH&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;PATH&gt;\n          JSON or YAML file from which the custom layout definition should be loaded\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/workspace-layout-rule.html","title":"workspace-layout-rule","text":"<pre><code>Add a dynamic layout rule for the specified workspace\n\nUsage: komorebic.exe workspace-layout-rule &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;AT_CONTAINER_COUNT&gt; &lt;LAYOUT&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;AT_CONTAINER_COUNT&gt;\n          The number of window containers on-screen required to trigger this layout rule\n\n  &lt;LAYOUT&gt;\n          [possible values: bsp, columns, rows, vertical-stack, horizontal-stack, ultrawide-vertical-stack, grid, right-main-vertical-stack]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/workspace-layout.html","title":"workspace-layout","text":"<pre><code>Set the layout for the specified workspace\n\nUsage: komorebic.exe workspace-layout &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;VALUE&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;VALUE&gt;\n          [possible values: bsp, columns, rows, vertical-stack, horizontal-stack, ultrawide-vertical-stack, grid, right-main-vertical-stack]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/workspace-name.html","title":"workspace-name","text":"<pre><code>Set the workspace name for the specified workspace\n\nUsage: komorebic.exe workspace-name &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;VALUE&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;VALUE&gt;\n          Name of the workspace as a String\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/workspace-padding.html","title":"workspace-padding","text":"<pre><code>Set the workspace padding for the specified workspace\n\nUsage: komorebic.exe workspace-padding &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;SIZE&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;SIZE&gt;\n          Pixels to pad with as an integer\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/workspace-rule.html","title":"workspace-rule","text":"<pre><code>Add a rule to associate an application with a workspace\n\nUsage: komorebic.exe workspace-rule &lt;IDENTIFIER&gt; &lt;ID&gt; &lt;MONITOR&gt; &lt;WORKSPACE&gt;\n\nArguments:\n  &lt;IDENTIFIER&gt;\n          [possible values: exe, class, title, path]\n\n  &lt;ID&gt;\n          Identifier as a string\n\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"cli/workspace-tiling.html","title":"workspace-tiling","text":"<pre><code>Enable or disable window tiling for the specified workspace\n\nUsage: komorebic.exe workspace-tiling &lt;MONITOR&gt; &lt;WORKSPACE&gt; &lt;VALUE&gt;\n\nArguments:\n  &lt;MONITOR&gt;\n          Monitor index (zero-indexed)\n\n  &lt;WORKSPACE&gt;\n          Workspace index on the specified monitor (zero-indexed)\n\n  &lt;VALUE&gt;\n          [possible values: enable, disable]\n\nOptions:\n  -h, --help\n          Print help\n</code></pre>"},{"location":"common-workflows/autohotkey.html","title":"AutoHotkey","text":"<p>If you would like to use Autohotkey, please make sure you have AutoHotKey v2 installed.</p> <p>Generally, users who opt for AHK will have specific needs that can only be addressed by the advanced functionality of AHK, and so they are assumed to be able to craft their own configuration files.</p> <p>If you would like to try out AHK, here is a simple sample configuration which largely matches the <code>whkdrc</code> sample configuration.</p> <pre><code>#Requires AutoHotkey v2.0.2\n#SingleInstance Force\n\nKomorebic(cmd) {\n    RunWait(format(\"komorebic.exe {}\", cmd), , \"Hide\")\n}\n\n!q::Komorebic(\"close\")\n!m::Komorebic(\"minimize\")\n\n; Focus windows\n!h::Komorebic(\"focus left\")\n!j::Komorebic(\"focus down\")\n!k::Komorebic(\"focus up\")\n!l::Komorebic(\"focus right\")\n\n!+[::Komorebic(\"cycle-focus previous\")\n!+]::Komorebic(\"cycle-focus next\")\n\n; Move windows\n!+h::Komorebic(\"move left\")\n!+j::Komorebic(\"move down\")\n!+k::Komorebic(\"move up\")\n!+l::Komorebic(\"move right\")\n\n; Stack windows\n!Left::Komorebic(\"stack left\")\n!Down::Komorebic(\"stack down\")\n!Up::Komorebic(\"stack up\")\n!Right::Komorebic(\"stack right\")\n!;::Komorebic(\"unstack\")\n![::Komorebic(\"cycle-stack previous\")\n!]::Komorebic(\"cycle-stack next\")\n\n; Resize\n!=::Komorebic(\"resize-axis horizontal increase\")\n!-::Komorebic(\"resize-axis horizontal decrease\")\n!+=::Komorebic(\"resize-axis vertical increase\")\n!+_::Komorebic(\"resize-axis vertical decrease\")\n\n; Manipulate windows\n!t::Komorebic(\"toggle-float\")\n!f::Komorebic(\"toggle-monocle\")\n\n; Window manager options\n!+r::Komorebic(\"retile\")\n!p::Komorebic(\"toggle-pause\")\n\n; Layouts\n!x::Komorebic(\"flip-layout horizontal\")\n!y::Komorebic(\"flip-layout vertical\")\n\n; Workspaces\n!1::Komorebic(\"focus-workspace 0\")\n!2::Komorebic(\"focus-workspace 1\")\n!3::Komorebic(\"focus-workspace 2\")\n!4::Komorebic(\"focus-workspace 3\")\n!5::Komorebic(\"focus-workspace 4\")\n!6::Komorebic(\"focus-workspace 5\")\n!7::Komorebic(\"focus-workspace 6\")\n!8::Komorebic(\"focus-workspace 7\")\n\n; Move windows across workspaces\n!+1::Komorebic(\"move-to-workspace 0\")\n!+2::Komorebic(\"move-to-workspace 1\")\n!+3::Komorebic(\"move-to-workspace 2\")\n!+4::Komorebic(\"move-to-workspace 3\")\n!+5::Komorebic(\"move-to-workspace 4\")\n!+6::Komorebic(\"move-to-workspace 5\")\n!+7::Komorebic(\"move-to-workspace 6\")\n!+8::Komorebic(\"move-to-workspace 7\")\n</code></pre> <p>By default, the <code>komorebi.ahk</code> file should be located in the <code>$Env:USERPROFILE</code> directory, however, if <code>$Env:KOMOREBI_CONFIG_HOME</code> is set, it should be located there.</p> <p>Once the file is in place, you can stop komorebi and whkd by running <code>komorebic stop --whkd</code>, and then start komorebi with Autohotkey by running <code>komorebic start --ahk</code>.</p>"},{"location":"common-workflows/borders.html","title":"Borders","text":"<p>If you would like to add a visual border around both the currently focused window and unfocused windows ensure the following options are defined in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"border\": true,\n\"border_width\": 8,\n\"border_offset\": -1,\n\"border_style\": \"System\",\n\"border_colours\": {\n\"single\": \"#42a5f5\",\n\"stack\": \"#00a542\",\n\"monocle\": \"#ff3399\",\n\"unfocused\": \"#808080\"\n}\n}\n</code></pre> <p>It is important to note that borders will only apply to windows managed by <code>komorebi</code>.</p> <p>This feature is not considered stable, and you may encounter visual artifacts from time to time.</p> <p></p>"},{"location":"common-workflows/custom-layouts.html","title":"Custom Layouts","text":"<p>Particularly for users of ultrawide monitors, traditional tiling layouts may not seem like the most efficient use of screen space. If you feel this is the case with any of the default layouts, you are also welcome to create your own custom layouts and save them as JSON or YAML.</p> <p>If you're not comfortable writing the layouts directly in JSON or YAML, you can use the komorebi Custom Layout Generator to interactively define a custom layout, and then copy the generated JSON content.</p> <p>Custom layouts can be loaded on the current workspace or configured for a specific workspace in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"monitors\": [\n{\n\"workspaces\": [\n{\n\"name\": \"personal\",\n\"custom_layout\": \"C:/Users/LGUG2Z/my-custom-layout.json\"\n},\n]\n}\n]\n}\n</code></pre> <p>The fundamental building block of a custom komorebi layout is the Column.</p> <p>Columns come in three variants:</p> <ul> <li>Primary: This is where your primary focus will be on the screen most of   the time. There must be exactly one Primary Column in any custom layout.   Optionally, you can specify the percentage of the screen width that you want   the Primary Column to occupy.</li> <li>Secondary: This is an optional column that can either be full height of   split horizontally into a fixed number of maximum rows. There can be any   number of Secondary Columns in a custom layout.</li> <li>Tertiary: This is the final column where any remaining windows will be   split horizontally into rows as they get added.</li> </ul> <p>If there is only one window on the screen when a custom layout is selected, that window will take up the full work area of the screen.</p> <p>If the number of windows is equal to or less than the total number of columns defined in a custom layout, the windows will be arranged in an equal-width columns.</p> <p>When the number of windows is greater than the number of columns defined in the custom layout, the windows will begin to be arranged according to the constraints set on the Primary and Secondary columns of the layout.</p> <p>Here is an example custom layout that can be used as a starting point for your own:</p> <pre><code>- column: Secondary\nconfiguration: !Horizontal 2 # max number of rows\n- column: Primary\nconfiguration: !WidthPercentage 50 # percentage of screen\n- column: Tertiary\nconfiguration: Horizontal\n</code></pre> <p></p>"},{"location":"common-workflows/dynamic-layout-switching.html","title":"Dynamic Layout Switching","text":"<p>With <code>komorebi</code> it is possible to define rules to automatically change the layout on a specified workspace when a threshold of window containers is met.</p> <pre><code>{\n\"monitors\": [\n{\n\"workspaces\": [\n{\n\"name\": \"personal\",\n\"layout_rules\": {\n\"1\": \"BSP\"\n}\n\"custom_layout_rules\": {\n\"5\": \"C:/Users/LGUG2Z/my-custom-layout.json\"\n}\n},\n]\n}\n]\n}\n</code></pre> <p>In this example, when there are one or more window containers visible on the screen, the BSP layout is used, and when there are five or more window containers visible, a custom layout is used.</p> <p>However, if you add workspace layout rules, you will not be able to manually change the layout of a workspace until all layout rules for that workspace have been cleared.</p> <pre><code># for example, to clear rules from monitor 0, workspace 0\nkomorebic clear-workspace-layout-rules 0 0\n</code></pre>"},{"location":"common-workflows/focus-follows-mouse.html","title":"Focus Follows Mouse","text":"<p><code>komorebi</code> supports two focus-follows-mouse implementations; the native Windows Xmouse implementation, which treats the desktop, the task bar, and the system tray as windows and switches focus to them eagerly, and a custom <code>komorebi</code> implementation, which only considers windows managed by <code>komorebi</code> as valid targets to switch focus to when moving the mouse.</p> <p>To enable the <code>komorebi</code> implementation you must start the process with the <code>--ffm</code> flag to explicitly enable the feature. This is because the mouse tracking required for this feature significantly increases the CPU usage of the process (on my machine, it jumps from &lt;1% to ~4~), and this CPU increase persists regardless of whether focus-follows-mouse is enabled or disabled at any given time via <code>komorebic</code>'s configuration commands.</p> <p>If the <code>komorebi</code> process has been started with the <code>--ffm</code> flag, you can enable focus follows mouse behaviour in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"focus_follows_mouse\": \"Komorebi\"\n}\n</code></pre> <p>When calling any of the <code>komorebic</code> commands related to focus-follows-mouse functionality, the <code>windows</code> implementation will be chosen as the default implementation. You can optionally specify the <code>komorebi</code> implementation by passing it as an argument to the <code>--implementation</code> flag:</p> <pre><code>komorebic.exe toggle-focus-follows-mouse --implementation komorebi\n</code></pre>"},{"location":"common-workflows/force-manage-windows.html","title":"Force Manage Windows","text":"<p>\u2757\ufe0fNOTE: A significant number of force-manage window rules for the most common applications are already generated for you</p> <p>In some rare cases, a window may not automatically be registered to be managed by <code>komorebi</code>. You can add rules to enforce this behaviour in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"manage_rules\": [\n{\n\"kind\": \"Title\",\n\"id\": \"Media Player\",\n\"matching_strategy\": \"Equals\"\n}\n]\n}\n</code></pre>"},{"location":"common-workflows/ignore-windows.html","title":"Ignore Windows","text":"<p>\u2757\ufe0fNOTE: A significant number of ignored window rules for the most common applications are already generated for you</p> <p>Sometimes you will want a specific application to never be tiled, and instead float all the time. You can add rules to enforce this behaviour in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"float_rules\": [\n{\n\"kind\": \"Title\",\n\"id\": \"Media Player\",\n\"matching_strategy\": \"Equals\"\n}\n]\n}\n</code></pre>"},{"location":"common-workflows/komorebi-config-home.html","title":"<code>KOMOREBI_CONFIG_HOME</code>","text":"<p>If you do not want to keep komorebi-related files in your <code>$Env:USERPROFILE</code> directory, you can specify a custom directory by setting the <code>$Env:KOMOREBI_CONFIG_HOME</code> environment variable.</p> <p>For example, to use the <code>~/.config/komorebi</code> directory:</p> <pre><code># Run this command to make sure that the directory has been created\nmkdir -p ~/.config/komorebi\n\n# Run this command to open up your PowerShell profile configuration in Notepad\nnotepad $PROFILE\n\n# Add this line (with your login user!) to the bottom of your PowerShell profile configuration\n$Env:KOMOREBI_CONFIG_HOME = 'C:\\Users\\LGUG2Z\\.config\\komorebi'\n\n# Save the changes and then reload the PowerShell profile\n. $PROFILE\n</code></pre> <p>If you already have configuration files that you wish to keep, move them to the <code>~/.config/komorebi</code> directory.</p> <p>The next time you run <code>komorebic start</code>, any files created by or loaded by komorebi will be placed or expected to exist in this folder.</p> <p></p>"},{"location":"common-workflows/mouse-follows-focus.html","title":"Mouse Follows Focus","text":"<p>By default, the mouse will move to the center of the window when the focus is changed in a given direction. This behaviour is know as 'mouse follows focus'. This behaviour can be disabled in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"mouse_follows_focus\": false,\n}\n</code></pre> <p></p>"},{"location":"common-workflows/remove-gaps.html","title":"Remove Gaps","text":"<p>If you would like to remove all gaps by default, both between windows themselves, and between the monitor edges and the windows, you can set the following configuration options to <code>0</code> and <code>-1</code> in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"default_workspace_padding\": 0,\n\"default_container_padding\": 0,\n\"border_width\": 0,\n\"border_offset\": -1\n}\n</code></pre> <p>A restart of <code>komorebi</code> is required after changing these settings.</p> <p></p>"},{"location":"common-workflows/stackbar.html","title":"Stackbar","text":"<p>If you would like to add a visual stackbar to show which windows are in a container stack ensure the following options are defined in the <code>komorebi.json</code> configuration file.</p> <pre><code>{\n\"stackbar\": {\n\"height\": 40,\n\"mode\": \"OnStack\",\n\"tabs\": {\n\"width\": 300,\n\"focused_text\": \"#00a542\",\n\"unfocused_text\": \"#b3b3b3\",\n\"background\": \"#141414\"\n}\n}\n}\n</code></pre> <p>This feature is not considered stable, and you may encounter visual artifacts from time to time.</p>"},{"location":"common-workflows/tray-and-multi-window-applications.html","title":"Tray and Multi-Window Applications","text":"<p>\u2757\ufe0fNOTE: A significant number of tray and multi-window application rules for the most common applications are already generated for you</p> <p>If you are experiencing behaviour where closing a window leaves a blank tile, but minimizing the same window does not, you have probably enabled a 'close/minimize to tray' option for that application. You can tell <code>komorebi</code> to handle this application appropriately by identifying it via the executable name or the window class.</p> <pre><code>{\n\"tray_and_multi_window_applications\": [\n{\n\"kind\": \"Class\",\n\"id\": \"SDL_app\",\n\"matching_strategy\": \"Equals\"\n}\n]\n}\n</code></pre>"},{"location":"release/v0-1-22.html","title":"v0.1.22","text":"<p>In addition to the changelog of new features and fixes, please note the following changes from <code>v0.1.21</code> to adjust your configuration files accordingly.</p>"},{"location":"release/v0-1-22.html#tldr","title":"tl;dr","text":"<p>The way windows are sized and drawn has been improved to remove the need to manually specify and remove invisible borders for applications that overflow them. If you use the active window border, the first time you launch <code>v0.1.22</code> you may end up with a huge border due to these changes.</p> <p><code>active_window_border_width</code> and <code>active_window_border_offset</code> have been renamed to <code>border_width</code> and <code>border_offset</code> as they now also apply outside the context of the active window border.</p> <pre><code>{\n\"active_window_border\": true,\n\"border_width\": 8,\n\"border_offset\": -1\n}\n</code></pre> <p>Users of the active window border should start from these settings and read the notes below before making further adjustments.</p>"},{"location":"release/v0-1-22.html#changes-to-active_window_border-and-window-sizing","title":"Changes to <code>active_window_border</code>, and window sizing:","text":"<ul> <li>The border no longer creates a second drop-shadow around the active window</li> <li>Windows are now sized to fill the layout region entirely, ignoring window decorations such as drop shadows</li> <li>Border offset now starts exactly at the paint edge of the window on all sides</li> <li>Windows are sized such that the border offset and border width are taken into account</li> </ul>"},{"location":"release/v0-1-22.html#recommended-patterns","title":"Recommended patterns","text":""},{"location":"release/v0-1-22.html#gapless","title":"Gapless","text":"<ul> <li>Disable \"transparency effects\" Personalization &gt; Colors</li> <li>Set the following settings in <code>komorebi.json</code>: <pre><code>{\n\"default_workspace_padding\": 0,\n\"default_container_padding\": 0,\n\"border_offset\": -1,\n\"border_width\": 0\n}\n</code></pre></li> </ul>"},{"location":"release/v0-1-22.html#1px-border","title":"1px border","text":"<p>A 1px border is drawn around the window edge. Users may see a gap for a single pixel, if the system theme has a transparent edge - this is the windows themed edge, and is not present for all applications.</p> <pre><code>  {\n\"border_offset\": 0,\n\"border_width\": 1\n}\n</code></pre>"}]}
\ No newline at end of file
diff --git a/troubleshooting.html b/troubleshooting.html
index 7302b7f7..881c3207 100644
--- a/troubleshooting.html
+++ b/troubleshooting.html
@@ -1007,7 +1007,7 @@
         
   
   <span class="md-ellipsis">
-    V0 1 22
+    v0.1.22
   </span>