labwc/docs/labwc-config.5.scd

88 lines
2.1 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
# 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.
Place can be any of:
- ActiveWindow - titlebar of active window
*<theme><font place=""><name>*
Describes font name. Default is sans.
*<theme><font place=""><size>*
Font size in pixels. Default is 8.
# 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)
2021-03-30 22:39:52 +01:00
Default key-binds if no rc.xml is found:
2021-03-05 22:14:02 +00:00
```
<keyboard>
<keybind key="A-Escape">
<action name="Exit"/>
</keybind>
<keybind key="A-Tab">
<action name="NextWindow"/>
</keybind>
<keybind key="A-F3">
<action name="Execute">
<command>bemenu-run</command>
</action>
</keybind>
<keyboard>
```
# SEE ALSO
labwc(1), labwc-actions(5), labwc-theme(5)