The general config of a monitor looks like this
A common example:
will tell Hyprland to make the monitor on
1920x1080 display, at 144Hz,
0x0 off from the top left corner, with a scale of 1 (unscaled).
Monitors are positioned on a virtual “layout”. The
position is the position of
said display in the layout. (calculated from the top-left corner)
monitor=DP-1, 1920x1080, 0x0, 1 monitor=DP-2, 1920x1080, 1920x0, 1
will tell hyprland to make DP-1 on the left of DP-2, while
monitor=DP-1, 1920x1080, 1920x0, 1 monitor=DP-2, 1920x1080, 0x0, 1
will tell hyprland to make DP-1 on the right.
The position is calculated with the scaled (and transformed) resolution, meaning if you want your 4K monitor with scale 2 to the left of your 1080p one, you’d use the position
1920x0for the second screen. (3840 / 2) If the monitor is also rotated 90 degrees (vertical) you’d use
Leaving the name empty will define a fallback rule to use when no other rules match.
You can use
preferred as a resolution to use the display’s preferred size, and
auto as a position to let Hyprland decide on a position for you.
You can also use
auto as a scale to let Hyprland decide on a scale for you. These
depend on the PPI of the monitor.
Recommended rule for quickly plugging in random monitors:
Will make any monitor that was not specified with an explicit rule automatically placed on the right of the other(s) with its preferred resolution.
Alternatively you can use the
highres rules in order to get the
best possible resolution or refreshrate mix.
for a focus on refreshrate use this:
for a focus on resolution this:
For more specific rules, you can also use the output’s description
hyprctl monitors) like this:
remember to remove the (portname)!
To disable a monitor, use
Disabling a monitor will literally remove it from the layout, moving all windows and workspaces to any remaining ones. If you want to disable your monitor in a screensaver style (just turn off the monitor) use the
If your workflow requires custom reserved area, you can add it with
RIGHT are integers in pixels of the reserved area
to add. This does stack on top of the calculated one, (e.g. bars) but you may
only use one of these rules per monitor in the config.
If you want to mirror a display, add a
,mirror,[NAME] at the end of the monitor
monitor=DP-3,[email protected],0x0,1,mirror,DP-2 monitor=,preferred,auto,1,mirror,DP-1
Please remember that mirroring displays will not “re-render” everything for your second monitor, so if mirroring a 1080p screen onto a 4K one, the resolution will still be 1080p on the 4K display. This also means squishing and stretching will occur on non-matching resolutions.
If you want to enable 10 bit support for your display, add a
,bitdepth,10 at the
end of the monitor rule, e.g.:
Please be aware that colors registered in Hyprland (e.g. the border color) do not support 10 bit.
The monitor transform and workspace keywords depend on a monitor rule set specifically for the targeted monitor, and MUST be after it.
monitor=,preferred,auto,1 workspace=DP-3,1 # invalid monitor=DP-3,preferred,auto,1 workspace=DP-3,1 # valid
will tell Hyprland to make the default workspace on DP-1 a number 1.
If you want to rotate a monitor, use
NAME is the name, and
TRANSFORM is an integer, from 0 to 7,
corresponding to your transform of choice.
normal (no transforms) -> 0 90 degrees -> 1 180 degrees -> 2 270 degrees -> 3 flipped -> 4 flipped + 90 degrees -> 5 flipped + 180 degrees -> 6 flipped + 270 degrees -> 7
A workspace can be bound to a monitor, meaning by default it will ALWAYS open on the selected monitor. You can do this with