mirror of
https://github.com/labwc/labwc.git
synced 2025-11-04 13:30:07 -05:00
7afc189c06
It is better to be explicit with config files and only using those specifically intended for labwc. Whilst compatibility with openbox is intended, there are areas where it just doesn't make sense to include settings intended for openbox, for example in the case of $HOME/.config/openbox/autostart With built-in icons and theme/config settings, it should be easy for new users to get started without spending time on config files anyway.
180 lines
3.8 KiB
Markdown
180 lines
3.8 KiB
Markdown
% labwc(5)
|
|
% Johan Malm
|
|
% 7 Aug, 2020
|
|
|
|
# NAME
|
|
|
|
labwc - Configuration files
|
|
|
|
# CONFIGURATION
|
|
|
|
There are two configuration files which control the look and behaviour of
|
|
labwc, namely rc.xml and themerc. The configuration aims to be compatible with
|
|
Openbox, but there are some differences which are pointed out throughout this
|
|
man page.
|
|
|
|
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`
|
|
|
|
# RC.XML `<lab>`
|
|
|
|
Labwc specific settings which are not present in Openbox.
|
|
|
|
<lab>
|
|
<csd></csd>
|
|
<keyboard>
|
|
<layout></layout>
|
|
</keyboard>
|
|
</lab>
|
|
|
|
`csd` (__boolean__; default no)
|
|
|
|
: Use client-side decorations for xdg-shell views.
|
|
|
|
`keyboard-layout` (__string__; not set by default)
|
|
|
|
: Set `XKB_DEFAULT_LAYOUT`. See xkeyboard-config(7) for details.
|
|
|
|
# RC.XML `<theme>`
|
|
|
|
<theme>
|
|
<name></name>
|
|
<font place="">
|
|
<name></name>
|
|
<size></size>
|
|
</font>
|
|
</theme>
|
|
|
|
`name` (__string__; default Clearlooks)
|
|
|
|
: The name of the Openbox theme to use
|
|
|
|
`font`
|
|
|
|
: The font to use for a specific element of a window, menu or OSD.
|
|
|
|
`place`
|
|
|
|
: Can be `ActiveWindow` (titlebar of active window)
|
|
|
|
`name`
|
|
|
|
: Describes font name (__string__; default sans)
|
|
|
|
`size`
|
|
|
|
: Describes font size in pixels (__integer__; default 8)
|
|
|
|
# RC.XML `<keyboard>`
|
|
|
|
Describe key bindings.
|
|
|
|
<keyboard>
|
|
<keybind key="KEY-COMBINATION">
|
|
ACTION
|
|
</keybind>
|
|
<keyboard>
|
|
|
|
`KEY-COMBINATION`
|
|
|
|
: The key combination to bind to an **ACTION** in the format
|
|
**modifier-key**, where supported **modifiers** include S (shift);
|
|
C (control); A (alt); W (super). Unlike Openbox, multiple space-separated
|
|
**KEY-COMBINATION** and key-chains are not supported.
|
|
|
|
Example:
|
|
|
|
<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>dmenu_run</command>
|
|
</action>
|
|
</keybind>
|
|
<keyboard>
|
|
|
|
Default:
|
|
|
|
If no rc.xml file is found, the following default values will be used:
|
|
|
|
- Alt+Escape: Exit labwc
|
|
- Alt+Tab: Cycle windows
|
|
- Alt+F3: Launch dmenu
|
|
|
|
# ACTIONS
|
|
|
|
Actions are used in key bindings.
|
|
|
|
Action syntax:
|
|
|
|
<action name="NAME">
|
|
OPTION
|
|
</action>
|
|
|
|
where `NAME` is the name of the action as listed below, and `OPTION` is a set
|
|
of tags specific to each action as defined below.
|
|
|
|
`Execute`
|
|
|
|
: Execute command specified by `<command>` option.
|
|
|
|
`Exit`
|
|
|
|
: Exit labwc.
|
|
|
|
`NextWindow`
|
|
|
|
: Cycle focus to next window.
|
|
|
|
# THEMERC
|
|
|
|
The theme engine aims to be compatible with openbox and themes will be
|
|
searched for in the following order:
|
|
|
|
- `${XDG_DATA_HOME:-$HOME/.local/share}/themes/<theme-name>/openbox-3/`
|
|
- `$HOME/.themes/<theme-name>/openbox-3/`
|
|
- `/usr/share/themes/<theme-name>/openbox-3/`
|
|
- `/usr/local/share/themes/<theme-name>/openbox-3/`
|
|
- `/opt/share/themes/<theme-name>/openbox-3/`
|
|
|
|
`window.active.title.bg.color`
|
|
|
|
: Background for the focussed window's titlebar
|
|
|
|
`window.active.handle.bg.color`
|
|
|
|
: Background for the focussed window's handle.
|
|
|
|
`window.inactive.title.bg.color`
|
|
|
|
: Background for non-focussed windows' titlebars
|
|
|
|
# DEFINITIONS
|
|
|
|
The `handle` is the window decoration placed on the bottom of the window.
|
|
|
|
# EXAMPLES
|
|
|
|
## Example 1 - title bar configuration
|
|
|
|
+-----------------------------------------+ ^
|
|
| | |
|
|
| | |
|
|
| | | h
|
|
| | |
|
|
+-----------------------------------------+ v
|
|
|
|
h = padding * 2 + font-vertical-extents
|
|
|
|
|
|
# SEE ALSO
|
|
|
|
labwc(1)
|