https://github.com/donovanglover/hyprnome

GNOME-like workspace switching in Hyprland.
https://github.com/donovanglover/hyprnome

gnome hyprland linux rust

Last synced: 10 days ago
JSON representation

GNOME-like workspace switching in Hyprland.

• Host: GitHub
• URL: https://github.com/donovanglover/hyprnome
• Owner: donovanglover
• License: gpl-3.0
• Created: 2023-08-30T15:11:48.000Z (10 months ago)
• Default Branch: master
• Last Pushed: 2024-05-15T09:18:29.000Z (about 1 month ago)
• Last Synced: 2024-05-15T17:53:48.072Z (about 1 month ago)
• Topics: gnome, hyprland, linux, rust
• Language: Rust
• Homepage: https://donovan.is/hyprnome
• Size: 303 KB
• Stars: 76
• Watchers: 3
• Forks: 4
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Security: .github/SECURITY.md

Lists

• awesome-stars - hyprnome - like workspace switching in Hyprland. | donovanglover | 84 | (Rust)
• awesome-hyprland - hyprnome - like workspace switching in Hyprland) (Tools / Workspace)

README

        
# hyprnome

[GNOME](https://www.gnome.org/)-like workspace switching in [Hyprland](https://hyprland.org/).

## 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 (PKGBUILD), and Fedora (Copr).

### [NixOS](https://nixos.wiki/wiki/Overview_of_the_NixOS_Linux_distribution) (Recommended)

Add [`hyprnome`](https://search.nixos.org/packages?channel=unstable&query=hyprnome) to your `systemPackages` and rebuild.

```nix

{ pkgs, ... }:

{

  environment.systemPackages = with pkgs; [

    hyprnome

  ];

}

```

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

### [Arch Linux](https://archlinux.org/) (PKGBUILD)

I don't use Arch Linux anymore, but I wrote a PKGBUILD for the `pacman` enjoyers out there. Feel free to add it to the AUR.

```fish

git clone https://github.com/donovanglover/hyprnome -b 0.3.0 && cd hyprnome && makepkg -si

```

### [Fedora](https://fedoraproject.org/) (Copr)

[`hyprnome`](https://copr.fedorainfracloud.org/coprs/solopasha/hyprland/package/hyprnome) is available in the [solopasha/hyprland](https://copr.fedorainfracloud.org/coprs/solopasha/hyprland) Copr repository.

```fish

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

```

### Other distributions

Follow the [install guide](https://www.rust-lang.org/tools/install) for Rust. Then, use cargo to install hyprnome.

```fish

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

```

## Usage

```man

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`:

```bash

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.