Hyprland Dynamic Workspaces Manager Script

I prefer being able to give each workspace a name, instead of the default assigned workspace numbers. This script allows me to create workspaces on the fly, name them and switch between them with ease.

Features

Create a workspace with any name that you want.
Rename a workspace.
Move a window to any workspace.
Switch to any window.
Move all windows on the current workspace to another workspace.

Demo.mp4

Keybindings

These are my preferred key bindings.

I use the Windows key as my modifier.

I like using both Ctrl+Win keys together, and Alt+Win keys together. It makes launching apps and switching windows feel like the same action.

Action	Keybinding
Switch to window	Alt + Win + Space
App launcher	Ctrl + Win + Space
App launcher alternate	Ctrl + Shift + Win + Space
Rename Workspace	Win + x
Switch to Workspace	Win + z
Move the current window to another workspace	Win + Shift + z
Next workspace	Win + Tab
Previous workspace	Win + Shift + Tab
Delete workspace and move all windows to another	Win + Backspace
Move all workspace windows to another workspace with prompt	Ctrl + Win + Backspace
	OR
	Alt + Win + Backspace

Dependencies:

rofi - The wayland fork by lbonn found at https://github.com/lbonn/rofi.git
- rofi is used for the popup to list all workspaces/windows, and to handle all user input.
- Other launchers aren't supported (Pull Requests welcome). You will need to edit the script to change it to another app launcher.
  - Please see this link for recommended app launchers that you may be able to get working with this script.
  - https://wiki.hyprland.org/Useful-Utilities/App-Launchers/
python3
hyprctl - This should be installed with Hyprland

Why does it require rofi(the wayland fork) instead of wofi?

Rofi has more features than wofi.
Rofi can select a line in our list.
- This is used when we display a list of workspaces. Our current workspace will be highlighted.
Rofi can auto-select an item from the filtered list.
- As we type and land on the last option, it will select it without us needing to press enter. I've disabled this by default, but it can be enabled by passing the -auto-select argument.

Installation

Install dependencies

The rofi wayland fork found here.
- https://github.com/lbonn/rofi.git
Arch users use AUR package rofi-lbonn-wayland-only-git
- https://aur.archlinux.org/packages/rofi-lbonn-wayland-only-git
install python3 using your package manager

Download this script

cd ~/.config/hypr/
git clone https://github.com/sslater11/hyprland-dynamic-workspaces-manager.git
cd hyprland-dynamic-workspaces-manager/
./hyprland-dynamic-workspaces-manager.py

See below for how to add this script to your Hyprland config.

Use case

I often group my windows by the project that I'm working on. I do this by placing them on a workspace with a name related to the project.

Sometimes things get disorganised and I forget which workspace I moved a window to. Having the app switcher allows me to type in the name of a window and jump straight to it.

I often run about 5+ different workspaces with several different programs. I try to keep everything open as it saves time later on when resuming a project.

Renaming workspaces is required as a things can become disorganised quickly.

I have heard that people like to keep a single workspace for their web browser, but this doesn't work for me. I often have multiple web browser windows with lots of tabs open too. I will have one for studying, one for programming, one for general use and one for media. I keep these on their respective workspaces to keep things organised.

FAQ

How do I use this?

Place the script into ~/.config/hypr/ and make it executable. Create key bindings to this script in hyprland's config file. Below is my default setup. Add this to ~/.config/hypr/hyprland.conf

# Dynamic workspace manager variable setup
$app_launcher = rofi -show drun -show-icons -theme ~/.config/hypr/hyprland-dynamic-workspaces-manager/rofi-themes-collection/themes/rounded-nord-dark.rasi

$app_launcher_all = rofi -show combi -combi-modes run,drun -show-icons -theme ~/.config/hypr/hyprland-dynamic-workspaces-manager/rofi-themes-collection/themes/rounded-nord-dark.rasi

$window_switcher          = ~/.config/hypr/hyprland-dynamic-workspaces-manager/hyprland-dynamic-workspaces-manager.py --window-switcher
$workspace_switcher       = ~/.config/hypr/hyprland-dynamic-workspaces-manager/hyprland-dynamic-workspaces-manager.py --workspace
$move_window_to_workspace = ~/.config/hypr/hyprland-dynamic-workspaces-manager/hyprland-dynamic-workspaces-manager.py --move-window
$rename_workspace         = ~/.config/hypr/hyprland-dynamic-workspaces-manager/hyprland-dynamic-workspaces-manager.py --rename-workspace
$delete_current_workspace = ~/.config/hypr/hyprland-dynamic-workspaces-manager/hyprland-dynamic-workspaces-manager.py --delete-current-workspace
$move_current_workspace_windows_to = ~/.config/hypr/hyprland-dynamic-workspaces-manager/hyprland-dynamic-workspaces-manager.py --move-current-workspace-windows-to

