hyprsplit

awesome / dwm like workspaces for hyprland

A complete rewrite of split-monitor-workspaces that attempts to fix the issues I experienced with it. Improvements include:

• Workspaces on each monitor are determined by that monitor's ID
• Ability to grab windows that get lost in invalid workspaces when disconnecting monitors
• Dispatcher to swap all windows in active workspaces between two monitors
• Better handling of workspace params. For example empty will work properly and select an empty workspace on the current monitor.

Installation

Requires Hyprland version >=v0.36.0

Hyprpm

Load plugins on startup by putting exec-once = hyprpm reload -n in your hyprland config.

hyprpm update
hyprpm add https://github.com/shezdy/hyprsplit
hyprpm enable hyprsplit

Manual

Make sure you have the Hyprland headers installed (see hyprland wiki)

If you are compiling for a numbered version of Hyprland, check for a commit pin in hyprpm.toml, and reset the plugin to the second hash in the pair.

Compile the plugin:

make all

Finally add the following to your config plugin = /path/to/hyprsplit/hyprsplit.so, or run hyprctl plugin load /path/to/hyprsplit/hyprsplit.so

Configuration

Options

name	description	type	default
num_workspaces	Number of workspaces on each monitor	int	10
persistent_workspaces	if true, will make workspaces on each monitor persistent (they will always exist and will not be destroyed when empty)	bool	false

Dispatchers

Dispatcher	Description	Params
split:workspace	Replacement for workspace	workspace
split:movetoworkspace	Replacement for movetoworkspace	workspace OR workspace,window for a specific window
split:movetoworkspacesilent	Replacement for movetoworkspacesilent	workspace OR workspace,window for a specific window
split:swapactiveworkspaces	Swaps all windows in active workspaces between two monitors	two monitors separated by a space
split:grabroguewindows	Finds all windows that are in invalid workspaces and moves them to the current workspace. Useful when unplugging monitors.	none

Example Config

plugin {
    hyprsplit {
        num_workspaces = 6
    }
}

bind = SUPER, 1, split:workspace, 1
bind = SUPER, 2, split:workspace, 2
bind = SUPER, 3, split:workspace, 3
bind = SUPER, 4, split:workspace, 4
bind = SUPER, 5, split:workspace, 5
bind = SUPER, 6, split:workspace, 6

bind = SUPER SHIFT, 1, split:movetoworkspacesilent, 1
bind = SUPER SHIFT, 2, split:movetoworkspacesilent, 2
bind = SUPER SHIFT, 3, split:movetoworkspacesilent, 3
bind = SUPER SHIFT, 4, split:movetoworkspacesilent, 4
bind = SUPER SHIFT, 5, split:movetoworkspacesilent, 5
bind = SUPER SHIFT, 6, split:movetoworkspacesilent, 6

bind = SUPER, D, split:swapactiveworkspaces, current +1
bind = SUPER, G, split:grabroguewindows