| xsession.windowManager.i3.config.assigns | An attribute set that assigns applications to workspaces based
on criteria.
| attribute set of list of attribute set of (string or boolean) |
| xsession.windowManager.i3.config.bars.*.colors.activeWorkspace | Border, background and text color for a workspace button when the workspace is active.
| null or (submodule) |
| xsession.windowManager.i3.config.bars.*.colors.background | Background color of the bar. | null or string |
| xsession.windowManager.i3.config.bars.*.colors.bindingMode | Border, background and text color for the binding mode indicator | null or (submodule) |
| xsession.windowManager.i3.config.bars.*.colors.focusedBackground | Background color of the bar on the currently focused monitor output. | null or string |
| xsession.windowManager.i3.config.bars.*.colors.focusedSeparator | Text color to be used for the separator on the currently focused monitor output. | null or string |
| xsession.windowManager.i3.config.bars.*.colors.focusedStatusline | Text color to be used for the statusline on the currently focused monitor output. | null or string |
| xsession.windowManager.i3.config.bars.*.colors.focusedWorkspace | Border, background and text color for a workspace button when the workspace has focus.
| null or (submodule) |
| xsession.windowManager.i3.config.bars.*.colors.inactiveWorkspace | Border, background and text color for a workspace button when the workspace does not
have focus and is not active.
| null or (submodule) |
| xsession.windowManager.i3.config.bars.*.colors.separator | Text color to be used for the separator. | null or string |
| xsession.windowManager.i3.config.bars.*.colors.statusline | Text color to be used for the statusline. | null or string |
| xsession.windowManager.i3.config.bars.*.colors.urgentWorkspace | Border, background and text color for a workspace button when the workspace contains
a window with the urgency hint set.
| null or (submodule) |
| xsession.windowManager.i3.config.bars.*.colors | Bar color settings. All color classes can be specified using submodules
with 'border', 'background', 'text', fields and RGB color hex-codes as values.
See default values for the reference.
Note that 'background', 'status', and 'separator' parameters take a single RGB value.
See <https://i3wm.org/docs/userguide.html#_colors>.
| submodule |
| xsession.windowManager.i3.config.bars.*.command | Command that will be used to start a bar. | string |
| xsession.windowManager.i3.config.bars.*.extraConfig | Extra configuration lines for this bar. | strings concatenated with "\n" |
| xsession.windowManager.i3.config.bars.*.fonts | Font configuration for this bar. | (list of string) or (submodule) |
| xsession.windowManager.i3.config.bars.*.hiddenState | The default bar mode when 'bar.mode' == 'hide'. | null or one of "hide", "show" |
| xsession.windowManager.i3.config.bars.*.id | Specifies the bar ID for the configured bar instance.
If this option is missing, the ID is set to bar-x, where x corresponds
to the position of the embedding bar block in the config file.
| null or string |
| xsession.windowManager.i3.config.bars.*.mode | Bar visibility mode. | null or one of "dock", "hide", "invisible" |
| xsession.windowManager.i3.config.bars.*.position | The edge of the screen i3bar should show up. | null or one of "top", "bottom" |
| xsession.windowManager.i3.config.bars.*.statusCommand | Command that will be used to get status lines. | null or string |
| xsession.windowManager.i3.config.bars.*.trayOutput | Where to output tray. | null or string |
| xsession.windowManager.i3.config.bars.*.trayPadding | Sets the pixel padding of the system tray.
This padding will surround the tray on all sides and between each item.
| null or signed integer |
| xsession.windowManager.i3.config.bars.*.workspaceButtons | Whether workspace buttons should be shown or not. | null or boolean |
| xsession.windowManager.i3.config.bars.*.workspaceNumbers | Whether workspace numbers should be displayed within the workspace buttons. | null or boolean |
| xsession.windowManager.i3.config.bars | i3 bars settings blocks. Set to empty list to remove bars completely.
| list of (submodule) |
| xsession.windowManager.i3.config.colors.background | Background color of the window. Only applications which do not cover
the whole area expose the color.
| string |
| xsession.windowManager.i3.config.colors.focused | A window which currently has the focus. | submodule |
| xsession.windowManager.i3.config.colors.focusedInactive | A window which is the focused one of its container,
but it does not have the focus at the moment.
| submodule |
| xsession.windowManager.i3.config.colors.placeholder | Background and text color are used to draw placeholder window
contents (when restoring layouts). Border and indicator are ignored.
| submodule |
| xsession.windowManager.i3.config.colors.unfocused | A window which is not focused. | submodule |
| xsession.windowManager.i3.config.colors.urgent | A window which has its urgency hint activated. | submodule |
| xsession.windowManager.i3.config.colors | Color settings. All color classes can be specified using submodules
with 'border', 'background', 'text', 'indicator' and 'childBorder' fields
and RGB color hex-codes as values. See default values for the reference.
Note that 'i3.config.colors.background' parameter takes a single RGB value.
See <https://i3wm.org/docs/userguide.html#_changing_colors>.
| submodule |
| xsession.windowManager.i3.config.defaultWorkspace | The default workspace to show when i3 is launched.
This must to correspond to the value of the keybinding of the default workspace.
| null or string |
| xsession.windowManager.i3.config.floating.border | Floating windows border width. | signed integer |
| xsession.windowManager.i3.config.floating.criteria | List of criteria for windows that should be opened in a floating mode. | list of attribute set of (string or boolean) |
| xsession.windowManager.i3.config.floating.modifier | Modifier key or keys that can be used to drag floating windows. | string |
| xsession.windowManager.i3.config.floating.titlebar | Whether to show floating window titlebars. | boolean |
| xsession.windowManager.i3.config.floating | Floating window settings. | submodule |
| xsession.windowManager.i3.config.focus.followMouse | Whether focus should follow the mouse. | boolean |
| xsession.windowManager.i3.config.focus.forceWrapping | Whether to force focus wrapping in tabbed or stacked containers.
This option is deprecated, use {option}`focus.wrapping` instead.
| boolean |
| xsession.windowManager.i3.config.focus.mouseWarping | Whether mouse cursor should be warped to the center of the window when switching focus
to a window on a different output.
| boolean |
| xsession.windowManager.i3.config.focus.newWindow | This option modifies focus behavior on new window activation.
See <https://i3wm.org/docs/userguide.html#focus_on_window_activation>
| one of "smart", "urgent", "focus", "none" |
| xsession.windowManager.i3.config.focus.wrapping | Whether the window focus commands automatically wrap around the edge of containers.
See <https://i3wm.org/docs/userguide.html#_focus_wrapping>
| one of "yes", "no", "force", "workspace" |
| xsession.windowManager.i3.config.focus | Focus related settings. | submodule |
| xsession.windowManager.i3.config.fonts | Font configuration for window titles, nagbar... | (list of string) or (submodule) |
| xsession.windowManager.i3.config.gaps.bottom | Bottom gaps value. | null or signed integer |
| xsession.windowManager.i3.config.gaps.horizontal | Horizontal gaps value. | null or signed integer |
| xsession.windowManager.i3.config.gaps.inner | Inner gaps value. | null or signed integer |
| xsession.windowManager.i3.config.gaps.left | Left gaps value. | null or signed integer |
| xsession.windowManager.i3.config.gaps.outer | Outer gaps value. | null or signed integer |
| xsession.windowManager.i3.config.gaps.right | Right gaps value. | null or signed integer |
| xsession.windowManager.i3.config.gaps.smartBorders | This option controls whether to disable container borders on
workspace with a single container.
| one of "on", "off", "no_gaps" |
| xsession.windowManager.i3.config.gaps.smartGaps | This option controls whether to disable all gaps (outer and inner)
on workspace with a single container.
| boolean |
| xsession.windowManager.i3.config.gaps.top | Top gaps value. | null or signed integer |
| xsession.windowManager.i3.config.gaps.vertical | Vertical gaps value. | null or signed integer |
| xsession.windowManager.i3.config.gaps | Gaps related settings.
| null or (submodule) |
| xsession.windowManager.i3.config.keybindings | An attribute set that assigns a key press to an action using a key symbol.
See <https://i3wm.org/docs/userguide.html#keybindings>.
Consider to use `lib.mkOptionDefault` function to extend or override
default keybindings instead of specifying all of them from scratch.
| attribute set of (null or string) |
| xsession.windowManager.i3.config.keycodebindings | An attribute set that assigns keypress to an action using key code.
See <https://i3wm.org/docs/userguide.html#keybindings>.
| attribute set of (null or string) |
| xsession.windowManager.i3.config.menu | Default launcher to use. | string |
| xsession.windowManager.i3.config.modes | An attribute set that defines binding modes and keybindings
inside them
Only basic keybinding is supported (bindsym keycomb action),
for more advanced setup use 'i3.extraConfig'.
| attribute set of attribute set of string |
| xsession.windowManager.i3.config.modifier | Modifier key that is used for all default keybindings. | one of "Shift", "Control", "Mod1", "Mod2", "Mod3", "Mod4", "Mod5" |
| xsession.windowManager.i3.config.startup.*.always | Whether to run command on each i3 restart. | boolean |
| xsession.windowManager.i3.config.startup.*.command | Command that will be executed on startup. | string |
| xsession.windowManager.i3.config.startup.*.notification | Whether to enable startup-notification support for the command.
See {option}`--no-startup-id` option description in the i3 user guide.
| boolean |
| xsession.windowManager.i3.config.startup.*.workspace | Launch application on a particular workspace. DEPRECATED:
Use [](#opt-xsession.windowManager.i3.config.assigns)
instead. See <https://github.com/nix-community/home-manager/issues/265>.
| null or string |
| xsession.windowManager.i3.config.startup | Commands that should be executed at startup.
See <https://i3wm.org/docs/userguide.html#_automatically_starting_applications_on_i3_startup>.
| list of (submodule) |
| xsession.windowManager.i3.config.terminal | Default terminal to run. | string |
| xsession.windowManager.i3.config.window.border | Window border width. | signed integer |
| xsession.windowManager.i3.config.window.commands.*.command | i3wm command to execute. | string |
| xsession.windowManager.i3.config.window.commands.*.criteria | Criteria of the windows on which command should be executed.
A value of `true` is equivalent to using an empty
criteria (which is different from an empty string criteria).
| attribute set of (string or boolean) |
| xsession.windowManager.i3.config.window.commands | List of commands that should be executed on specific windows.
See {option}`for_window` i3wm option documentation.
| list of (submodule) |
| xsession.windowManager.i3.config.window.hideEdgeBorders | Hide window borders adjacent to the screen edges. | one of "none", "vertical", "horizontal", "both", "smart" |
| xsession.windowManager.i3.config.window.titlebar | Whether to show window titlebars. | boolean |
| xsession.windowManager.i3.config.window | Window titlebar and border settings. | submodule |
| xsession.windowManager.i3.config.workspaceAutoBackAndForth | Assume you are on workspace "1: www" and switch to "2: IM" using
mod+2 because somebody sent you a message. You don’t need to remember
where you came from now, you can just press $mod+2 again to switch
back to "1: www".
| boolean |
| xsession.windowManager.i3.config.workspaceLayout | The mode in which new containers on workspace level will
start.
| one of "default", "stacking", "tabbed" |
| xsession.windowManager.i3.config.workspaceOutputAssign.*.output | Name(s) of the output(s) from {command}`
i3-msg -t get_outputs
`.
| string or list of string |
| xsession.windowManager.i3.config.workspaceOutputAssign.*.workspace | Name of the workspace to assign.
| string |
| xsession.windowManager.i3.config.workspaceOutputAssign | Assign workspaces to outputs. | list of (submodule) |
| xsession.windowManager.i3.config | i3 configuration options. | null or (submodule) |
| xsession.windowManager.i3.extraConfig | Extra configuration lines to add to ~/.config/i3/config. | strings concatenated with "\n" |
