Openbox Configuration variables

This document lists the elements and attributes of an openbox configuration file. Element names are red, attribute names are blue; values are black; the nesting shown corresponds to the place in the xml-tree of the file. This document is mostly useful for people who cant wait for obconf, and to have a document on all available options.

resistance:

strength:

How many pixels should a window move off the screen, to actually do it: number

windows:

Same for overlapping windows: yes/no

placement:

remember:

Remember window positions and sizes: yes/no

focus:

focusNew:

Focus newly created windows: yes/no

followMouse:

Focus follows mouse: yes/no

focusLast:

Focus last window: yes/no

focusLastOnDesktop:

Focus last window on Desktop: yes/no

cyclingDialog:

Show icon and name of windows while cycling: yes/no

theme:

theme:

Filename of theme as in /usr/local/share/openbox/themes/

desktops:

number:

How many desktops are there: number

names:

name:

Name of first desktop

name:

Name of second desktop, etc.

moveresize:

opaqueMove:

Move windows with content drawn: yes/no

opaqueResize:

Resize windows with content drawn: yes/no

dock:

position:

Where to put the dock: topleft|...

stacking:

Where to layer the dock: top|...

direction:

How to align the dock: vertical|...

floatingX:

X Position of the Dock: Number, 0-...

floatingY:

Y Position of the Dock: Number, 0-...

autoHide:

Hide the dock, if not focused: yes/no

hideTimeout:

How many ms to wait for hiding: number

keyboard:

keybind:

key:

Key name: A-F1...

action:

name:

What to do: MaximizeFull|UnmaximizeFull|ToggleShade|DesktopLeft|DesktopRight|DesktopUp|... This is an empty Element

mouse:

dragThreshold:

How many pixels to move the Mouse to start draggin: number

doubleClickTime:

Time between two clicks to make it count a doubleclick in ms: number

context:

name:

Name where to apply following functions: frame|titlebar|handle...

mousebind:

button:

Name of Modifier+Mousebutton: Left|Middle|Right|A-Left|...

action:

When to apply this function: drag|click|press

action:

name:

What to do then: move|raise|lower|focus|shade... This is an empty element

menu:

id:

ID of the menu, top menu always 'root': Menus contain menus and items

label:

Whats written on the Screen: eg: mybox

menu:

id:

ID of Submenu: custom string

label:

Label on Screen: string

item:

label:

Label of Item

action:

name:

Action of Item: execute|restart|exit..., Separator items dont have this element

execute:

Command sent to shell; exit and restart items dont have this element