This project is now deprecated, and no longer maintained

This functionallity has been implemented in base Hyprland with the workspace dispatch r+1/r-1. See this issue for details, or view the wiki page

hyprland-relative-workspace

A tool to switch Hyprland workspaces relatively to each monitor and create new workspaces where necessary

Requires Hyprland

Installation

Cargo (crates.io):

cargo install hyprland-relative-workspace

Arch (AUR):

yay -S hyprland-relative-workspace-bin

Usage:

Recommended

Add binds in your Hyprland config similar to these:

bind = $mainMod, left, exec, hyprland-relative-workspace b
bind = $mainMod, right, exec, hyprland-relative-workspace f
bind = $mainMod SHIFT, left, exec, hyprland-relative-workspace b --with-window
bind = $mainMod SHIFT, right, exec, hyprland-relative-workspace f --with-window

Basic command

Use either "f" or "forward" to advance one workspace relative to the current focused workspace (the one with your mouse on it).

Similarily, you can use "b" or "backward" to go back (down, left, eg. workspace 3 -> workspace 2) one workspace relative to the focused monitor. Also creating a new workspace if required and possible (eg. if workspaces 1, and 3 exist, going back one would create workspace 2. However you cannot go lower than 1).

All of these commands can also be used with --with-window to bring the currently focused window with you, or --no-create-new to prevent the creation of new workspaces see #1.

$ hyperland-relative-workspace ["f", "forward", "b", "backward"] (opt. "--with-window", "--no-create-new")