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.
- Create a workspace with any name that you want.
- Rename a workspace.
- Move a window to any workspace.
- Switch to any window.
Demo.mp4
These are my prefered 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 |
- 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
- 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-selectargument.
- 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
-
The rofi wayland fork found here.
-
Arch users use AUR package rofi-lbonn-wayland-only-git
-
install python3 using your package manager
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.
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.
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
# 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, 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
- 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
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.
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.
You don't! Once a workspace is empty, Hyprland will delete it after you switch to another workspace. This really does help with keeping our workspaces neat and condensed.
- New workspace name not set: In older versions of Hyperland(0.45.0 and below), 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.
- Only an issue if you are creating workspaces with hyprctl.
- 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.
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
You can pass a custom rofi theme by using the --theme-file argument and passing it a path to the file.
usage: hyprland-dynamic-workspaces-manager.py
[--window-switcher]
[--workspace-switcher]
[--move-window]
[--rename-workspace]
[--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.
--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 theme_name Set the theme
--theme-file THEME_FILE Select a custom theme file for rofi. E.g. --theme-file "~/path/to/your/theme.rasi"
Thanks to Newmanls for the collection of rofi themes that I ship with this. https://github.com/newmanls/rofi-themes-collection