layout_center

Implements a workspace layout where one window is bigger and centered, other windows are tiled as usual in the background.

On toggle, the active window is made floating and centered if the layout wasn't enabled, else reverts the floating status.

With next and prev you can cycle the active window, keeping the same layout type. If the layout_center isn't active and next or prev is used, it will call the next and prev configuration options.

To allow full override of the focus keys, next2 and prev2 are provided, they do the same actions as next and prev but allow different fallback commands.

Configuration sample

[layout_center]
margin = 60
offset = [0, 30]
next = "movefocus r"
prev = "movefocus l"
next2 = "movefocus d"
prev2 = "movefocus u"

using the following in hyprland.conf:

bind = $mainMod, M, exec, pypr layout_center toggle # toggle the layout
## focus change keys
bind = $mainMod, left, exec, pypr layout_center prev
bind = $mainMod, right, exec, pypr layout_center next
bind = $mainMod, up, exec, pypr layout_center prev2
bind = $mainMod, down, exec, pypr layout_center next2

You can completely ignore next2 and prev2 if you are allowing focus change in a single direction (when the layout is enabled), eg:

bind = $mainMod, up, movefocus, u
bind = $mainMod, down, movefocus, d

Commands

Loading commands...

Configuration

Loading configuration...

style

Custom Hyprland style rules applied to the centered window. Requires Hyprland > 0.40.0.

style = ["opacity 1", "bordercolor rgb(FFFF00)"]

on_new_client

Behavior when a new window opens while layout is active:

• "focus" (or "foreground") - make the new window the main window
• "background" - make the new window appear in the background
• "close" - stop the centered layout when a new window opens

next / prev

Hyprland dispatcher command to run when layout_center isn't active:

next = "movefocus r"
prev = "movefocus l"

next2 / prev2

Alternative fallback commands for vertical navigation:

next2 = "movefocus d"
prev2 = "movefocus u"

offset

offset in pixels applied to the main window position

Example shift the main window 20px down:

offset = [0, 20]

margin

margin (in pixels) used when placing the center window, calculated from the border of the screen.

Example to make the main window be 100px far from the monitor's limits:

margin = 100

You can also set a different margin for width and height by using a list:

margin = [100, 100]