Configuration

Configuration

$ custard - configure ([setting name] [setting value])...

The configure command allows you to change variables that are used by the window manager as a whole.

Any amount of setting name and value pairs can be provided to the controller, and all of the settings will be changed.

Setting name	Default value	Accepted inputs	Behavior
grid.rows	2	Any positive integer	Sets the default amount of rows for a grid
grid.columns	3	Any positive integer	Sets the default amount of columns for a grid
grid.margins	0	Any positive integer	Sets the default grid gap size
grid.margin.top	0	Any position integer	Sets the default grid offset from the top of the screen
grid.margin.bottom	0	Any position integer	Sets the default grid offset from the bottom of the screen
grid.margin.left	0	Any position integer	Sets the default grid offset from the left of the screen
grid.margin.right	0	Any position integer	Sets the default grid offset from the right of the screen
borders	0	Any positive integer	Sets the default amount of borders for a window. Currently a maximum of three borders is supported.
border.size.inner	0	Any positive integer	Sets the default inner-border size for a window. Unused for single-border windows
border.size.outer	0	Any positive integer	Sets the default inner-border size for a window
border.color.focused	#FFFFFFFF	Any hexadecimal color, with or without an alpha channel	Sets the default focused color for a window border
border.color.unfocused	#676767FF	Any hexadecimal color, with or without an alpha channel	Sets the default unfocused color for a window border
border.color.background	#000000FF	Any hexadecimal color, with or without an alpha channel	Sets the default background color for a window. Also used as a border background color for two or more borders
border.colors.flipped	False	Any boolean (True or False)	Flips border colors between the focus-state color and background color
workspaces	1	Any positive integer	Sets the amount of available workspaces. Workspaces are available per monitor

Example usage

$ custard - configure \
    grid.rows               2 \
    grid.columns            3 \
    grid.margins            0 \
    grid.margin.top         0 \
    grid.margin.bottom      0 \
    grid.margin.left        0 \
    grid.margin.right       0 \
    borders                 0 \
    border.size.outer       0 \
    border.size.inner       0 \
    border.color.focused    '#FFFFFFFF' \
    border.color.unfocused  '#676767FF' \
    border.color.background '#000000FF'