aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorhaansn08 <stefan@kikeriki.at>2025-10-20 05:53:03 +0000
committerGitHub <noreply@github.com>2025-10-20 08:53:03 +0300
commit31eb943599fbc1efc8c46011bb39b0f96f79f535 (patch)
treedec9877bc4c7411e3ffa122850d37abb645582a5 /docs
parent137b87bbe57662e88518eb8a0033b548a0313f33 (diff)
downloadniri-31eb943599fbc1efc8c46011bb39b0f96f79f535.tar.gz
niri-31eb943599fbc1efc8c46011bb39b0f96f79f535.tar.bz2
niri-31eb943599fbc1efc8c46011bb39b0f96f79f535.zip
docs: describe screen mirroring with wl-mirror (#2633)
* docs: describe screen mirroring with wl-mirror * docs: apply wording suggestions for wl-mirror section * Update docs/wiki/Screencasting.md * Update docs/wiki/Screencasting.md --------- Co-authored-by: Ivan Molodetskikh <yalterz@gmail.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/wiki/Screencasting.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/docs/wiki/Screencasting.md b/docs/wiki/Screencasting.md
index 76a08b45..3c38a01b 100644
--- a/docs/wiki/Screencasting.md
+++ b/docs/wiki/Screencasting.md
@@ -137,4 +137,17 @@ Here's an example showing a windowed-fullscreen Google Slides [presentation](htt
![Windowed Google Slides presentation, another window showing the presenter view, and another window showing Zoom UI casting the presentation.](https://github.com/user-attachments/assets/b2b49eea-f5a0-4c0a-b537-51fd1949a59d)
+### Screen mirroring
+
+For presentations it can be useful to mirror an output to another.
+Currently, niri doesn't have built-in output mirroring, but you can use a third-party tool [`wl-mirror`](https://github.com/Ferdi265/wl-mirror) that mirrors an output to a window.
+Note that the command below requires [`jq`](https://jqlang.org/download/) to be installed.
+```kdl
+binds {
+ Mod+P repeat=false { spawn-sh "wl-mirror $(niri msg --json focused-output | jq -r .name)"; }
+}
+```
+Focus the output you want to mirror, press <kbd>Mod</kbd><kbd>P</kbd> and move the `wl-mirror` window to the target output.
+Finally, fullscreen the `wl-mirror` window (by default, <kbd>Mod</kbd><kbd>Shift</kbd><kbd>F</kbd>).
+
[OBS]: https://obsproject.com/