Niri Display Settings

May 29, 2026 ยท View on GitHub

Quickly manage, toggle, and configure display outputs in the Niri Wayland compositor.

Screenshot

Install

Use the DMS CLI:

dms plugins install niriDS

Or manually:

git clone https://github.com/hthienloc/dms-niri-display-settings ~/.config/DankMaterialShell/plugins/niriDS

Features

  • Display profiles: Internal Only, External Only, Extend, Mirror
  • Manual toggle for each display
  • Auto-show or auto-apply profile when monitor plugged in
  • Auto-enable laptop screen when external monitors disconnected

IPC Commands

Use dms ipc call niriDS <command> to control the display selector.

CommandDescription
openOpen the display settings modal
closeClose the display settings modal
toggleToggle the display settings modal
apply <profile>Apply a profile: internal_only, external_only, extend, mirror

Keybinding example (Niri)

binds {
    Mod+P { spawn "dms" "ipc" "call" "niriDS" "toggle"; }
}

Requirements

  • DankMaterialShell >= 1.5
  • Niri Wayland compositor
  • wl-mirror

License

MIT