<?xml version="1.0"?>
<labwc_config>
<!-- settings -->
</labwc_config>

<action>
  <name>Execute</name>
  <command>foot</command>
</action>

<action name="Execute">
  <command>foot</command>
</action>

<action name="Execute" command="foot" />

<command>sh -c 'grim -g "`slurp`"'</command>

<core>
  <decoration>server</decoration>
  <gap>0</gap>
  <adaptiveSync>no</adaptiveSync>
  <allowTearing>no</allowTearing>
  <reuseOutputMode>no</reuseOutputMode>
</core>

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.

The distance in pixels between views and output edges when using movement actions, for example MoveToEdge. Default is 0.

Enable adaptive sync. Default is no.

fullscreen enables adaptive sync whenever a window is in fullscreen mode.

Allow tearing to reduce input lag. Default is no. This option requires setting the environment variable WLR_DRM_NO_ATOMIC=1. yes allow tearing if requested by the active window.

Try to re-use the existing output mode (resolution / refresh rate). This may prevent unnecessary screenblank delays when starting labwc (also known as flicker free boot). If the existing output mode can not be used with labwc the preferred mode of the monitor is used instead. Default is no.

Specify a placement policy for new windows. The "center" policy will always place windows at the center of the active output. The "automatic" policy will try to place new windows in such a way that they will have minimal overlap with existing windows. The "cursor" policy will center new windows under the cursor. Default is "center".

show [yes|no] Draw the OnScreenDisplay when switching between windows. Default is yes.

preview [yes|no] Preview the contents of the selected window when switching between windows. Default is yes.

outlines [yes|no] Draw an outline around the selected window when switching between windows. Default is yes.

Define window switcher fields.

content defines what the field shows and can be any of:

width defines the width of the field expressed as a percentage of the overall window switcher width. The "%" character is required.

Resist interactive moves and resizes of a window across screen edges or the edges of any other window, respectively.

When an edge strength is positive, it indicates a distance, in pixels, that the cursor must move past any relevant encountered edge before an interactive move or resize operation will continue across that edge.

When the strength is negative, any interactive move or resize operation that brings the cursor within the absolute value of the specified distance, in pixels, from any relevant edge will snap the operation to that edge. Thus, as a move or resize approaches an edge, it will "attract" the cursor to that edge within the specified distance. As the move or resize continues past the edge, it will provide resistance until the cursor has moved beyond the distance.

A strength of zero disables the corresponding resistance effect.

The default value for both parameters is 20 pixels.

Make focus follow mouse, i.e. focus is given to window under mouse cursor. Default is no.

Requires cursor movement if followMouse is enabled. It is the same as the "underMouse" setting in Openbox. If set to "no", labwc will additionally focus the window under the cursor in all situations which change the position of a window (e.g. switching workspaces, opening/closing windows). Focusing a different window via A-Tab is still possible, even with this setting set to "no". Default is yes.

Raise window to top when focused. Default is no.

If an interactive move ends with the cursor a maximum distance range, (in pixels) from the edge of an output, the move will trigger a SnapToEdge action for that edge. A range of 0 disables snapping via interactive moves. Default is 1.

If yes, an interactive move that snaps a window to the top edge will maximize the window. If no, snapping will behave as it does with other edges, causing the window to occupy the top half of an output. Default is yes.

Snapping windows can trigger corresponding tiling events for native Wayland clients. Clients may use these events to alter their rendering based on knowledge that some edges of the view are confined to edges of a snapping region or output. For example, rounded corners may become square when tiled, or media players may letter-box or pillar-box video rather than imposing rigid aspect ratios on windows that will violate the constraints of window snapping.

The default is "always".

Define snap regions. The regions are calculated based on the usable area of each output. Usable area in this context means space not exclusively used by layershell clients like panels. The "%" character is required. Windows can either be snapped to regions by keeping a keyboard modifier pressed while moving a window (Ctrl, Alt, Shift, Logo) or by using the SnapToRegion action. By default there are no regions defined.

Define workspaces. A workspace covers all outputs. The OSD only shows windows on the current workspace. Workspaces can be switched to with GoToDesktop and windows can be moved with SendToDesktop. See labwc-actions(5) for more information about their arguments.

The number attribute defines the minimum number of workspaces. Default is 1. The number attribute is optional. If the number attribute is specified, names.name is not required.

