From 87dc96fa69738b5d57562a0a556efa7def138539 Mon Sep 17 00:00:00 2001 From: Trevor Campbell Date: Sun, 12 Oct 2025 17:29:51 +1100 Subject: Add topic regarding managing external displays using Kanshi to FAQ --- docs/wiki/FAQ.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/wiki/FAQ.md b/docs/wiki/FAQ.md index e8235566..3dd61867 100644 --- a/docs/wiki/FAQ.md +++ b/docs/wiki/FAQ.md @@ -124,3 +124,21 @@ binds { Super+Alt+L allow-when-locked=true { spawn "swaylock"; } } ``` + +### How do I change output configuration based on connected monitors? + +If you require different output configurations depending on what outputs are connected then you can use [Kanshi](https://gitlab.freedesktop.org/emersion/kanshi). + +Kanshi has its own simple configuration and communicates with niri via IPC. You may want to launch kanshi from the niri config.kdl e.g. `spawn-at-startup "/usr/bin/kanshi"` + +For example, if you wish to scale your laptop display differently when an external monitor is connected, you might use a Kanshi config like this: +``` +profile { + output eDP-1 enable scale 1.0 +} + +profile { + output HDMI-A-1 enable scale 1.0 position 0,0 + output eDP-1 enable scale 1.25 position 1920,0 +} +``` -- cgit