hyprnome(1)

💅 hyprnome(1) — the GNOME-ish workspace switcher, but make it Hyprland

okay bestie, so this is hyprnome, a page from the General Commands Manual, and honestly? it's giving "I just want my workspaces to behave like GNOME" and I'm obsessed. 🫶

---

✨ NAME ✨

hyprnome — GNOME-like workspace switching in Hyprland. that's it, that's the whole vibe. 💖

---

🌸 SYNOPSIS 🌸

hyprnome [-p|--previous] [-m|--move] [-n|--no-empty] [-k|--keep-special]
[-c|--cycle] [-v|--verbose] [-h|--help] [-V|--version]

---

🦋 DESCRIPTION 🦋

so hyprnome is a program that lets you achieve GNOME-like workspace switching in Hyprland. literally that's its whole job, and it eats. 👑

here's the thing: unlike Hyprland's r+1/r-1, empty workspaces sitting between two occupied workspaces get skipped. no more scrolling past ghost workspaces, we love to see it. ✨

and unlike Hyprland's m+1/m-1, new workspaces get created instead of wrapping around to existing ones. no cap, it just keeps going forward. 🚀

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

okay now the legal portion, and yes you have to read it, sorry bestie 🎀

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

---

💅 OPTIONS 💅

• -p, --previous — go to the previous workspace instead of the next. by default hyprnome advances to the next workspace, so --previous is the flag you need when you wanna go backwards through the list of occupied workspaces. lowkey essential. ⬅️
• -m, --move — move the active window to the dispatched workspace. this flag lets you move windows across workspaces without having to worry about which workspace you're currently in. chef's kiss, no notes. 🪟
• -n, --no-empty — don't create empty workspaces in the given direction. this prevents empty workspaces from being created when no occupied workspaces remain in the given direction. it's giving "don't leave me on read" but for workspaces. 🙈
• -k, --keep-special — don't auto-close special workspaces when switching workspaces. okay this one has lore, buckle up. 🧚

With --move:

Hyprland v0.29.0 and above allow opening empty special workspaces. This changed the behavior of special workspaces, most notably not auto-closing them by default when moving windows outside them.

hyprnome v0.2.0 auto-closes special workspaces by default to mimic the old behavior. In order to avoid breaking people's workflows, it's possible to keep the special workspace open with this flag, although you'd then have to manually close the special workspace.

Without --move:

Special workspaces are cool when used with translucent or non-opaque windows that let you see the workspaces behind them. They become problematic when there's an opaque window preventing you from seeing the workspaces you're switching to.

By default when switching workspaces, any windows in the workspace behind are focused. To avoid accidentally thinking that the special workspace is focused, hyprnome will automatically close special workspaces by default when switching between non-special workspaces.

This flag makes it possible to keep the special workspace visible when switching workspaces, although it won't be focused if the workspace behind it has one or more windows.

Summary: This flag is available so users can choose the old behavior, however automatically closing special workspaces (the default) does have its benefits.

bestie, tl;dr — the flag exists so you can have the old behavior, but the default (auto-closing) genuinely has perks. read the lore before you commit. 💀

• -c, --cycle — cycle between workspaces instead of creating new ones. this flag makes it possible to cycle to the last workspace on a monitor when there are no other workspaces before, and to cycle to the first workspace on a monitor when there are no other workspaces after. it's giving carousel energy 🎠
• -v, --verbose — print debugging information. for when you need the tea. 🍵
• -h, --help — print help (see a summary with '-h')
• -V, --version — print version

---

⭐ VERSION ⭐

v0.3.1

---

👑 AUTHORS 👑

Copyright (C) 2023-2024 Donovan Glover <https://donovan.is/>

---

okay that's the whole page bestie, go forth and switch those workspaces slayfully 💜

signed off with love — hyprnome 0.3.1, dated hyprnome(1) 🎀