swaynag(5)                    File Formats Manual                   swaynag(5)

NAME
       swaynag - swaynag configuration file

SYNOPSIS
       $HOME/.swaynag/config, $XDG_CONFIG_HOME/swaynag/config,
       SYSCONFDIR/swaynag/config

CONFIG FILE
       At the top of the config file, swaynag options can be set using the
       format long-option=value. These will be used as default values if
       swaynag is not given the option. This can be useful for setting a
       preferred font, output, and edge.

       Below the options, custom types may be defined. To define a type, use
       the following format:

           [name-of-type]
           option=value

       All colors may be given in the form RRGGBB or RRGGBBAA. The following
       colors can be set:

       background=<color>
           The background color for swaynag.

       border=<color>
           The color to use for borders of buttons.

       border-bottom=<color>
           The color of the border line at the bottom of swaynag.

       button-background=<color>
           The background color for the buttons.

       text=<color>
           The color of the text.

       button-text=<color>
           The color of the button text.

       The following sizing options can also be set:

       border-bottom-size=<size>
           Set the thickness of the bottom border.

       message-padding=<padding>
           Set the padding for the message.

       details-background=<color>
           The background color for the details.

       details-border-size=<size>
           Set the thickness for the details border.

       button-border-size=<size>
           Set the thickness for the button border.

       button-gap=<gap>
           Set the size of the gap between buttons.

       button-dismiss-gap=<gap>
           Set the size of the gap between the dismiss button and another
           button.

       button-margin-right=<margin>
           Set the margin from the right of the dismiss button to edge.

       button-padding=<padding>
           Set the padding for the button text.

       Additionally, the following options can be assigned a default per-type:

       edge=top|bottom
           Set the edge to use.

       layer=overlay|top|bottom|background
           Set the layer to use.

       font=<font>
           Set the font to use.

       output=<output>
           Set the output to use. This should be the name of a xdg_output.

EXAMPLE
           font=Monospace 12
           edge=bottom

           [green]
           edge=top
           background=00AA00
           border=006600
           border-bottom=004400
           text=FFFFFF
           button-background=00CC00
           message-padding=10

SEE
       swaynag(1)

                                  2024-04-10                        swaynag(5)