Scroll to navigation

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-08-13