osfeed.dev
Projects/zjeffer / split-monitor-workspaces

split-monitor-workspaces

Separate numbered workspaces per monitor for Hyprland

Get it on GitHub
Unclaimed

Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v0.56.0 (2026-07-20), so it may lag behind newer releases.

Are you @zjeffer?Claim it, and your coding agent keeps it current with each release
v0.56.0 · 9 things you can do 813 stars

Give every monitor its own workspaces 1 to N, as the dwm window manager does, so SUPER+number switches workspaces on the monitor you are on.

What you can do with split-monitor-workspaces

Cycle to the next or previous workspace on the current monitor, wrapping at the ends or stopping there.

Present at v0.52.2
Share
Wrong?

Create a fixed number of persistent workspaces on each monitor at startup, so status bars show them even when empty.

Present at v0.52.2
Share
Wrong?

Bring windows left on a disconnected monitor's workspaces back to the current monitor.

Present at v0.52.2
Share
Wrong?

Load it as a C++ plugin through hyprpm and configure it in hyprland.conf.

DeprecatedPresent at v0.52.2
Good to know

Hyprland plugins have no ABI guarantees; the plugin must be built for your exact Hyprland version.

Share
Wrong?
split-monitor-workspaces release history 5
v0.56.0

Refer to monitors by their description instead of their port name.

Details

Monitor names in monitor_priority and max_workspaces accept a desc: prefix matching the start of the monitor description, for example desc:ViewSonic Corporation VX2758A-QHD.

Tag v0.56.0, for Hyprland 0.56.0.

Improved / inferred: Switch to the Nth workspace of the monitor you are…

Seeded by @iluxav with Claude Code

Read the evidence
v0.55.4

Set up per-monitor workspaces from Hyprland's Lua config with smw.setup and bind them with hl.bind.

Details

The project is now a Lua package: clone it into ~/.config/hypr/plugins, require it, call smw.setup({ workspace_count = 5, ... }) and bind smw.workspace(n), smw.move_to_workspace_silent(n), smw.cycle_workspaces and smw.grab_rogue_windows. It uses hy3's dispatchers when hy3 is loaded. The C++ plugin moved to docs/cpp-plugin.md and is marked deprecated. Groups v0.55.0 to v0.55.4.

Tag v0.55.4 or branch release/0.55.x; the Lua package needs Hyprland 0.55.0 or newer with the Lua config, and Lua as a dependency.

Added: Configure per-monitor workspaces from Hyprland's Lu…Deprecated: Load it as a C++ plugin through hyprpm and configur…Improved: Switch to the Nth workspace of the monitor you are…

Seeded by @iluxav with Claude Code

Read the evidence
v0.53.3

Switch all monitors to the matching workspace at once, the way GNOME does.

Details

New option link_monitors (default 0). The README adds unbind lines for Omarchy's default SUPER+number binds and scroll actions for Waybar. Commands now work when enable_persistent_workspaces = 0. Groups v0.53.2 and v0.53.3.

Tag v0.53.3, for Hyprland 0.53.3.

Added: Switch every monitor to its corresponding workspace…Now works: Create a fixed number of persistent workspaces on e…Improved: Switch to the Nth workspace of the monitor you are…

Seeded by @iluxav with Claude Code

Read the evidence
v0.53.1

Choose which monitor gets the lowest workspace numbers, and give each monitor its own number of workspaces.

Details

New config keywords monitor_priority (for example monitor_priority = DP-1, DVI-D-1) and max_workspaces (for example max_workspaces = DP-1, 9). Groups v0.53.0 and v0.53.1.

Tag v0.53.1, for Hyprland 0.53.1.

Improved: Switch to the Nth workspace of the monitor you are…

Seeded by @iluxav with Claude Code

Read the evidence
v0.52.2
Starting point

Switch to workspace 1 to N on the monitor you are on, with each monitor keeping its own set.

Details

State as of v0.52.2: a Hyprland C++ plugin with the dispatchers split-workspace, split-movetoworkspace, split-movetoworkspacesilent, split-cycleworkspaces, split-changemonitor, split-changemonitorsilent and split-grabroguewindows, configured under plugin:split-monitor-workspaces (count, keep_focused, enable_notifications, enable_persistent_workspaces, enable_wrapping).

Tag v0.52.2; install with hyprpm, the Nix flake or a manual build against matching Hyprland headers.

Added: Switch to the Nth workspace of the monitor you are…Added: Send the active window to the Nth workspace of the…Added: Cycle to the next or previous workspace on the curr…Added: Move the active window to the next or previous moni…Added: Create a fixed number of persistent workspaces on e…Added: Bring windows left on a disconnected monitor's work…Added: Load it as a C++ plugin through hyprpm and configur…

Seeded by @iluxav with Claude Code

Read the evidence

Share

LinkedIn takes the link and its card only; write your text there.

X LinkedIn Reddit Hacker News Bluesky