Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/donovanglover/hyprnome

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

gnome hyprland linux rust

Last synced: 8 days ago
JSON representation

GNOME-like workspace switching in Hyprland.

Awesome Lists containing this project

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

[![Packaging status](https://repology.org/badge/vertical-allrepos/hyprnome.svg)](https://repology.org/project/hyprnome/versions)

### [NixOS](https://wiki.nixos.org/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/) (AUR)

Use an AUR helper like [yay](https://github.com/Jguer/yay) to install [`hyprnome`](https://aur.archlinux.org/packages/hyprnome).

```fish
yay hyprnome
```

### [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.1
```

## 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.