aboutsummaryrefslogtreecommitdiff
path: root/docs/wiki
diff options
context:
space:
mode:
authorKai Koehler <45439844+Fireye04@users.noreply.github.com>2025-09-16 08:10:01 -0700
committerGitHub <noreply@github.com>2025-09-16 15:10:01 +0000
commit08f5c6fecb3c5c81d63a0bf7248c85ae3299a4a5 (patch)
tree4fec3ec4899a723f153ffa2d7e790bd0ead14996 /docs/wiki
parentbffc5c137757b0b006391fa0e9fe996d3d044abd (diff)
downloadniri-08f5c6fecb3c5c81d63a0bf7248c85ae3299a4a5.tar.gz
niri-08f5c6fecb3c5c81d63a0bf7248c85ae3299a4a5.tar.bz2
niri-08f5c6fecb3c5c81d63a0bf7248c85ae3299a4a5.zip
Make hot corners configurable, including per-output (#2108)
* Add corner selection in config * Add hot corner docs * Working per-monitor hot corners Handle defaults * run cargo fmt --all * Fix hot corners in is_sticky_obscured_under * Change default to fall back to gesture hot corners if output hot corners are unset * Add hot corner output config docs * Support fractional scaling * Trigger hot corners over widgets * Improve float handling Fixed YaLTeR/niri/pull/2108 * Refactor * Bug Fixes * Amend docs Fix styling Co-authored-by: Ivan Molodetskikh <yalterz@gmail.com> * Integrate code review Move is_inside_hot_corner * fixes --------- Co-authored-by: Aadniz <8147434+Aadniz@users.noreply.github.com> Co-authored-by: Ivan Molodetskikh <yalterz@gmail.com>
Diffstat (limited to 'docs/wiki')
-rw-r--r--docs/wiki/Configuration:-Gestures.md19
-rw-r--r--docs/wiki/Configuration:-Outputs.md36
2 files changed, 55 insertions, 0 deletions
diff --git a/docs/wiki/Configuration:-Gestures.md b/docs/wiki/Configuration:-Gestures.md
index bdb7a407..ee8d108e 100644
--- a/docs/wiki/Configuration:-Gestures.md
+++ b/docs/wiki/Configuration:-Gestures.md
@@ -23,6 +23,10 @@ gestures {
hot-corners {
// off
+ top-left
+ // top-right
+ // bottom-left
+ // bottom-right
}
}
```
@@ -94,3 +98,18 @@ gestures {
}
}
```
+
+<sup>Since: next release</sup> You can choose specific hot corners by name: `top-left`, `top-right`, `bottom-left`, `bottom-right`.
+If no corners are explicitly set, the top-left corner will be active by default.
+
+```kdl
+// Enable the top-right and bottom-right hot corners.
+gestures {
+ hot-corners {
+ top-right
+ bottom-right
+ }
+}
+```
+
+You can also customize hot corners per-output [in the output config](./Configuration:-Outputs.md#hot-corners).
diff --git a/docs/wiki/Configuration:-Outputs.md b/docs/wiki/Configuration:-Outputs.md
index 0db7956d..a84a068f 100644
--- a/docs/wiki/Configuration:-Outputs.md
+++ b/docs/wiki/Configuration:-Outputs.md
@@ -16,6 +16,14 @@ output "eDP-1" {
focus-at-startup
background-color "#003300"
backdrop-color "#001100"
+
+ hot-corners {
+ // off
+ top-left
+ // top-right
+ // bottom-left
+ // bottom-right
+ }
}
output "HDMI-A-1" {
@@ -217,3 +225,31 @@ output "HDMI-A-1" {
backdrop-color "#001100"
}
```
+
+### `hot-corners`
+
+<sup>Since: next release</sup>
+
+Customize the hot corners for this output.
+By default, hot corners [in the gestures settings](./Configuration:-Gestures.md#hot-corners) are used for all outputs.
+
+Hot corners toggle the overview when you put your mouse at the very corner of a monitor.
+
+`off` will disable the hot corners on this output, and writing specific corners will enable only those hot corners on this output.
+
+```kdl
+// Enable the bottom-left and bottom-right hot corners on HDMI-A-1.
+output "HDMI-A-1" {
+ hot-corners {
+ bottom-left
+ bottom-right
+ }
+}
+
+// Disable the hot corners on DP-2.
+output "DP-2" {
+ hot-corners {
+ off
+ }
+}
+```