# Keybindings - Dynamic workspace manager
bind = $mainMod CTRL, space, exec, $app_launcher
bind = $mainMod CTRL SHIFT, space, exec, $app_launcher_all
bind = $mainMod ALT, space, exec, $window_switcher
bind = $mainMod, X, exec, $rename_workspace
bind = $mainMod, backspace, exec, $delete_current_workspace
bind = $mainMod ALT,  backspace, exec, $move_current_workspace_windows_to
bind = $mainMod CTRL, backspace, exec, $move_current_workspace_windows_to
bind = $mainMod, Z, exec, $workspace_switcher
bind = $mainMod SHIFT, Z, exec, $move_window_to_workspace

bind = $mainMod, tab, workspace, m-1
bind = $mainMod SHIFT, tab, workspace, m+1

Switch to a workspace, WindowsKey+Z, then type one from the list.
Create a NEW workspace and switch to it, WindowsKey+Z, then type a new name. You can even use spaces in the workspace name :).
Move a window to another workspace WindowsKey+Shift+Z, then type the workspace name.
Move a window to a NEW workspace WindowsKey+Shift+Z, then type the name of the new workspace.
Rename a workspace WindowsKey+X
Delete the current workspace and move all windows on the current workspace to another workspace WindowsKey+Backspace
Move all windows on the current workspace to another workspace WindowsKey+Ctrl+Backspace OR WindowsKey+Alt+Backspace, then type the name of the workspace.
Move all windows on a special workspace to the current workspace below it: WindowsKey+Backspace whilst on the special workspace.
Move all windows on a special workspace to another workspace WindowsKey+Ctrl+Backspace OR WindowsKey+Alt+Backspace
App launcher WindowsKey+Ctrl+Space
App launcher including terminal commands WindowsKey+Ctrl+Shift+Space
Window Switcher - WindowsKey+Alt+Space
Next Workspace - WindowsKey+Tab
Previous Workspace - WindowsKey+Shift+Tab

Why are you using Win+Alt and Win+Ctrl?

I like using both Ctrl+Win keys together, and Alt+Win keys together. It makes launching apps and switching windows feel like the same action.

Can I still use the normal workspace hotkeys 1-9?

Yes. You can still use WindowsKey+1 to access the first workspace. You can rename this workspace and you can still switch to it using the normal workspace keybinding.

How do I delete a workspace?

You don't need to manually delete a workspace. Once a workspace is empty, and we switch to another, Hyprland will delete empty workspaces for us. You can however delete a workspace and move all windows on the current workspace to another.

Delete workspace with windows on it.

See the option --delete-current-workspace

Moves all windows to a random workspace, deletes the current workspace, and then switches to the workspace we dumped the windows on to. If you are on a special workspace, the windows will be moved to the current workspace which is underneath it.

Delete workspace and move windows to a workspace using a prompt

See the option --move-current-workspace-windows-to

User selects the workspace to move all the current workspace's windows to. Moves all windows to another workspace, deletes the current workspace, and then switches to the workspace we dumped the windows on to.

Issues / Bugs

Glitchy: Deleting a workspace / moving all windows to another workspace
- affects --delete-current-workspace and --move-current-workspace-windows-to
- hyprctl only lets us move an active window to another workspace.
- This script will move the current active window, wait 0.1 seconds for the window to disappear, then move the next active window and so on.
- It means we need to wait for all windows to be moved before doing anything else.
- Open an issue if this is causing problems and maybe I can get hyprctl to move the windows all at once.
In older versions of Hyperland(0.45.0 and below): New workspace name not set: switching to a new workspace will not name it properly, instead the workspace gets the name of its ID number which is a negative number like -1337. You'll have to rename it manually. Bug fixed in newer Hyprland versions.
You can have multiple workspaces with the same name, but can only switch to one of those workspaces.
- It's only an issue if you are creating workspaces manually with hyprctl. Most people can ignore this.
- Hyprland's method that I use doesn't allow us to switch to a workspace by its ID number, so we have to use the workspace name, obviously this is an issue if we have multiple workspaces with the same name.
- Just name each workspace differently as you should be doing anyway.
- You can rename the workspaces.

