Change Workspace Icons

Learn how to set custom icons for each workspace.

Adding icons to workspaces can give your desktop a nice and functional look.

Finding icons

Icons are actually characters from fonts installed by Regolith looks. Each look comes with a specific icon font. The icon font is defined in the typeface_bar variable in the typeface config file. For example, the look Cahuella uses the Material Design Icons font (see file /etc/regolith/styles/cahuella/typeface).

You can browse the icon font using the Gnome Character Map application (gucharmap package):

  1. Open Gnome Character Map.
  2. Select your icon font in the top left combo.
  3. In the script pane select Common.
  4. Scroll down the characters pane until you find the icons.
  5. Double click on the icon you are looking to use and press the Copy button (bottom right).

Tip: the icons are ordered alphabetically.

Changing icons

Follow these steps to override the default workspace label with your own:

  1. Find the character you want to use and copy to the clipboard. This example will use the Sigma glyph from Material Design Icons font ().
  2. Add a line to your Xresource overrides file with the workspace number and character you wish to use:
$ echo " 6:" >> ~/.config/regolith/Xresources
  1. Refresh your UI:
$ regolith-look refresh

In i3, workspace labels are only updated when a workspace is created. Ensure you're creating an new workspace 6 if following the example above:

Adding support for icon fonts in text editors


  • Append the name of the icon font to Settings > Editor > Font Familly.
  • Example: Menlo, Consolas, DejaVu Sans Mono, monospace, Material Design Icons

Further Reading

See the reference page for configurations for more details about config files in Regolith.

Last modified June 30, 2020: Pt pt translation (#32) (d488ba93)