aboutsummaryrefslogtreecommitdiff
path: root/wiki/Configuration:-Key-Bindings.md
diff options
context:
space:
mode:
authorToby Bridle <foreignspaghettibolognese@gmail.com>2025-03-09 20:55:30 +0000
committerIvan Molodetskikh <yalterz@gmail.com>2025-03-10 22:31:50 -0700
commit47dd338340e2c8c17ce210579bcdcf8f320d755e (patch)
tree2f0707130f1d9d3b5b2066189d69206c9238be5a /wiki/Configuration:-Key-Bindings.md
parent87b6c1262544a463703a34d8404ef339b7d18536 (diff)
downloadniri-47dd338340e2c8c17ce210579bcdcf8f320d755e.tar.gz
niri-47dd338340e2c8c17ce210579bcdcf8f320d755e.tar.bz2
niri-47dd338340e2c8c17ce210579bcdcf8f320d755e.zip
feat: 🎉 add `show-pointer` for `Screenshot` and `ScreenshotScreen`
Diffstat (limited to 'wiki/Configuration:-Key-Bindings.md')
-rw-r--r--wiki/Configuration:-Key-Bindings.md23
1 files changed, 21 insertions, 2 deletions
diff --git a/wiki/Configuration:-Key-Bindings.md b/wiki/Configuration:-Key-Bindings.md
index 24efa839..640f6fd4 100644
--- a/wiki/Configuration:-Key-Bindings.md
+++ b/wiki/Configuration:-Key-Bindings.md
@@ -306,9 +306,13 @@ binds {
}
```
-#### `screenshot-screen`, `screenshot-window`
+#### `screenshot`, `screenshot-screen`, `screenshot-window`
+
+Actions for taking screenshots.
+
+- `screenshot`: opens the built-in interactive screenshot UI.
+- `screenshot-screen`, `screenshow-window`: takes a screenshot of the focused screen or window respectively.
-Take a screenshot of the focused screen or window respectively.
The screenshot is both stored to the clipboard and saved to disk, according to the [`screenshot-path` option](./Configuration:-Miscellaneous.md).
<sup>Since: 25.02</sup> You can disable saving to disk for a specific bind with the `write-to-disk=false` property:
@@ -320,6 +324,21 @@ binds {
}
```
+In the interactive screenshot UI, pressing <kbd>Ctrl</kbd><kbd>C</kbd> will copy the screenshot to the clipboard without writing it to disk.
+
+<sup>Since: next release</sup> You can hide the mouse pointer in screenshots with the `show-pointer=false` property:
+
+```kdl
+binds {
+ // The pointer will be hidden by default
+ // (you can still show it by pressing P).
+ Print { screenshot show-pointer=false; }
+
+ // The pointer will be hidden on the screenshot.
+ Ctrl+Print { screenshot-screen show-pointer=false; }
+}
+```
+
#### `toggle-keyboard-shortcuts-inhibit`
<sup>Since: 25.02</sup>