Themes

There quite a few themes available :).

You can view all of these by running the theme-previewer.sh script. Warning! The theme-previewer.sh script will spam you out with rofi launchers. It will ask if you want to continue. Press ESC key multiple times to quit each rofi instance and view each theme.

You can set the theme using the --theme argument, followed by one of these:

nord
rounded-blue-dark
rounded-gray-dark
rounded-green-dark
rounded-nord-dark
rounded-orange-dark
rounded-pink-dark
rounded-purple-dark
rounded-red-dark
rounded-yellow-dark
simple-tokyonight
spotlight-dark
spotlight
squared-everforest
squared-material-red
squared-nord

Custom Theme

You can pass a custom rofi theme by using the --theme-file argument and passing it a path to the file.

Usage

usage: hyprland-dynamic-workspaces-manager.py
        [-h]
        [--window-switcher]
        [--workspace-switcher]
        [--move-window]
        [--rename-workspace]
        [--delete-current-workspace]
        [--move-current-workspace-windows-to]
        [--auto-select]
        [--no-auto-select]
        [--theme nord,
                rounded-blue-dark,
                rounded-gray-dark,
                rounded-green-dark,
                rounded-nord-dark,
                rounded-orange-dark,
                rounded-pink-dark,
                rounded-purple-dark,
                rounded-red-dark,
                rounded-yellow-dark,
                simple-tokyonight,
                spotlight-dark,
                spotlight,
                squared-everforest,
                squared-material-red,
                squared-nord
        ]
        [--theme-file THEME_FILE]

options:
  -h, --help            show this help message and exit
  --window-switcher     Switch focus to another window.
  --workspace-switcher  Switch to another workspace.
  --move-window         Move the focused window to another workspace.
  --rename-workspace    Rename the current workspace.

  --delete-current-workspace
                        Moves all windows to a random workspace, deletes the current workspace, and then switches to the workspace we dumped the windows on to.
                        If you are on a special workspace, the windows will be moved to the current workspace that is underneath it.

  --move-current-workspace-windows-to
                        User selects the workspace to move all the current workspace's windows to. Moves all windows to another workspace, deletes the current workspace, and then switches to the workspace we dumped the
                        windows on to.

  --auto-select         Will automatically select an entry in the list as you type (default: False)
  --no-auto-select      Will NOT automatically select an entry in the list as you type (default: True)
  --theme {nord,rounded-blue-dark,rounded-gray-dark,rounded-green-dark,rounded-nord-dark,rounded-orange-dark,rounded-pink-dark,rounded-purple-dark,rounded-red-dark,rounded-yellow-dark,simple-tokyonight,spotlight-dark,spotlight,squared-everforest,squared-material-red,squared-nord}
                        Set the theme
  --theme-file THEME_FILE
                        Select a custom theme file for rofi. E.g. --theme-file "~/path/to/your/theme.rasi"

Credit

Thanks to Newmanls for the collection of rofi themes that I ship with this. https://github.com/newmanls/rofi-themes-collection

Name		Name	Last commit message	Last commit date
Latest commit History 36 Commits
rofi-themes-collection		rofi-themes-collection
Demo.mp4		Demo.mp4
LICENSE		LICENSE
README.md		README.md
hyprland-dynamic-workspaces-manager.py		hyprland-dynamic-workspaces-manager.py
theme-previewer.sh		theme-previewer.sh

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Hyprland Dynamic Workspaces Manager Script

Features

Keybindings

Dependencies:

Why does it require rofi(the wayland fork) instead of wofi?

Installation

Install dependencies

Download this script

Use case

FAQ

How do I use this?

Why are you using Win+Alt and Win+Ctrl?

Can I still use the normal workspace hotkeys 1-9?

How do I delete a workspace?

Delete workspace with windows on it.

Delete workspace and move windows to a workspace using a prompt

Issues / Bugs

Themes

Custom Theme

Usage

Credit

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

Hyprland Dynamic Workspaces Manager Script

Features

Keybindings

Dependencies:

Why does it require rofi(the wayland fork) instead of wofi?

Installation

Install dependencies

Download this script

Use case

FAQ

How do I use this?

Why are you using Win+Alt and Win+Ctrl?

Can I still use the normal workspace hotkeys 1-9?

How do I delete a workspace?

Delete workspace with windows on it.

Delete workspace and move windows to a workspace using a prompt

Issues / Bugs

Themes

Custom Theme

Usage

Credit

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages