.\" Generated by scdoc 1.11.2
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "swaynag" "5" "2024-03-10"
.P
.SH NAME
.P
swaynag - swaynag configuration file
.P
.SH SYNOPSIS
.P
$HOME/.\&swaynag/config, $XDG_CONFIG_HOME/swaynag/config,
SYSCONFDIR/swaynag/config
.P
.SH CONFIG FILE
.P
At the top of the config file, \fIswaynag\fR options can be set using the format
\fIlong-option=value\fR.\& These will be used as default values if \fIswaynag\fR is not
given the option.\& This can be useful for setting a preferred font, output, and
edge.\&
.P
Below the options, custom types may be defined.\& To define a type, use the
following format:
.P
.nf
.RS 4
[name-of-type]
option=value
.fi
.RE
.P
All colors may be given in the form \fIRRGGBB\fR or \fIRRGGBBAA\fR.\& The following
colors can be set:
.P
\fBbackground=<color>\fR
.RS 4
The background color for \fIswaynag\fR.\&
.P
.RE
\fBborder=<color>\fR
.RS 4
The color to use for borders of buttons.\&
.P
.RE
\fBborder-bottom=<color>\fR
.RS 4
The color of the border line at the bottom of \fIswaynag\fR.\&
.P
.RE
\fBbutton-background=<color>\fR
.RS 4
The background color for the buttons.\&
.P
.RE
\fBtext=<color>\fR
.RS 4
The color of the text.\&
.P
.RE
\fBbutton-text=<color>\fR
.RS 4
The color of the button text.\&
.P
.RE
The following sizing options can also be set:
.P
\fBborder-bottom-size=<size>\fR
.RS 4
Set the thickness of the bottom border.\&
.P
.RE
\fBmessage-padding=<padding>\fR
.RS 4
Set the padding for the message.\&
.P
.RE
\fBdetails-background=<color>\fR
.RS 4
The background color for the details.\&
.P
.RE
\fBdetails-border-size=<size>\fR
.RS 4
Set the thickness for the details border.\&
.P
.RE
\fBbutton-border-size=<size>\fR
.RS 4
Set the thickness for the button border.\&
.P
.RE
\fBbutton-gap=<gap>\fR
.RS 4
Set the size of the gap between buttons.\&
.P
.RE
\fBbutton-dismiss-gap=<gap>\fR
.RS 4
Set the size of the gap between the dismiss button and another button.\&
.P
.RE
\fBbutton-margin-right=<margin>\fR
.RS 4
Set the margin from the right of the dismiss button to edge.\&
.P
.RE
\fBbutton-padding=<padding>\fR
.RS 4
Set the padding for the button text.\&
.P
.RE
Additionally, the following options can be assigned a default per-type:
.P
\fBedge=top|bottom\fR
.RS 4
Set the edge to use.\&
.P
.RE
\fBlayer=overlay|top|bottom|background\fR
.RS 4
Set the layer to use.\&
.P
.RE
\fBfont=<font>\fR
.RS 4
Set the font to use.\&
.P
.RE
\fBoutput=<output>\fR
.RS 4
Set the output to use.\& This should be the name of a \fIxdg_output\fR.\&
.P
.RE
.SH EXAMPLE
.P
.nf
.RS 4
font=Monospace 12
edge=bottom

[green]
edge=top
background=00AA00
border=006600
border-bottom=004400
text=FFFFFF
button-background=00CC00
message-padding=10
.fi
.RE
.P
.SH SEE
.P
swaynag(1)