swaync(1)                   General Commands Manual                  swaync(1)

<?><?><?> (NAME)
       swaync - <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> GTK <?><?><?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?> <?><?><?><?><?>

<?><?><?><?> <?><?><?><?><?><?><?> (USAGE)
       swaync [option]

<?><?><?><?><?><?><?><?> (OPTIONS)
       -h, --help
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>

       -v, --version
           <?><?><?> <?><?><?><?>

       -s, --style <CSS file>
           <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> (Stylesheet) <?><?><?><?><?><?>

       --replace
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?> SwayNotificationCenter

       --skip-system-css
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> CSS

       --custom-system-css
           <?><?><?><?><?><?> <?><?> <?><?><?><?> CSS <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> CSS
           <<<?><?><?><?><?><?>>>. <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> CSS

       -c, --config <Config file>
           <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>

<?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       (CONTROL CENTER KEYBOARD SHORTCUTS)
       Up/Down: <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>

       Home: <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>

       End: <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>

       Escape/Caps_Lock: <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>

       Return: <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>

       Delete/BackSpace: <?><?><?><?> <?><?><?><?><?>

       Shift+C: <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>

       Shift+D: <?><?><?><?><?> <?><?><?><?><?> <<<?><?><?><?><?>
       <?><?><?><?><?>>> (Do Not Disturb)

       Buttons 1-9: <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>

       Left click button / actions: <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?>

       Middle/Right click notification: <?><?><?><?> <?><?><?><?><?>

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       /etc/xdg/swaync/config.json <?><?><?><?> <?><?><?><?>. <?><?> <?><?>
       <?><?> <?><?><?><?> ~/.config/swaync/ <?><?><?> <?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> (root) <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> swaync-client
       --reload-config <?><?> <?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> swaync(5) <?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?><?><?><?><?><?> (SCRIPTING)
       <?><?><?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?>:

       1.  <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?>
       2.  <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> `exec` <?>
           <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?>
       3.  <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       4.  <?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?>
       5.  <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>

       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> G_MESSAGES_DEBUG=all swaync
       <?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?> (<?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>).

       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>:

           {
                "scripts": {
                     "example-script": {
                          "exec": "Your shell command or script here...",
                          "app-name": "Notification app-name Regex",
                          "summary": "Notification summary Regex",
                          "body": "Notification body Regex",
                          "urgency": "Low or Normal or Critical",
                          "category": "Notification category Regex"
                     }
                }
                other non scripting properties...
           }

       <?><?><?><?> config.json:

           {
                "scripts": {
                     // This script will only run when Spotify sends a notification containing
                     // that exact summary and body
                     "example-script": {
                          "exec": "~/.config/swaync/myRickRollScript.sh",
                          "app-name": "Spotify"
                          "summary": "Never Gonna Give You Up",
                          "body": "Rick Astley - Whenever You Need Somebody"
                     }
                }
                other non scripting properties...
           }

   <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> (Disable scripting)
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>:

           meson build -Dscripting=false
           ninja -C build
           meson install -C build

<?><?><?><?> Waybar (WAYBAR EXAMPLE)
       <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> NotoSansMono Nerd Font <?><?><?><?>
       <?><?><?><?>

       <?><?><?><?><?><?><?><?> Waybar:

           "custom/notification": {
                "tooltip": false,
                "format": "{icon}",
                "format-icons": {
                     "notification": "<?><span foreground='red'><sup><?></sup></span>",
                     "none": "<?>",
                     "dnd-notification": "<?><span foreground='red'><sup><?></sup></span>",
                     "dnd-none": "<?>",
                     "inhibited-notification": "<?><span foreground='red'><sup><?></sup></span>",
                     "inhibited-none": "<?>",
                     "dnd-inhibited-notification": "<?><span foreground='red'><sup><?></sup></span>",
                     "dnd-inhibited-none": "<?>"
                },
                "return-type": "json",
                "exec-if": "which swaync-client",
                "exec": "swaync-client -swb",
                "on-click": "swaync-client -t -sw",
                "on-click-right": "swaync-client -d -sw",
                "escape": true
           },

       <?><?><?><?> css <?><?><?><?><?><?> Waybar:

           #custom-notification {
                font-family: "NotoSansMono Nerd Font";
           }

                                  2026-03-23                         swaync(1)