split-monitor-workspaces

A small plugin to provide awesome/dwm-like behavior with workspaces: split them between monitors and provide independent numbering

Installing

Since Hyprland plugins don't have ABI guarantees, you should download the Hyprland source and compile it if you plan to use plugins. This ensures the compiler version is the same between the Hyprland build you're running, and the plugins you are using.

The guide on compiling and installing Hyprland manually is on the wiki

Using hyprload

Add the line "Duckonaut/split-monitor-workspaces", to your hyprload.toml config, like this

plugins = [
    "Duckonaut/split-monitor-workspaces",
]

Then update via the hyprload,update dispatcher

Manual installation

Export the HYPRLAND_HEADERS variable to point to the root directory of the Hyprland repo
- export HYPRLAND_HEADERS="$HOME/repos/Hyprland"
Compile
- make all
Add this line to the bottom of your hyprland config
- exec-once=hyprctl plugin load <ABSOLUTE PATH TO split-monitor-workspaces.so>

Usage

The plugin provides drop-in replacements for workspace-related commands

Normal	Replacement
workspace	split-workspace
movetoworkspace	split-movetoworkspace
movetoworkspacesilent	split-movetoworkspacesilent

It also provides the following config values

Name	Type	Default	Description
`plugin:split-monitor-workspaces:count`	int	10	How many workspaces to bind to the monitor

Keep in mind that if you're using, for example, the wlr/workspaces widgets in waybar, this will require a change to your config. You should set all-outputs to false, and adjust the icon mapping.

If your workspace-per-monitor count is 10, the first monitor will have workspaces 1-10, the second 11-20 and so on. They will be accessed via numbers 1-10 while your mouse is on a given monitor.

Special thanks

hyprsome: An earlier project of similar nature

2.4 KiB Raw Blame History