hypr-cycle

A fast, minimal Rust utility to cycle through workspaces on the currently focused monitor in Hyprland. Unlike hyprctl dispatch workspace e+1, this tool avoids switching workspaces to a different monitor in multi-monitor setups. Unlike hyprctl dispatch focusworkspaceoncurrentmonitor next, this will only switch to workspaces with windows on them.

Features

• Cycles only the workspaces bound to the focused monitor
• Wraps around when reaching the end or beginning
• Fast, clean, and dependency-free
• Written in Rust for performance and reliability

Installation

Cargo

If you've got the Rust tools installed, this is probably the easiest way to get it.

  cargo install hypr-cycle

Arch Linux (via the AUR)

• Requires Git.

1. Clone the repo:

git clone https://aur.archlinux.org/hypr-cycle.git

2. Make and install

cd hypr-cycle
makepkg -si

... or just install hypr-cycle via your favorite AUR helper. (This is the only method that doesn't require you to have Rust tools installed.)

• Example requires yay, but any AUR helper will do.

  yay hypr-cycle
  

From Source

• Requires Git.
• Requires Rust.

1. Clone the repo:

   git clone https://github.com/christopherdolan/hypr-cycle
   cd hypr-cycle
   

2. Build and install:

   cargo build --release
   sudo install -Dm755 target/release/hypr-cycle /usr/local/bin/hypr-cycle
   

If you want to package this for other distributions, be my guest!

Usage

hypr-cycle previous
hypr-cycle next

This will cycle to the next or previous numbered workspace on the monitor that currently has keyboard focus.

Example Hyprland Config

If you want to change workspaces using Mod+Tab and Mod+Shift+Tab, add these bindings to your ~/.config/hypr/hyprland.conf:

bind = $mod SHIFT, Tab, exec, hypr-cycle previous
bind = $mod, Tab, exec, hypr-cycle next

Example Waybar Config

If you want to change workspaces on Waybar using your mouse wheel, add these to your ~/.config/waybar/config.jsonc:

        "hyprland/workspaces": {
            // ...
            "on-scroll-up":"hypr-cycle previous",
            "on-scroll-down":"hypr-cycle next",
            // ...
        },

Dependencies

• Hyprland
• Rust (for building only)

License

MIT license. See LICENSE file.

Contributions

PRs and suggestions welcome! This is a minimal utility, but if you have an idea to make it more powerful or efficient, feel free to open an issue or PR.