mirror of
				https://github.com/swaywm/sway.git
				synced 2025-11-03 09:01:43 -05:00 
			
		
		
		
	
		
			
				
	
	
		
			100 lines
		
	
	
	
		
			2 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			100 lines
		
	
	
	
		
			2 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
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.
 | 
						|
 | 
						|
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-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.
 | 
						|
 | 
						|
*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)
 |