swaynag(1)                  General Commands Manual                 swaynag(1)

<?><?><?> (NAME)
       swaynag - <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       swaynag [<?><?><?><?><?><?><?><?>...]

<?><?><?><?><?><?><?><?> (OPTIONS)
       -b, --button <text> <action>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> text <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> action <?><?>
           <?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> TERMINAL <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           action <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?>. <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?>.

       -B, --button-no-terminal <text> <action>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> text <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> action <?><?>
           <?><?><?><?> <?><?><?><?><?><?>. action <?><?> <?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>.
           <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?>.

       -z, --button-dismiss <text> <action>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> text <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> action <?><?>
           <?><?><?><?> <?><?><?><?> <?> swaynag <?><?> <?><?><?><?><?><?><?>.
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?> TERMINAL <?><?><?><?><?>
           <?><?><?> <?><?><?><?><?> action <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?>. <?><?> <?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?>.

       -Z, --button-dismiss-no-terminal <text> <action>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> text <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> action <?><?>
           <?><?><?><?> <?><?><?><?> <?> swaynag <?><?> <?><?><?><?><?><?><?>.
           action <?><?> <?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?>. <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?>.

       -c, --config <path>
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?>: $HOME/.swaynag/config<?>
           $XDG_CONFIG_HOME/swaynag/config <?> SYSCONFDIR/swaynag/config.
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?> debug <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?> long-option=value <?><?><?><?><?>. <?><?><?><?>
           <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?> <?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>. <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> swaynag(5) <?><?>
           <?><?><?><?><?><?>.

       -d, --debug
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>.

       -e, --edge top|bottom
           <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

       -y, --layer overlay|top|bottom|background
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

       -f, --font <font>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

       -h, --help
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>.

       -l, --detailed-message
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?> stdin. <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?>. <?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?>.

       -L, --detailed-button <text>
           <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?>
           <?><?><?><?><?><?><?> Toggle details <?><?><?>.

       -m, --message <msg>
           <?><?><?><?><?> <?><?><?> <?><?><?><?>.

       -o, --output <output>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.
           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> xdg_output
           <?><?><?><?>.

       -s, --dismiss-button <text>
           <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> nagbar.
           <?><?><?><?><?> <?><?><?><?><?><?><?> X <?><?><?>.

       -t, --type <type>
           <?><?><?><?><?> <?><?><?> <?><?><?><?>. <?><?> <?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?>: error <?> warning. <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?><?><?>
           <?><?><?><?><?><?> <?><?> --config <?> swaynag(5)
           <?><?><?><?><?><?> <?><?><?><?>. <?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?>.

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

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (APPEARANCE OPTIONS)
       --background <RRGGBB[AA]>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>.

       --border <RRGGBB[AA]>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?>.

       --border-bottom <RRGGBB[AA]>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       --button-background <RRGGBB[AA]>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?>.

       --text <RRGGBB[AA]>
           <?><?><?><?><?> <?><?><?> <?><?><?>.

       --button-text <RRGGBB[AA]>
           <?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?>.

       --border-bottom-size <size>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       --message-padding <padding>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (padding)
           <?><?><?><?>.

       --details-background <RRGGBB[AA]>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?>.

       --details-border-size <size>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       --button-border-size <size>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       --button-gap <gap>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?>.

       --button-dismiss-gap <gap>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?>.

       --button-margin-right <margin>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?>.

       --button-padding <padding>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (padding) <?><?><?>
           <?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       swaynag(5)

                                  2026-06-23                        swaynag(1)