swaycons

Window Icons in Sway with Nerd Fonts!

Go from to

Installation

Prerequisites

1. Install Rust
2. Sway
3. A font with icons and pango enabled in your sway config. The default config assumes a nerd font is used. The config should look something like this:

font pango:FuraCode Nerd Font 11

Install Swaycons

1. cargo install swaycons

Usage

• run swaycons
• recommend adding something like exec swaycons to sway config

Config

• by default the config file should be placed at ~/.config/swaycons/config.toml, but it will look for swaycons/config.toml in whatever your configured XDG config folder is.
• the default config is included in the binary and can be viewed here
• Your custom config will add to the default config
• The best place to find icons for nerd fonts is the nerd fonts cheat sheet
• learn about pango Attributes here
• to find the app_id or class I recommend running swaymsg -t get_tree | less and using / to search for the app you're looking for
• There are a lot of great resources to learn how to write regular expressions out there. The examples in the title section will cover most simple cases though.
• Here is an example with comments:

```toml

global section. all windows will default to these settings

[global] color = "#FFFFFF" # this must be a valid color focusedcolor = "#FFFFFF" # to disable a focusedcolor set this to "" icon = "类" # to disable a default icon just set this to "" size = "14pt" # must be a valid pango size value

appid section. This does an exact string comparison to the appid or

windowproperties.class value reported in swaymsg -t gettree for the window

It will be appid for wayland apps and windowproperties.class for X11 apps

[app_id] chromium = { icon = "", color = "#a1c2fa", size = "13pt" } firefox = { icon = "", color = "#ff8817" } foot = { icon = "" } neovide = { icon = "", color = "#8fff6d" }

This does a regex match on the window title. Matches from this section

will take precedence over matches from the app_id section. A very basic

algorithm is used to select the more exact regex if there are multiple

matches. If 1 regex contains another it will choose the longer one. For

instance mail\.google\.com and google\.com/maps will be chosen over

google\.com

[title]

escape . for an exact match. Normally . matches any character

"crates\.io" = { icon = "", color = "#ffc933" } "github\.com" = { icon = "" } "google\.com" = { icon = "", color = "#4285f4" } "google\.com/maps" = { icon = "﫴", color = "#4caf50" } "mail\.google\.com" = { icon = "", color = "#ad1f1c" }

use | for or

"sr\.ht|sourcehut\.org" = { icon = "" }

can do an or around just a substring with (a|b)

"travis-ci\.(com|org)" = { icon = "", color = "#cd324a" }

The app_id setting means that this will only match if both the title matches

the regex and the appid or windowproperties.class equals one of the values

provided in the app_id array

For example this allows a vim logo in the terminal but keeps a github logo

when viewing a github page with vim in the repository name

vim = { app_id = ["foot", "Alacritty"], icon = "", color = "#8fff6d" } ```

Using Sway Tabs for Firefox

This plugin is extremely useful when using sway tabs instead of browser tabs. To get this working properly with Firefox a few steps and plugins are necessary:

1. Open Firefox Settings and Disable Open links in tabs instead of new windows
2. Install Tab-less from Firefox Add-ons
3. Install Add URL To Window Title from Firefox Add-ons
   • Open the settings for this plugin, check Show the full URL? and hit Save Settings
4. Hide the tab bar - directions are in the sidebery github wiki here: https://github.com/mbnuqw/sidebery/wiki/Firefox-Styles-Snippets-(via-userChrome.css)#firefox-styles-snippets-via-userchromecss