labwc/docs/labwc-config.5.scd

95 lines
2.5 KiB
Text
Raw Normal View History

2021-03-05 22:14:02 +00:00
labwc-config(5)
# NAME
labwc - Configuration
# CONFIGURATION
The configuration aims to be compatible with openbox specification, but there
are some differences which are pointed out throughout the man pages.
Adhering to XDG Base Directory Specification, configuration files will
be searched for in the following order:
- ${XDG_CONFIG_HOME:-$HOME/.config}/labwc
- ${XDG_CONFIG_DIRS:-/etc/xdg}/labwc
2021-07-16 17:30:07 +01:00
Configuration must be wrapped in a <labwc_config> root-node.
2021-03-05 22:14:02 +00:00
# GENERAL
*<core><decoration>* [server|client]
Specify server or client side decorations for xdg-shell views. Note
that it is not always possible to turn off client side decorations.
Default is server.
2021-03-05 22:14:02 +00:00
*<core><gap>*
The distance in pixels between views and output edges when using
movement actions, for example MoveToEdge. Default is 0.
# FOCUS
*<focus><followMouse>* [yes|no]
Make focus follow mouse, e.g. focus is given to window under mouse
cursor
*<focus><raiseOnFocus>* [yes|no]
Also raise window to top when focused. Only applies if followMouse is
set
2021-03-05 22:14:02 +00:00
# THEME
*<theme><name>*
The name of the Openbox theme to use. Default is Clearlooks-3.4
2021-03-30 22:39:52 +01:00
*<theme><cornerRadius>*
The radius of server side decoration top corners. Default is 8.
2021-03-05 22:14:02 +00:00
*<theme><font place="">*
The font to use for a specific element of a window, menu or OSD.
2021-07-20 20:06:48 +01:00
Places can be any of:
2021-03-05 22:14:02 +00:00
- ActiveWindow - titlebar of active window
- MenuItem - menu item (currently only root menu)
2021-07-20 20:06:48 +01:00
If no place attribute is provided, the setting will be applied to all
places.
2021-03-05 22:14:02 +00:00
*<theme><font place=""><name>*
Describes font name. Default is sans.
*<theme><font place=""><size>*
Font size in pixels. Default is 10.
2021-03-05 22:14:02 +00:00
# KEYBOARD
*<keyboard><keybind key="">*
Define a key binding in the format *modifier-key*, where supported
modifiers include S (shift); C (control); A (alt); W (super). Unlike
Openbox, multiple space-separated key combinations and key-chains are
not supported.
*<keyboard><keybind key=""><action name="">*
Keybind action. See labwc-action(5)
*<keyboard><default />*
Load the default keybinds listed below. This is an addition to the
openbox specification and provides a way to keep config files simpler
whilst allowing your specific keybinds.
Note that if no rc.xml is found, or if no <keyboard><keybind> entries
exist, the same default keybinds will be loaded even if the <default />
element is not provided.
2021-03-05 22:14:02 +00:00
```
A-Tab - next window
A-Escape - exit
W-Return - alacritty
A-F3 - run bemenu
A-F4 - close window
W-a - toggle maximize
A-<arrow> - move window to edge
2021-03-05 22:14:02 +00:00
```
# SEE ALSO
labwc(1), labwc-actions(5), labwc-theme(5)