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)