Skip to content

Latest commit

 

History

History
86 lines (59 loc) · 2.92 KB

README.md

File metadata and controls

86 lines (59 loc) · 2.92 KB
Raw

hyprnome

GNOME-like workspace switching in Hyprland.

Features

  • Switch between workspaces without worrying about which numbered workspace you're on.
  • Reduce the amount of effort it takes to switch workspaces since you no longer have to reach for keys 3-9.
  • Use multiple monitors without worrying about which monitor a workspace is on.
  • Difference between m+1: Does not wrap and instead creates new workspaces when reaching the end.
  • Difference between r+1: Does not show an empty workspace if there's a non-empty workspace with a higher id.

Installation

hyprnome has official support for NixOS, Arch Linux (AUR), and Fedora (Copr).

Packaging status

NixOS (Recommended)

Add hyprnome to your systemPackages and rebuild.

{ pkgs, ... }:

{
  environment.systemPackages = with pkgs; [
    hyprnome
  ];
}

Alternatively, use nix run nixpkgs#hyprnome to try hyprnome without installing it.

Arch Linux (AUR)

Use an AUR helper like yay to install hyprnome.

yay hyprnome

Fedora (Copr)

hyprnome is available in the solopasha/hyprland Copr repository.

sudo dnf copr enable solopasha/hyprland && sudo dnf install hyprnome

Other distributions

Follow the install guide for Rust. Then, use cargo to install hyprnome.

cargo install --git https://github.com/donovanglover/hyprnome --tag 0.3.1

Usage

Usage: hyprnome [OPTIONS]

Options:
  -p, --previous      Go to the previous workspace instead of the next
  -m, --move          Move the active window to the dispatched workspace
  -n, --no-empty      Don't create empty workspaces in the given direction
  -k, --keep-special  Don't auto-close special workspaces when switching workspaces
  -c, --cycle         Cycle between workspaces instead of creating new ones
  -v, --verbose       Print debugging information
  -h, --help          Print help (see more with '--help')
  -V, --version       Print version

Example hyprland.conf:

bind = SUPER, 1, exec, hyprnome --previous
bind = SUPER, 2, exec, hyprnome
bind = SUPER_SHIFT, 1, exec, hyprnome --previous --move
bind = SUPER_SHIFT, 2, exec, hyprnome --move

Contributing

This software should be bug-free, however contributions are welcome. Remember to write tests for any new functionality and ensure that all existing tests pass.