Monitors

Monitor Configuration

custard uses a virtual grid to size and position windows on the screen.

custard can provide global settings for monitors, such as grid settings, or focused workspaces, but these settings have the ability to be set per monitor.

To configure a monitor output's settings you must use the match command. Unlike window matching, monitor matching is an exact equivalency comparison, not a regular expression match.

custard - match monitor 'name' ([setting name] [setting value])...

Setting name	Default value	Accepted inputs	Behavior
grid.rows	2	Any positive integer	Sets the amount of rows for a given monitors grid
grid.columns	3	Any positive integer	Sets the amount of columns for a given monitors grid
grid.margins	0	Any positive integer	Sets the gap size for a given monitors grid
grid.margin.top	0	Any position integer	Sets the grid offset from the top of the monitor
grid.margin.bottom	0	Any position integer	Sets the grid offset from the bottom of the monitor
grid.margin.left	0	Any position integer	Sets the grid offset from the left of the monitor
grid.margin.right	0	Any position integer	Sets the grid offset from the right of the monitor

Example

custard - match monitor 'LVDS-0' \
    grid.rows       8 \
    grid.columns    6 \
    grid.margin.top 32

Workspaces

Workspaces in custard are per monitor. To change the focused workspace for a monitor your cursor must be on that monitor and the workspace command be issued.

custard - workspace [workspace number]

There are more workspaces available to a user in custard than one would ever feasibly need. This is because a workspace isn't more than a sort of tag on a window. A user can place a window in any of workspace 1 to 4,294,967,295. A recommendation is made that a user use at most 10 workspaces though because they're the easiest to switch to-and from given that there are 10 keys that can be used to easily switch workspaces with a keybind daemon (1-9, 0).

Example

custard - workspace 3