1labwc-config(5) File Formats Manual labwc-config(5)
2
6 labwc - Configuration
7
9 The configuration aims to be compatible with openbox specification, but
10 there are some differences which are pointed out throughout the man
11 pages.
12 In accordance with XDG Base Directory Specification, configuration
14 files will be searched for in the following order:
15 • ${XDG_CONFIG_HOME:-$HOME/.config}/labwc
17 • ${XDG_CONFIG_DIRS:-/etc/xdg}/labwc
18 Configuration must be wrapped in a <labwc_config> root-node.
21
23 <core><decoration> [server|client]
24 Specify server or client side decorations for xdg-shell views. Note
25 that it is not always possible to turn off client side decorations.
26 Default is server.
27 <core><gap>
29 The distance in pixels between views and output edges when using
30 movement actions, for example MoveToEdge. Default is 0.
31 <core><adaptiveSync> [yes|no]
33 Enable adaptive sync. Default is no.
34 <core><cycleViewPreview> [yes|no]
36 Preview the contents of the selected window when cycling between
37 windows. Default is no.
38
40 <focus><followMouse> [yes|no]
41 Make focus follow mouse, i.e. focus is given to window under mouse
42 cursor. Default is no.
43 <focus><raiseOnFocus> [yes|no]
45 Raise window to top when focused. Default is no.
46
48 <snapping><range>
49 The distance in pixels from the edge of an ouput for window Move
50 operations to trigger SnapToEdge. A range of 0 disables window
51 snapping. Default is 1.
52 <snapping><topMaximize> [yes|no]
54 Maximize window if Move operation ends on the top edge. Default is
55 yes.
56
58 <theme><name>
59 The name of the Openbox theme to use. It is not set by default.
60 <theme><cornerRadius>
62 The radius of server side decoration top corners. Default is 8.
63 <theme><font place="">
65 The font to use for a specific element of a window, menu or OSD.
66 Places can be any of:
67 • ActiveWindow - titlebar of active window
68 • MenuItem - menu item (currently only root menu)
69 • OSD - items in the on screen display
70 If no place attribute is provided, the setting will be applied to all
72 places.
73 <theme><font place=""><name>
75 Describes font name. Default is sans.
76 <theme><font place=""><size>
78 Font size in pixels. Default is 10.
79
81 <keyboard><keybind key="">
82 Define a key binding in the format modifier-key, where supported
83 modifiers include S (shift); C (control); A (alt); W (super). Un‐
84 like Openbox, multiple space-separated key combinations and key-
85 chains are not supported.
86 <keyboard><keybind key=""><action name="">
88 Keybind action. See labwc-action(5)
89 <keyboard><default />
91 Load the default keybinds listed below. This is an addition to the
92 openbox specification and provides a way to keep config files sim‐
93 pler whilst allowing your specific keybinds. Note that if no rc.xml
94 is found, or if no <keyboard><keybind> entries exist, the same de‐
95 fault keybinds will be loaded even if the <default /> element is
96 not provided.
97 A-Tab - next window
99 A-Escape - exit
100 W-Return - alacritty
101 A-F3 - run bemenu
102 A-F4 - close window
103 W-a - toggle maximize
104 A-<arrow> - move window to edge
105 W-<arrow> - resize window to fill half the output
106 Audio and MonBrightness keys are also bound to amixer and bright‐
108 nessctl respectively
109 <keyboard><repeatRate>
111 Set the rate at which keypresses are repeated per second. Default
112 is 25.
113 <keyboard><repeatDelay>
115 Set the delay before keypresses are repeated in milliseconds. De‐
116 fault is 600.
117
119 <mouse><doubleClickTime>
120 Set double click time in milliseconds. Default is 500.
121 <mouse><context name=""><mousebind button=""><action>
123 Multiple <mousebind> can exist within one <context>; and multiple
124 <action> can exist within one <mousebind>
125 Define a mouse binding. Supported context-names include:
127 • TitleBar: The area where the title of the window is shown.
128 • Title: The title of the window itself.
129 • WindowMenu: The button on the left.
130 • Iconify: The button that looks like an underline.
131 • Maximize: The button that looks like a box.
132 • Close: The button that looks like an X.
133 • Top: The top edge of the window's border.
134 • Bottom: The bottom edge of the window's border.
135 • Left: The left edge of the window's border.
136 • Right: The right edge of the window's border.
137 • TRCorner: The top-right corner of the window's border.
138 • TLCorner: The top-left corner of the window's border.
139 • BLCorner: The bottom-left corner of the window's border.
140 • BRCorner: The bottom-right edge of the window's border.
141 • Client: The client area of a window, inside its decorations.
142 Events bound to Client are also passed to applications.
143 • Frame: Any part of a window, but events bound to Frame are not
144 passed through to the application.
145 • Desktop: The desktop background, where no windows are present.
146 • Root: A synonym for Desktop (for compatibility).
147 Supported mouse buttons are:
150 • Left
151 • Middle
152 • Right
153 Supported mouse actions include:
156 • Press: Pressing the specified button down in the context.
157 • Release: Releasing the specified button in the context.
158 • Click: Pressing and then releasing inside of the the context.
159 • DoubleClick: Two presses within the doubleClickTime.
160 • Drag: Pressing the button within the context, then moving the
161 cursor
162
165 <libinput><device category="">
166 Define a category of devices to use the configuration values that
167 follow. The category can be set to touch (devices that define a
168 width and height), non-touch, default, or the name of a device. You
169 can obtain your devices name by running libinput list-devices (you
170 may need to be root or a part of the input group to perform this.)
171 Any members of this category that are not set use the default for
172 the device. With the exception of tap-to-click, which is enabled by
173 default.
174 <libinput><device category=""><naturalScroll> [yes|no]
176 Use natural scrolling for this category if available.
177 <libinput><device category=""><leftHanded> [yes|no]
179 Use your devices left-handed mode if available.
180 <libinput><device category=""><pointerSpeed> [-1.0 to 1.0]
182 Set the pointer speed for this category. The speed is a number be‐
183 tween -1.0 and 1.0, with 0.0 being the default in most cases, and
184 1.0 being the fastest.
185 <libinput><device category=""><accelProfile> [flat|adaptive]
187 Set the pointer's acceleration profile for this category. Flat ap‐
188 plies no acceleration (the pointers velocity is constant), while
189 adaptive changes the pointers speed based the actual speed of your
190 mouse or finger on your touchpad.
191 <libinput><device category=""><tap> [yes|no]
193 Enable or disable tap-to-click for this category. This is enabled
194 by default for all categories.
195 <libinput><device category=""><tapButtonMap> [lrm|lmr]
197 Set the buttons mapped to one-, two-, and three-finger taps to the
198 left button, right button, and middle button, respectively (lrm)
199 (the default), or to left button, middle button, and right button
200 (lmr).
201 <libinput><device category=""><middleEmulation> [yes|no]
203 Enable or disable middle button emulation for this category. Middle
204 emulation processes a simultaneous left and right click as a press
205 of the middle mouse button (scroll wheel).
206 <libinput>device category=""><disableWhileTyping> [yes|no]
208 Enable or disable disable while typing for this category. DWT ig‐
209 nores any motion events while a keyboard is typing, and for a short
210 while after as well.
211
213 <resistance><screenEdgeStrength>
214 Screen Edge Strength is how far past the screen's edge your cursor
215 must move before the window will move with it. Resistance is
216 counted in pixels. Default is 20 pixels.
217
219 labwc(1), labwc-actions(5), labwc-theme(5)
220 2022-06-24 labwc-config(5)