osfeed.dev
Projects/outfoxxed / hy3

hy3

An i3 and sway style tiling layout plugin for Hyprland

Get it on GitHub
Unclaimed

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.

Are you @outfoxxed?Claim this page to keep it up to date
hl0.56.0.1 · 2026-07-22 8 things you can do 2 changes to know before upgrading
Follow GitHub

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 hy3

Split the focused window into a horizontal or vertical group and nest groups inside each other, like i3 or sway.

Present at hl0.49.0
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.

Stack windows as tabs in a group with a tab bar showing their titles, and switch tabs by key or mouse.

1 other tool for tabbed windows
Present at hl0.49.0
Good to know

Tab bar look is set under plugin:hy3:tabs (height, radius, colors, blur, opacity, font).

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.

Present at hl0.49.0
Good to know

Off by default; enable with plugin:hy3:autotile:enable and limit it to workspaces with autotile:workspaces.

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

Expand the focused node to cover its neighbours, and shrink it back.

ExperimentalPresent at hl0.49.0
Good to know

Marked alpha quality in the README.

Before you upgrade hy3

Newest first
hl0.54.22026-03-10

Remove plugin:hy3:no_gaps_when_only from your config and set the same behavior with Hyprland workspace rules.

Action requiredAffects: Configs that set plugin:hy3:no_gaps_when_only
Read the evidence
Removed 1

Hide gaps when only one window is on screen, optionally keeping its border.

Removedhl0.49.0 → hl0.54.2
hy3 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…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
hl0.55.02026-05-14

Bind hy3 dispatchers from Hyprland's Lua config.

Details

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…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
hl0.54.2.12026-03-29

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…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
hl0.54.22026-03-10

Run hy3 on Hyprland 0.54.2, with gap handling for single windows now left to Hyprland's workspace rules.

Details

The plugin:hy3:no_gaps_when_only option was removed in favor of Hyprland workspace rules. The changelog notes a large internal refactor.

Tag hl0.54.2, for Hyprland 0.54.2.

Removed: Hide gaps when only one window is on screen, option…Action required: Hide gaps when only one window is on screen, option…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
hl0.53.02026-01-09

Make all windows in a group, or on the whole workspace, the same size again.

Details

New dispatcher hy3:equalize, with no argument for the focused window's siblings or workspace for the whole workspace tree.

Also: Tab bars no longer glitch when a window title changes.

Tag hl0.53.0, for Hyprland 0.53.0; the release notes say it also works with 0.53.1.

Added: Reset the windows in a group, or across the whole w…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
hl0.52.02025-10-31

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…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
hl0.49.02025-05-11
Starting point

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…

Seeded by @iluxav with Claude Code (canido)

Read the evidence