Displays
Settings → Displays arranges the screens, and keeps the arrangement for the set that is plugged in. Plug the same monitors in again, in any port, and it comes back by itself. The page has three parts: Arrangement, The screen and The lid. The night light is a page of the control centre.
Arrangement
Section titled “Arrangement”The canvas draws the screens to scale. Drag one to move it: it snaps to the edges of the others when you let go, and applies then, with no Apply button and no countdown. Click one to pick it for The screen.
| Row | |
|---|---|
| Arrangement | Extend across every screen, or Mirror: every screen shows the main screen’s |
| The main screen | Where anything with no screen of its own goes, and what mirroring copies |
| Forget it | Hands this set of screens back to Hyprland’s own placement |
With one screen plugged in, Arrangement and The main screen are shown dimmed, and Forget it appears once the set has an arrangement. A screen that is off has no place on the canvas; it gets a line under it, “off, and still plugged in”, which is how it is selected and switched back on.
One arrangement per set of screens
Section titled “One arrangement per set of screens”An arrangement is kept for a set of screens. A screen is known by its make, model and serial rather than by its port, so a cable moved to another socket changes nothing. A laptop on its own and the same laptop at a desk are two sets, each with its own arrangement; the lid shut is the same set with one screen off.
A set nobody arranged is left to Hyprland’s auto, so a fresh install pushes
nothing. The shell never writes ~/.config/hypr/modules/monitors.lua: that
file is the fallback, and what you arrange is applied over it at login, after
every reload and after every hotplug.
When a screen goes away, the workspaces that were on it move to the main screen. If nothing plugged in would be lit, every screen present is switched on.
The screen
Section titled “The screen”The screen picked on the canvas — or under Editing, with more than one:
| Row | |
|---|---|
| On | Switches it off or on; the last lit screen cannot be switched off |
| Resolution | The modes the monitor reports, largest first; choosing one takes its fastest refresh rate |
| Refresh rate | The rates that resolution offers; dimmed when it offers only one |
| Scale | 1× to 3×, in steps of 0.05 |
| Rotation | None, 90°, 180° or 270° |
| Variable refresh | On or off |
The On row tells a screen that is off — out of the layout, its workspaces moved away — from one that is dark: asleep, with its workspaces still on it, as it is once the idle timer has switched it off.
The lid
Section titled “The lid”What closing the lid does while another screen is plugged in:
| Tile | |
|---|---|
| Switch it off | The laptop’s screen goes off, and its workspaces move to the other screen |
| Leave it on | It stays lit behind the lid |
| The system decides | The shell has no opinion, and logind does what it is set to |
With nothing else plugged in, the lid is left to logind, which suspends. Opening the lid lights the laptop’s screen again, where it was. Under Right now, the page says which panel is the laptop’s and what else is connected.
The other screens
Section titled “The other screens”Every screen carries the whole bar, the dock, its own widgets and the notes on its edges, and the one with the keyboard is the live one. How the keys, the bar and the rest behave across them is on Several screens. A screen plugged in later gets the wallpaper too.
Bit depth is not offered, mirroring copies the main screen to every other screen, and the page does not notice a change made from outside while it is open. The rest is under Limitations.