mirror of
https://github.com/labwc/labwc.git
synced 2025-11-03 09:01:51 -05:00
b7573c8d36
This is an addition to the openbox specification and provides a way to keep config files simpler whilst allowing user-specific keybinds. docs/rc.xml shows a simple config file with <default /> docs/rc.xml.full shows the full config
94 lines
2.5 KiB
Markdown
94 lines
2.5 KiB
Markdown
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
|
|
|
|
Configuration must be wrapped in a <labwc_config> root-node.
|
|
|
|
# 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.
|
|
|
|
*<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
|
|
|
|
# THEME
|
|
|
|
*<theme><name>*
|
|
The name of the Openbox theme to use. Default is Clearlooks-3.4
|
|
|
|
*<theme><cornerRadius>*
|
|
The radius of server side decoration top corners. Default is 8.
|
|
|
|
*<theme><font place="">*
|
|
The font to use for a specific element of a window, menu or OSD.
|
|
Places can be any of:
|
|
- ActiveWindow - titlebar of active window
|
|
- MenuItem - menu item (currently only root menu)
|
|
If no place attribute is provided, the setting will be applied to all
|
|
places.
|
|
|
|
*<theme><font place=""><name>*
|
|
Describes font name. Default is sans.
|
|
|
|
*<theme><font place=""><size>*
|
|
Font size in pixels. Default is 10.
|
|
|
|
# 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.
|
|
|
|
```
|
|
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
|
|
```
|
|
|
|
# SEE ALSO
|
|
|
|
labwc(1), labwc-actions(5), labwc-theme(5)
|