Define the timeout after which to hide the workspace OSD. A setting of 0 disables the OSD. Default is 1000 ms.

The name of the Openbox theme to use. It is not set by default.

The radius of server side decoration top corners. Default is 8.

Even when disabling server side decorations via ToggleDecorations, keep a small border (and resize area) around the window. Default is yes.

The font to use for a specific element of a window, menu or OSD. Places can be any of:

places.

Describes font name. Default is sans.

Font size in pixels. Default is 10.

Font slant (normal or italic). Default is normal.

Font weight (normal or bold). Default is normal.

Specify the number of pixels to reserve at the edges of an output (typically a dislay/screen/monitor). New, maximized and tiled windows will not be placed in these areas. The use-case for <margin> is as a workaround for clients such as panels that do NOT support the wlr-layer-shell protocol.

output is optional; if this attribute is not provided (rather than leaving it an empty string) the margin will be applied to all outputs.

Show a small indicator on top of the window when resizing or moving. When the application sets size-hints (usually X11 terminal emulators), the indicator will show the dimensions divided by size hints instead. In the case of terminal emulators this usually means columns x rows.

The different values mean:

Default is Never.

When recognizing a new keyboard enable or disable Num Lock. Default is on.

Stores the keyboard layout either globally or per window and restores it when switching back to the window. Default is global.

Define a key binding in the format modifier-key, where supported modifiers are:

Multiple modifiers can be combined like A-S-f for Alt-Shift-f. The key itself can be any unicode character or a keyname like Return.

Unlike Openbox, multiple space-separated key combinations and key-chains are not supported. The application "wev" (wayland event viewer) is packaged in a lot of distributions and can be used to view all available keynames.

layoutDependent [yes|no] Make this specific keybind depend on the currently active keyboard layout. If enabled, a keybind using a key which does not exist in the currently active layout will not be executed. The physical key to trigger a keybind may also change along with the active layout. If set to "no" (or is absent) the keybind will be layout agnostic. Default is no.

Keybind action. See labwc-action(5).

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
  W-Return - alacritty
  A-F3 - run bemenu
  A-F4 - close window
  W-a - toggle maximize
  A-<arrow> - move window to edge
  W-<arrow> - resize window to fill half the output

Audio and MonBrightness keys are also bound to amixer and brightnessctl, respectively.

Set the rate at which keypresses are repeated per second. Default is 25.

Set the delay before keypresses are repeated in milliseconds. Default is 600.

Set double click time in milliseconds. Default is 500.

Set scroll factor. Default is 1.0.

Multiple <mousebind> can exist within one <context>; and multiple <action> can exist within one <mousebind>.

Define a mouse binding. Supported context-names include:

Supported mouse buttons are:

Supported scroll directions are:

Mouse buttons and directions can be combined with modifier-keys (shift (S), super/logo (W), control (C), alt (A), meta (M) and hyper (H)), for example: <mousebind button="A-Right" action="Press">

Supported mouse actions include:

Load default mousebinds. This is an addition to the openbox specification and provides a way to keep config files simpler whilst allowing user specific binds. Note that if no rc.xml is found, or if no <mouse><mousebind> entries exist, the same default mousebinds will be loaded even if the <default /> element is not provided.

<touch deviceName="" mapToOutput="" />

A touch configuration can be bound to a specifc device. If device name is left empty, the touch configuration applies to all touch devices or functions as a fallback. Multiple touch configurations can exist. See the libinput device section for obtaining the device names.

Direct cursor movement to a specified output. If the compositor is running in nested mode, this does not take effect.

<tablet mapToOutput="" rotate="0">
  <area top="0.0" left="0.0" width="0.0" height="0.0" />
  <map button="Tip" to="Left" />
  <map button="Stylus" to="Right" />
  <map button="Stylus2" to="Middle" />
</tablet>

The tablet cursor movement can be restricted to a single output. If the output name is left empty or the output does not exists, the tablet will span all outputs.

The tablet orientation can be changed in 90 degree steps. Default is no rotation (0). Rotation will be applied after applying tablet area transformation.

By default the complete tablet area is mapped to the full output. The area element can be used to truncate the active area of the tablet surface. By truncating the active area, it is e.g. possible to maintain the same aspect ratio between output and tablet.

The active tablet area can be specified by setting the top/left coordinate (in mm) and/or width/height (in mm). If width or height are omitted or default (0.0), width/height will be set to the remaining width/height seen from top/left.

