DMS-NiriDisplaySettings
August 6, 2026 · View on GitHub
DMS-Niri_Display_Settings
Advanced Display & Output Management for Niri Wayland Compositor
Quickly toggle, manage, and configure display outputs, profiles, and arrangements directly in the Dank Material Shell for Niri.
Requirements
- Dank Material Shell (DMS) environment installed and active (
>= 1.5). - Niri Wayland Compositor running as your desktop window manager.
wl-mirrorutility for display mirroring features.
Download
# Install via DMS CLI
dms plugins install niriDSA
Features
- Display Profiles: Quick profile switching for Internal Only, External Only, Extend, and Mirror.
- Hotplug Management: Auto-show settings modal or auto-apply profiles when external monitors are connected or disconnected.
- Laptop Screen Protection: Automatically enables laptop display when external screens are unplugged.
- Material UI Aesthetics: Seamless glassmorphic modal and control center widget tailored for Dank Material Shell.
- IPC Remote Control: Full IPC support to bind keys directly in
niriconfig.
Interface
Configuration
Keybindings & IPC
Use dms ipc call niriDSA <command> to control display profiles and modals directly.
| Command | Description |
|---|---|
open | Open the display settings modal |
close | Close the display settings modal |
toggle | Toggle the display settings modal |
apply <profile> | Apply a profile: internal_only, external_only, extend, mirror |
Niri Keybinding Example (config.kdl)
binds {
Mod+P { spawn "dms" "ipc" "call" "niriDSA" "toggle"; }
}
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Before reporting a new issue, take a look at the changelog and the already opened issues.
Credits
Built with ❤️ for the Dank Material Shell community.
Disclaimer
This plugin is part of the Dank Material Shell suite for display management in Niri.
📜 License
Part of DankMaterialShell. Check the main repository for license information.