.\" Generated by scdoc 1.11.0
.\" 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" "2020-11-05"
.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
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-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
\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)