Docs

nwwm is configured via a TOML config file, which is by default located at ~/.config/nwwm/config.toml or wherever your config directory is). If no configuration file is present, nwwm will attempt to create one using its defaults.

Options

Option	Description	Default
`border_focused`	the colour of a window's border when focused	`#a9a9a9`
`border_unfocused`	the colour of a window's border when unfocused	`#808080`
`border_width`	the width of a window's border in pixels	`3`
`mod_key`	the modifier key to be used in keybindings	`Mod4`
`gaps_outer`	the width of the outer gaps (between the windows and the edge of the screen) in pixels	`10`
`gaps_inner`	the width of the inner gaps (between each window) in pixels	`10`
`default_layout`	the default tiling layout to be used in each workspace	`masterstack`

mod_key can be set to the following values:

Mod1 - alt
Mod2 - number lock
Mod3 - nothing (don't use this one)
Mod4 - meta (windows / command depending on the keyboard)
Mod5 - alt gr

default_layout can be set to the following values:

masterstack - one window takes up half the screen (the master) and the others are tiled vertically in the other half (the stack)
columns - each window takes up an equal amount of space, divided horizontally
monocle - each window takes up the whole screen, and the currently focused window is brought to the front

Keybindings

Keybindings in nwwm are configured using the following syntax:

keybinds = {
  "modifiers+key" = "action"
}

for example:

"mod+return" = "exec kitty",
"mod+shift+q" = "quit"

Modifiers

mod - whatever is set as mod_key
shift
alt
ctrl - ctrl

Actions

Action	Description	Values
`exec <command>`	runs `<command>`	`<command>` can be any string that represents a valid shell command on your system (e.g. `kitty`, `rofi -show run`)
`closewindow`	closes the currently focused window
`setworkspace <workspace>`	sets the current workspace to `<workspace>`	`<workspace>` can be any positive integer (whole number) greater than one
`movetoworkspace <workspace>`	moves the currently focused window to `<workspace>`	`<workspace>` can be any positive integet (whole number) greater than one
`focus <direction>`	moves window focus	`<direction>` can either be `next` or `last`
`quit`	quits nwwm
`setlayout <layout>`	sets the layout of the current workspace	`<layout>` can be `masterstack`, `monocle`, or `columns`

a full example config can be found in the GitHub repo