Aspect ratio example: The dimensions of the tablet are 215mm x 115mm and the output has a resolution of 3440x1440. When setting height to "90", because 215 x 1440 / 3440 = 90, the responsive tablet area height will be truncated to match the 21:9 aspect ratio of the output. By additionally setting top to "12.5", the active area is centered vertically on the tablet surface.

Tablet buttons emulate regular mouse buttons. If not specified otherwise, the tip (Tip) is mapped to left mouse click, the first pen button (Stylus) is mapped to right mouse button click and the second pen button (Stylus2) emulates a middle mouse button click.

Supported map buttons are:

See mouse section above for all supported to mouse buttons.

<libinput>
  <device category="CATEGORY">
    <naturalScroll></naturalScroll>
    <leftHanded></leftHanded>
    <pointerSpeed></pointerSpeed>
    <accelProfile></accelProfile>
    <tap>yes</tap>
    <tapButtonMap></tapButtonMap>
    <tapAndDrag></tapAndDrag>
    <dragLock></dragLock>
    <middleEmulation></middleEmulation>
    <disableWhileTyping></disableWhileTyping>
    <clickMethod></clickMethod>
    <sendEventsMode></sendEventsMode>
  </device>
</libinput>

Define a new libinput configuration category (profile).

CATEGORY Defines a category of devices (by type or name) to apply the settings that follow. The category attribute as optional. If no category attribute is provided, a 'default' device profile will created that will act as the fallback for all libinput devices. Category can be set to any of the following types:

If the provided category value is different from all of the above key words, it will be used to match the device name directly.

A list of device names can be obtained by running libinput list-devices (you may need to be root or a part of the input group to perform this).

Use natural scrolling for this category if available.

Use your devices left-handed mode if available.

Set the pointer speed for this category. The speed is a number between -1.0 and 1.0, with 0.0 being the default in most cases, and 1.0 being the fastest.

Set the pointer's acceleration profile for this category. Flat applies no acceleration (the pointers velocity is constant), while adaptive changes the pointers speed based the actual speed of your mouse or finger on your touchpad.

Enable or disable tap-to-click for this category. This is enabled by default for all categories.

Set the buttons mapped to one-, two-, and three-finger taps to the left button, right button, and middle button, respectively (lrm) (the default), or to left button, middle button, and right button (lmr).

Enable or disable tap-and-drag for this category. Tap-and-drag processes a tap immediately followed by a finger down as the start of a drag.

Enable or disable drag lock for this category. Drag lock ignores a momentary release of a finger during tap-and-dragging.

Enable or disable middle button emulation for this category. Middle emulation processes a simultaneous left and right click as a press of the middle mouse button (scroll wheel).

Enable or disable disable while typing for this category. DWT ignores any motion events while a keyboard is typing, and for a short while after as well.

Configure the method by which physical clicks on a touchpad are mapped to mouse-button events.

The click methods available are:

The default method depends on the touchpad hardware.

Optionally enable or disable sending any device events.

The options available are:

It is possible to prevent events from a device in the config and then do a Reconfigure to temporarily enable / disable specific devices.

By default, this setting is not configured.

<windowRules>
  <!-- Action -->
  <windowRule identifier="" title="">
    <action name=""/>
  </windowRule>
  <!-- Property -->
  <windowRule identifier="" serverDecoration="" />
</windowRules>

Define a window rule for any window which matches the criteria defined by the attributes identifier or title. If both are defined, AND logic is used, so both have to match. Matching against patterns with '*' (wildcard) and '?' (joker) is supported. Pattern matching is case-insensitive.

identifier relates to app_id for native Wayland windows and WM_CLASS for XWayland clients.

title is the title of the window.

matchOnce can be true|false. If true, the rule will only apply to the first instance of the window with the specified identifier or title.

serverDecoration over-rules any other setting for server-side window decoration on first map.

skipTaskbar removes window foreign-toplevel protocol handle so that it does not appear in clients such as panels and taskbars using that protocol.

skipWindowSwitcher removes window from the Window Switcher (alt-tab on-screen-display).

ignoreFocusRequest prevent window to activate itself.

fixedPosition disallows interactive move/resize and prevents re-positioning in response to changes in reserved output space, which can be caused by <margin> settings or exclusive layer-shell clients such as panels.

find /usr/share/icons/ -type d -name "cursors"