Sway/i3/Hyprland workspaces with style:
This application will dynamically rename your workspaces to indicate which programs are running in each one.
A picture is better than a thousand words!
Note: if you are using waybar and want the workspaces to be displayed with their number, like in the screenshot, please set "format": "{icon}",
. See the waybar wiki for more information on configuring waybar.
Install the latest published version from crates.io with
cargo install workstyle
Or for Arch Linux users, install the freshest git version with your favourite AUR helper, e.g.
yay -S workstyle-git
Simply run the executable:
workstyle
workspace --help
will give you some more context.
Add this line to your sway config:
exec_always --no-startup-id workstyle &> /tmp/workstyle.log
You may also want to control the log level with the environment variable: RUST_LOG to error, info or debug.
Note that since your workspaces will be renamed all the time, you should configure your keybindings to use numbered workspaces instead of assuming that the name is the number: Prefer
bindsym $mod+1 workspace number 1
over
bindsym $mod+1 workspace 1
Add this line to your Hyprland config:
exec-once = workstyle &> /tmp/workstyle.log
Alternatively you can use the workstyle.service file to configure systemd to automatically start workstyle after you login
Copy workstyle.service
to $HOME/.config/systemd/user/
and run
systemctl --user enable workstyle.service
systemctl --user start workstyle.service
The main configuration consists of deciding which icons to use for which applications.
The config file is located at ${XDG_CONFIG_HOME}/workstyle/config.toml
or /etc/xdg/workstyle/config.toml
(the former takes precedence over the latter). It will be generated if missing. Read the generated file. The syntax is in TOML and should be pretty self-explanatory.
When an app isn't recogised in the config, workstyle
will log the application name as an error.
Simply add that string (case insensitive) to your config file, with an icon of your choice.
If no matching icon can be found in the config, a blank space will be used. To override this, set the default icon in the config as per below:
[other]
fallback_icon = "your icon"
If you prefer not to have multiple copies of the same icon when there are multiple matching windows, set this config option:
[other]
deduplicate_icons = true
Note that the crate find_unicode
can help find a unicode character directly from the command line. It now supports all of nerdfonts unicode space.
- For i3/sway
"modules-left": ["sway/workspaces"],
"sway/workspaces": {
"format": "{icon}",
},
- For hyprland
"modules-left": ["wlr/workspaces"],
"wlr/workspaces": {
"format": "{icon}",
},