A Hyprland DankMaterialShell plugin that allows you to manage your display outputs (Single Display, Mirror, Extend).
Credit & Acknowledgement: This project is a modified fork of the Display Settings plugin originally created by Lucyfire.
- Smart Auto-Fallback: Seamlessly listens to Hyprland's hardware events in the background. If a monitor or projector is unplugged, it automatically detects the change and switches to the remaining active screen to prevent getting stuck on a black/disabled display. Perfect for laptops and multi-monitor setups!
- Quick Display Modes: Easily switch between Single Display, Duplicate/Mirror, and Extend modes.
- Registers 3 new ipc calls to dms:
dms ipc call displayOutput toggledms ipc call displayOutput opendms ipc call displayOutput closeYou can easily install this plugin directly using the DMS plugin manager:
dms plugins install displayOutputThen, enable the plugin in the DMS plugins tab, then run the following command to display the menu:
dms ipc call displayOutput toggleSince this is a standalone plugin, you can install it by cloning this repository directly into your DMS plugins folder.
Clone this repository:
git clone https://github.com/xyzsteven/dms-displayoutput.gitCopy the contents to the DMS plugins directory as displayOutput:
cp -r dms-displayoutput ~/.config/DankMaterialShell/plugins/displayOutputYou can now delete the cloned repo if you want:
rm -rf dms-displayoutputEnable the plugin in the DMS plugins tab, then run the following command to display the menu:
dms ipc call displayOutput toggleNone at the moment.
- DankMaterialShell >= 1.4.3
- Hyprland
- a monitorv2 definition in your hyprland.conf file.
socat- Required for the background socket watcher to listen to Hyprland events dynamically. Make sure it is installed on your system.
- Compositors: Hyprland
- Distros: Universal - works on any Linux distribution
Honestly, this project is mostly the result of "vibe coding" just me tinkering around, experimenting, and making things work for my own daily setup. I'm not running a strict or formal development cycle here!
If you find bugs, have cool ideas, or want to make it better, feel free to open an issue, submit a pull request, or just fork it and go wild. Just keep in mind that I review things at a pretty relaxed pace. We're all just here to have fun customizing our desktops!
MIT License - See LICENSE file for details