Hyprland Wiki
Contribute to the Wiki!Toggle Dark/Light/Auto modeToggle Dark/Light/Auto modeToggle Dark/Light/Auto modeBack to homepage

Master Layout

The master layout makes one window be the “master”, taking the left part of the screen, and tiles the rest on the right.

Quirks

The right, “slave” windows will always be split uniformly. You cannot change their size.

master1

However, you can resize the master window.

master2

Config

category name master

namedescriptiontypedefault
special_scale_factor(0.0 - 1.0) the scale of the special workspace windowsfloat0.8
new_is_masterwhether a newly open window should replace the master or join the slaves.booltrue
new_on_topwhether a newly open window should be on the top of the stackboolfalse
no_gaps_when_onlywhether to apply gaps when there is only one window on a workspace, aka. smart gaps.boolfalse

Dispatchers

layoutmsg params:

paramdescription
swapwithmasterswaps the current window with master. If the current window is the master, swaps it with the first child.
focusmasterfocuses the master window. If the current window is the master, focuses the first child.
cyclenextfocuses the next window respecting the layout
cycleprevfocuses the previous window respecting the layout
swapnextswaps the focused window with the next window respecting the layout
swapprevswaps the focused window with the previous window respecting the layout
addmasteradds a master to the master side. That will be the active window, if it’s not a master, or the first non-master window.
removemasterremoves a master from the master side. That will be the active window, if it’s a master, or the last master window.

example usage:

bind=MOD,KEY,layoutmsg,cyclenext