Configuration

On first run, the program creates the nwg-panel config directory in $XDG_CONFIG_HOME or ~/.config. It also copies sample config and style.css files, as well as the user-definable icon sets (light and dark).

At the moment there's no config GUI. To add / remove / customize panels, you need to edit the config file in a text editor.

Panel settings

key	value	default	description
"output"	string	""	Name of the screen to show the panel on. Leave blank to use the first detected output.
"layer"	string	"top"	Determines if the panel is displayed in front (top) or behind the windows (bottom).
"position"	string	"top"	Panel position can be top or bottom. Side panels are not supported.
"width"	int		Determines the panel width. Delete for the panel to take all the screen width. Set 0 for it to just enclose the content.
"height"	int	0	Set your desired panel height. Set 0 for panel to just enclose the content.
"margin-top"	int	0	Top edge between the panel and windows.
"margin-bottom"	int	0	Bottom edge between the panel and windows.
"padding-horizontal"	int	0	Horizontal padding of the panel content.
"padding-vertical"	int	0	Vertical padding of the panel content.
"spacing"	int	6	Panel row spacing.
"items-padding"	int	0	Horizontal padding of the panel elements.
"css-name"	string	""	Optional name for use in the css file.
"icons"	string	""	Enter "light" for light or "dark" for dark custom icon set. Leave empty for GTK icons.
"modules-left"	array	[]	Modules to display in the left column.
"modules-center"	array	[]	Modules to display in the center column.
"modules-right"	array	[]	Modules to display in the right column.
"modules-left"	array	[]	Modules to display in the left column.
"homogeneous"	bool		If a panel contains some modules-center, the columns width will be set equal ("homogeneous" = true). If for some reason you don't want it to happen, you may set this value false.