Built by @outfoxxed on GitHub. This page was written by @iluxav from public sources, last updated for hl0.56.0.1 (2026-07-22), and may lag behind new releases.
Tile windows in Hyprland the way i3 and sway do, with nested horizontal, vertical and tabbed groups you split, move and focus by hand.
What you can do with it
Split the focused window into a horizontal or vertical group and nest groups inside each other, like i3 or sway.
Good to know
Set general:layout = hy3 and replace movefocus and movewindow with hy3:movefocus and hy3:movewindow in your binds. The hy3 tag must match your Hyprland version.
Present at hl0.49.0
Stack windows as tabs in a group with a tab bar showing their titles, and switch tabs by key or mouse.
Good to know
Tab bar look is set under plugin:hy3:tabs (height, radius, colors, blur, opacity, font).
Present at hl0.49.0
Move focus or windows left, right, up and down through the tree, across monitors, and send a whole group to another workspace.
Present at hl0.49.0
Split windows automatically when a new one would make them narrower or shorter than a set size.
Good to know
Off by default; enable with plugin:hy3:autotile:enable and limit it to workspaces with autotile:workspaces.
Present at hl0.49.0
Switch focus between the tiled and floating windows on a workspace with one key.
Present at hl0.49.0
Reset the windows in a group, or across the whole workspace, to equal sizes.
Since hl0.53.0
Bind hy3 dispatchers from a Hyprland Lua config through hl.plugin.hy3.
Good to know
Needs a Hyprland version with the Lua config.
Since hl0.55.0
Expand the focused node to cover its neighbours, and shrink it back.
Good to know
Marked alpha quality in the README.
PreviewPresent at hl0.49.0
Before you upgrade
Newest first
hl0.55.02026-05-14
Rename tab colors: plugin:hy3:tabs col.active, col.active.border, col.active.text and the same for active_alt_monitor, focused, inactive, urgent and locked become a colors { } block with active, active_border, active_text and so on.
Action requiredAffects: Configs that set any plugin:hy3:tabs:col.* option
Hide gaps when only one window is on screen, optionally keeping its border.
Removedhl0.49.0 → hl0.54.2
Release history 7
hl0.56.0.12026-07-22
Run hy3 on Hyprland 0.56 with tab bars drawn the right way on rotated monitors.
Details
Groups hl0.56.0 (compatibility with Hyprland 0.56.0) and hl0.56.0.1, which fixes resizing with the mouse toward the top left and tab bars rendering in the wrong orientation on rotated monitors.
Tag hl0.56.0.1, for Hyprland 0.56.0.
Now works: Stack windows as tabs in a group with a tab bar sho…Now works: Split the focused window into a horizontal or verti…
hy3 exposes dispatcher factories under hl.plugin.hy3 (make_group, change_group, move_focus, move_window, move_to_workspace and more) for use with hl.bind. Tab color options moved from col.* to a colors block with underscore names.
Also: Fixed crashes with locked opaque tabs and when a monitor is removed.
Tag hl0.55.0; the release notes say it is compatible with Hyprland 0.55.1.
Added: Bind hy3 dispatchers from a Hyprland Lua config thr…Action required: Stack windows as tabs in a group with a tab bar sho…
Move focus across monitors again after the hl0.54.2 refactor.
Details
Fixes from the changelog: focus across monitors, the toggle argument of hy3:makegroup, the window input area covering reserved space, tab bars not clickable after resizing, and nodes collapsing too far when removed with the mouse.
Tag hl0.54.2.1, for Hyprland 0.54.2.
Now works: Move focus or windows left, right, up and down thro…Now works: Split the focused window into a horizontal or verti…Now works: Stack windows as tabs in a group with a tab bar sho…
See at a glance which tab bars belong to a monitor that is not focused.
Details
New tab colors col.active_alt_monitor, col.active_alt_monitor.border and col.active_alt_monitor.text under plugin:hy3:tabs for the active tab on an unfocused monitor.
Tag hl0.52.0, for Hyprland 0.52.0; the release notes say it also works with 0.52.1.
Improved: Stack windows as tabs in a group with a tab bar sho…
Tile Hyprland windows by hand into nested horizontal, vertical and tabbed groups, like i3 or sway.
Details
State of hy3 as of the hl0.49.0 tag: general:layout = hy3, the hy3:makegroup, hy3:changegroup, hy3:movefocus, hy3:movewindow, hy3:movetoworkspace, hy3:focustab, hy3:locktab and hy3:togglefocuslayer dispatchers, tab bar styling under plugin:hy3:tabs and autotiling under plugin:hy3:autotile.
Tag hl0.49.0, for Hyprland 0.49.0. Install with hyprpm, the Nix flake or the AUR.
Added: Split the focused window into a horizontal or verti…Added: Stack windows as tabs in a group with a tab bar sho…Added: Move focus or windows left, right, up and down thro…Added: Split windows automatically when a new one would ma…Added: Hide gaps when only one window is on screen, option…Added: Switch focus between the tiled and floating windows…Added: Expand the focused node to cover its neighbours, an…