1 <?xml version="1.0" encoding="UTF-8"?> <!-- -*- nxml -*- -->
3 <!-- XML Schema for the Openbox window manager configuration file -->
5 <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
6 targetNamespace="http://openbox.org/3.4/rc"
7 xmlns:ob="http://openbox.org/3.4/rc"
8 elementFormDefault="qualified">
12 <xsd:element name="openbox_config">
14 <xsd:documentation>all these elements are expected in a openbox config file</xsd:documentation>
17 <xsd:element name="resistance" type="ob:resistance"/>
18 <xsd:element name="focus" type="ob:focus"/>
19 <xsd:element name="placement" type="ob:placement"/>
20 <xsd:element name="theme" type="ob:theme"/>
21 <xsd:element name="desktops" type="ob:desktops"/>
22 <xsd:element name="resize" type="ob:resize"/>
23 <xsd:element name="dock" type="ob:dock"/>
24 <xsd:element name="keyboard" type="ob:keyboard"/>
25 <xsd:element name="mouse" type="ob:mouse"/>
26 <xsd:element name="menu" type="ob:menu"/>
27 <xsd:element name="applications" type="ob:applications"/>
33 <xsd:complexType name="resistance">
35 <xsd:documentation>defines behaviour of windows when close to each other or the screen edge</xsd:documentation>
37 <xsd:element minOccurs="0" name="strength" type="xsd:integer"/>
38 <xsd:element minOccurs="0" name="screen_edge_strength" type="xsd:integer"/>
40 <xsd:complexType name="focus">
42 <xsd:documentation>defines aspects of window focus</xsd:documentation>
44 <xsd:element minOccurs="0" name="focusNew" type="ob:bool"/>
45 <xsd:element minOccurs="0" name="focusLast" type="ob:bool"/>
46 <xsd:element minOccurs="0" name="followMouse" type="ob:bool"/>
47 <xsd:element minOccurs="0" name="underMouse" type="ob:bool"/>
48 <xsd:element minOccurs="0" name="focusDelay" type="xsd:integer"/>
49 <xsd:element minOccurs="0" name="raiseOnFocus" type="ob:bool"/>
51 <xsd:complexType name="placement">
53 <xsd:documentation>defines how new windows are placed</xsd:documentation>
55 <xsd:element name="policy" type="ob:placementpolicy"/>
56 <xsd:element name="center" type="ob:bool"/>
57 <xsd:element name="monitor" type="ob:placementmonitor"/>
59 <xsd:complexType name="margins">
61 <xsd:documentation>defines desktop margins</xsd:documentation>
63 <xsd:element minOccurs="0" name="top" type="xsd:integer"/>
64 <xsd:element minOccurs="0" name="left" type="xsd:integer"/>
65 <xsd:element minOccurs="0" name="right" type="xsd:integer"/>
66 <xsd:element minOccurs="0" name="bottom" type="xsd:integer"/>
68 <xsd:complexType name="theme">
69 <xsd:element minOccurs="0" name="name" type="xsd:string"/>
70 <xsd:element minOccurs="0" name="titleLayout" type="xsd:string"/>
71 <xsd:element minOccurs="0" name="keepBorder" type="ob:bool"/>
72 <xsd:element minOccurs="0" name="animateIconify" type="ob:bool"/>
73 <xsd:element minOccurs="0" name="font" type="ob:font"/>
75 <xsd:complexType name="font">
76 <xsd:element minOccurs="0" name="name" type="xsd:string"/>
77 <xsd:element minOccurs="0" name="size" type="xsd:integer"/>
78 <xsd:element minOccurs="0" name="weight" type="ob:fontweight"/>
79 <xsd:element minOccurs="0" name="slant" type="ob:fontslant"/>
80 <xsd:attribute name="place" type="ob:fontplace" use="required"/>
82 <xsd:complexType name="desktops">
84 <xsd:documentation>defines the number and names of desktops</xsd:documentation>
86 <xsd:element minOccurs="0" name="number" type="xsd:integer"/>
87 <xsd:element minOccurs="0" name="firstdesk" type="xsd:integer"/>
88 <xsd:element minOccurs="0" name="names">
90 <xsd:element maxOccurs="unbounded" name="name" type="xsd:string"/>
93 <xsd:element minOccurs="0" name="popupTime" type="xsd:integer"/>
95 <xsd:complexType name="resize">
96 <xsd:element minOccurs="0" name="drawContents" type="ob:bool"/>
97 <xsd:element minOccurs="0" name="popupShow" type="ob:popupshow"/>
98 <xsd:element minOccurs="0" name="popupPosition" type="ob:popupposition"/>
99 <xsd:element minOccurs="0" name="popupPosition" type="ob:popupfixedposition"/>
101 <xsd:complexType name="popupfixedposition">
102 <xsd:element minOccurs="0" name="x" type="ob:center_or_int"/>
103 <xsd:element minOccurs="0" name="y" type="ob:center_or_int"/>
105 <xsd:complexType name="dock">
106 <xsd:element minOccurs="0" name="position" type="ob:dock_position"/>
107 <xsd:element minOccurs="0" name="floatingX" type="xsd:integer"/>
108 <xsd:element minOccurs="0" name="floatingY" type="xsd:integer"/>
109 <xsd:element minOccurs="0" name="noStrut" type="ob:bool"/>
110 <xsd:element minOccurs="0" name="stacking" type="ob:layer"/>
111 <xsd:element minOccurs="0" name="direction" type="ob:direction"/>
112 <xsd:element minOccurs="0" name="autoHide" type="ob:bool"/>
113 <xsd:element minOccurs="0" name="hideDelay" type="xsd:integer"/>
114 <xsd:element minOccurs="0" name="showDelay" type="xsd:integer"/>
115 <xsd:element minOccurs="0" name="moveButton" type="ob:button"/>
117 <xsd:complexType name="action">
118 <xsd:element minOccurs="0" name="execute" type="xsd:string"/>
119 <xsd:element minOccurs="0" name="command" type="xsd:string"/>
120 <xsd:element minOccurs="0" name="menu" type="xsd:string"/>
121 <xsd:element minOccurs="0" name="delta" type="xsd:integer"/>
122 <xsd:element minOccurs="0" name="x" type="xsd:integer"/>
123 <xsd:element minOccurs="0" name="y" type="xsd:integer"/>
124 <xsd:element minOccurs="0" name="left" type="xsd:integer"/>
125 <xsd:element minOccurs="0" name="right" type="xsd:integer"/>
126 <xsd:element minOccurs="0" name="up" type="xsd:integer"/>
127 <xsd:element minOccurs="0" name="down" type="xsd:integer"/>
128 <xsd:element minOccurs="0" name="desktop" type="xsd:integer"/>
129 <xsd:element minOccurs="0" name="wrap" type="ob:bool"/>
130 <xsd:element minOccurs="0" name="follow" type="ob:bool"/>
131 <xsd:element minOccurs="0" name="dialog" type="ob:bool"/>
132 <xsd:element minOccurs="0" name="panels" type="ob:bool"/>
133 <xsd:element minOccurs="0" name="here" type="ob:bool"/>
134 <xsd:element minOccurs="0" name="linear" type="ob:bool"/>
135 <xsd:element minOccurs="0" name="group" type="ob:bool"/>
136 <xsd:attribute name="name" type="ob:actionname" use="required"/>
138 <xsd:complexType name="keybind">
140 <xsd:element maxOccurs="unbounded" name="action" type="ob:action"/>
141 <xsd:element maxOccurs="unbounded" name="keybind" type="ob:keybind"/>
143 <xsd:attribute name="chroot" type="ob:bool"/>
144 <xsd:attribute name="key" type="ob:keyname" use="required"/>
146 <xsd:complexType name="keyboard">
147 <xsd:element minOccurs="0" name="chainQuitKey" type="ob:keyname"/>
148 <xsd:element maxOccurs="unbounded" name="keybind" type="ob:keybind"/>
150 <xsd:complexType name="mousebind">
151 <xsd:element maxOccurs="unbounded" name="action" type="ob:action"/>
152 <xsd:attribute name="action" type="ob:mouseaction" use="required"/>
153 <xsd:attribute name="button" type="ob:button" use="required"/>
155 <xsd:complexType name="context">
156 <xsd:element maxOccurs="unbounded" name="mousebind" type="ob:mousebind"/>
157 <xsd:attribute name="name" type="ob:contextname" use="required"/>
159 <xsd:complexType name="mouse">
160 <xsd:element minOccurs="0" name="dragThreshold" type="xsd:integer"/>
161 <xsd:element minOccurs="0" name="doubleClickTime" type="xsd:integer"/>
162 <xsd:element minOccurs="0" name="screenEdgeWarpTime" type="xsd:integer"/>
163 <xsd:element maxOccurs="unbounded" name="context" type="ob:context"/>
165 <xsd:complexType name="menu">
166 <xsd:element maxOccurs="unbounded" name="file" type="xsd:string"/>
167 <xsd:element minOccurs="0" name="hideDelay" type="xsd:integer"/>
168 <xsd:element minOccurs="0" name="middle" type="ob:bool"/>
169 <xsd:element minOccurs="0" name="submenuShowDelay" type="xsd:integer"/>
170 <xsd:element minOccurs="0" name="applicationIcons" type="ob:bool"/>
171 <xsd:element minOccurs="0" name="manageDesktops" type="ob:bool"/>
173 <xsd:complexType name="window_position">
174 <xsd:element name="x" type="ob:center_or_int"/>
175 <xsd:element name="y" type="ob:center_or_int"/>
176 <xsd:element name="monitor" type="ob:mouse_or_int"/>
177 <xsd:element minOccurs="0" name="head" type="xsd:string"/>
178 <xsd:attribute name="force" type="ob:bool"/>
180 <xsd:complexType name="application">
181 <xsd:element minOccurs="0" name="decor" type="xsd:bool"/>
182 <xsd:element minOccurs="0" name="shade" type="ob:bool"/>
183 <xsd:element minOccurs="0" name="position" type="ob:window_position"/>
184 <xsd:element minOccurs="0" name="focus" type="xsd:string"/>
185 <xsd:element minOccurs="0" name="desktop" type="xsd:integer"/>
186 <xsd:element minOccurs="0" name="layer" type="ob:layer"/>
187 <xsd:element minOccurs="0" name="iconic" type="ob:bool"/>
188 <xsd:element minOccurs="0" name="skip_pager" type="ob:bool"/>
189 <xsd:element minOccurs="0" name="skip_taskbar" type="ob:bool"/>
190 <xsd:element minOccurs="0" name="fullscreen" type="ob:bool"/>
191 <xsd:element minOccurs="0" name="maximized" type="ob:maximization"/>
192 <xsd:attribute name="role" type="xsd:string"/>
193 <xsd:attribute name="type" type="ob:clienttype"/>
194 <!-- at least one of these must be present -->
195 <xsd:attribute name="name" type="xsd:string"/>
196 <xsd:attribute name="class" type="xsd:string"/>
198 <xsd:complexType name="applications">
199 <xsd:element minOccurs="0" maxOccurs="unbounded" name="application" type="ob:application"/>
202 simple types / restrictions
204 <xsd:simpleType name="actionname">
205 <xsd:restriction base="xsd:string">
206 <xsd:enumeration value="Activate"/>
207 <xsd:enumeration value="BreakChroot"/>
208 <xsd:enumeration value="Close"/>
209 <xsd:enumeration value="Desktop"/>
210 <xsd:enumeration value="DesktopDown"/>
211 <xsd:enumeration value="DesktopLast"/>
212 <xsd:enumeration value="DesktopLeft"/>
213 <xsd:enumeration value="DesktopNext"/>
214 <xsd:enumeration value="DesktopPrevious"/>
215 <xsd:enumeration value="DesktopRight"/>
216 <xsd:enumeration value="DesktopUp"/>
217 <xsd:enumeration value="DirectionalFocusEast"/>
218 <xsd:enumeration value="DirectionalFocusNorth"/>
219 <xsd:enumeration value="DirectionalFocusNortheast"/>
220 <xsd:enumeration value="DirectionalFocusNorthwest"/>
221 <xsd:enumeration value="DirectionalFocusSouth"/>
222 <xsd:enumeration value="DirectionalFocusSoutheast"/>
223 <xsd:enumeration value="DirectionalFocusSouthwest"/>
224 <xsd:enumeration value="DirectionalFocusWest"/>
225 <xsd:enumeration value="Execute"/>
226 <xsd:enumeration value="Exit"/>
227 <xsd:enumeration value="Focus"/>
228 <xsd:enumeration value="FocusToBottom"/>
229 <xsd:enumeration value="GrowToEdgeEast"/>
230 <xsd:enumeration value="GrowToEdgeNorth"/>
231 <xsd:enumeration value="GrowToEdgeSouth"/>
232 <xsd:enumeration value="GrowToEdgeWest"/>
233 <xsd:enumeration value="Iconify"/>
234 <xsd:enumeration value="Kill"/>
235 <xsd:enumeration value="Lower"/>
236 <xsd:enumeration value="MaximizeFull"/>
237 <xsd:enumeration value="MaximizeHorz"/>
238 <xsd:enumeration value="MaximizeVert"/>
239 <xsd:enumeration value="Move"/>
240 <xsd:enumeration value="MoveRelative"/>
241 <xsd:enumeration value="MoveRelativeHorz"/>
242 <xsd:enumeration value="MoveRelativeVert"/>
243 <xsd:enumeration value="MoveToCenter"/>
244 <xsd:enumeration value="MoveFromEdgeEast"/>
245 <xsd:enumeration value="MoveFromEdgeNorth"/>
246 <xsd:enumeration value="MoveFromEdgeSouth"/>
247 <xsd:enumeration value="MoveFromEdgeWest"/>
248 <xsd:enumeration value="MoveToEdgeEast"/>
249 <xsd:enumeration value="MoveToEdgeNorth"/>
250 <xsd:enumeration value="MoveToEdgeSouth"/>
251 <xsd:enumeration value="MoveToEdgeWest"/>
252 <xsd:enumeration value="NextWindow"/>
253 <xsd:enumeration value="PreviousWindow"/>
254 <xsd:enumeration value="Raise"/>
255 <xsd:enumeration value="RaiseLower"/>
256 <xsd:enumeration value="Reconfigure"/>
257 <xsd:enumeration value="Resize"/>
258 <xsd:enumeration value="ResizeRelative"/>
259 <xsd:enumeration value="ResizeRelativeHorz"/>
260 <xsd:enumeration value="ResizeRelativeVert"/>
261 <xsd:enumeration value="Restart"/>
262 <xsd:enumeration value="SendToBottomLayer"/>
263 <xsd:enumeration value="SendToDesktop"/>
264 <xsd:enumeration value="SendToDesktopDown"/>
265 <xsd:enumeration value="SendToDesktopLeft"/>
266 <xsd:enumeration value="SendToDesktopNext"/>
267 <xsd:enumeration value="SendToDesktopPrevious"/>
268 <xsd:enumeration value="SendToDesktopRight"/>
269 <xsd:enumeration value="SendToDesktopUp"/>
270 <xsd:enumeration value="SendToNormalLayer"/>
271 <xsd:enumeration value="SendToTopLayer"/>
272 <xsd:enumeration value="Shade"/>
273 <xsd:enumeration value="ShadeLower"/>
274 <xsd:enumeration value="ShowDesktop"/>
275 <xsd:enumeration value="ShowMenu"/>
276 <xsd:enumeration value="ToggleAlwaysOnBottom"/>
277 <xsd:enumeration value="ToggleAlwaysOnTop"/>
278 <xsd:enumeration value="ToggleDecorations"/>
279 <xsd:enumeration value="ToggleDockAutoHide"/>
280 <xsd:enumeration value="ToggleFullscreen"/>
281 <xsd:enumeration value="ToggleMaximizeFull"/>
282 <xsd:enumeration value="ToggleMaximizeHorz"/>
283 <xsd:enumeration value="ToggleMaximizeVert"/>
284 <xsd:enumeration value="ToggleOmnipresent"/>
285 <xsd:enumeration value="ToggleShade"/>
286 <xsd:enumeration value="ToggleShowDesktop"/>
287 <xsd:enumeration value="Unfocus"/>
288 <xsd:enumeration value="UnmaximizeFull"/>
289 <xsd:enumeration value="UnmaximizeHorz"/>
290 <xsd:enumeration value="UnmaximizeVert"/>
291 <xsd:enumeration value="Unshade"/>
292 <xsd:enumeration value="UnshadeRaise"/>
293 <xsd:enumeration value="UnShowDesktop"/>
296 <xsd:simpleType name="clienttype">
297 <xsd:restriction base="xsd:string">
298 <xsd:enumeration value="desktop"/>
299 <xsd:enumeration value="dock"/>
300 <xsd:enumeration value="toolbar"/>
301 <xsd:enumeration value="menu"/>
302 <xsd:enumeration value="splash"/>
303 <xsd:enumeration value="utility"/>
304 <xsd:enumeration value="dialog"/>
305 <xsd:enumeration value="normal"/>
308 <xsd:simpleType name="bool">
309 <!-- this is copied to maximization. Keep that in sync. -->
310 <xsd:restriction base="xsd:string">
311 <xsd:enumeration value="yes"/>
312 <xsd:enumeration value="no"/>
313 <xsd:enumeration value="true"/>
314 <xsd:enumeration value="false"/>
315 <xsd:enumeration value="on"/>
316 <xsd:enumeration value="off"/>
319 <xsd:simpleType name="fontplace">
320 <xsd:restriction base="xsd:string">
321 <xsd:enumeration value="ActiveWindow"/>
322 <xsd:enumeration value="InactiveWindow"/>
323 <xsd:enumeration value="MenuHeader"/>
324 <xsd:enumeration value="MenuItem"/>
325 <xsd:enumeration value="OnScreenDisplay"/>
328 <xsd:simpleType name="fontweight">
329 <xsd:restriction base="xsd:string">
330 <xsd:enumeration value="normal"/>
331 <xsd:enumeration value="bold"/>
334 <xsd:simpleType name="fontslant">
335 <xsd:restriction base="xsd:string">
336 <xsd:enumeration value="normal"/>
337 <xsd:enumeration value="italic"/>
338 <xsd:enumeration value="opaque"/>
341 <xsd:simpleType name="button">
342 <xsd:restriction base="xsd:string">
343 <!-- FIXME what??? -->
344 <xsd:enumeration value="Left"/>
345 <xsd:enumeration value="Middle"/>
346 <xsd:enumeration value="Right"/>
347 <xsd:enumeration value="Up"/>
348 <xsd:enumeration value="Down"/>
349 <xsd:enumeration value="A-Left"/>
350 <xsd:enumeration value="A-Middle"/>
351 <xsd:enumeration value="A-Right"/>
352 <xsd:enumeration value="A-Up"/>
353 <xsd:enumeration value="A-Down"/>
354 <xsd:enumeration value="C-A-Left"/>
355 <xsd:enumeration value="C-A-Middle"/>
356 <xsd:enumeration value="C-A-Right"/>
357 <xsd:enumeration value="C-A-Up"/>
358 <xsd:enumeration value="C-A-Down"/>
361 <xsd:simpleType name="center_or_int">
362 <xsd:restriction base="xsd:string">
363 <!-- ob: atoi($_) unless $_ eq 'center'; -->
364 <!-- I think the regexp DTRT WRT atoi. -->
365 <xsd:pattern value="center|0|[1-9][0-9]*"/>
368 <xsd:simpleType name="mouse_or_int">
369 <xsd:restriction base="xsd:string">
370 <!-- ob: atoi($_) unless $_ eq 'center'; -->
371 <!-- I think the regexp DTRT WRT atoi. -->
372 <xsd:pattern value="mouse|0|[1-9][0-9]*"/>
375 <xsd:simpleType name="contextname">
376 <xsd:restriction base="xsd:string">
377 <xsd:enumeration value="Desktop"/>
378 <xsd:enumeration value="Root"/>
379 <xsd:enumeration value="Client"/>
380 <xsd:enumeration value="Titlebar"/>
381 <xsd:enumeration value="Frame"/>
382 <xsd:enumeration value="TLCorner"/>
383 <xsd:enumeration value="TRCorner"/>
384 <xsd:enumeration value="BLCorner"/>
385 <xsd:enumeration value="BRCorner"/>
386 <xsd:enumeration value="Top"/>
387 <xsd:enumeration value="Left"/>
388 <xsd:enumeration value="Right"/>
389 <xsd:enumeration value="Bottom"/>
390 <xsd:enumeration value="Handle"/>
391 <xsd:enumeration value="Maximize"/>
392 <xsd:enumeration value="AllDesktops"/>
393 <xsd:enumeration value="Shade"/>
394 <xsd:enumeration value="Iconify"/>
395 <xsd:enumeration value="Icon"/>
396 <xsd:enumeration value="Close"/>
397 <xsd:enumeration value="MoveResize"/>
400 <xsd:simpleType name="direction">
401 <xsd:restriction base="xsd:string">
402 <xsd:enumeration value="Horizontal"/>
403 <xsd:enumeration value="Vertical"/>
406 <xsd:simpleType name="dock_position">
407 <xsd:restriction base="xsd:string">
408 <xsd:enumeration value="TopLeft"/>
409 <xsd:enumeration value="Top"/>
410 <xsd:enumeration value="TopRight"/>
411 <xsd:enumeration value="Right"/>
412 <xsd:enumeration value="BottomRight"/>
413 <xsd:enumeration value="Bottom"/>
414 <xsd:enumeration value="BottomLeft"/>
415 <xsd:enumeration value="Left"/>
416 <xsd:enumeration value="Floating"/>
419 <xsd:simpleType name="keyname">
420 <xsd:restriction base="xsd:string">
421 <!-- FIXME: M, Mod2, Mod5 in addition to S, A, C -->
422 <!-- how do we do all substrings and permutations? -->
423 <xsd:pattern value="(A-)?(S-)?(A-)?(C-)?(A-)?(S-)?(A-)?[a-zA-Z0-9]*"/>
426 <xsd:simpleType name="layer">
427 <xsd:restriction base="xsd:string">
428 <xsd:enumeration value="Above"/>
429 <xsd:enumeration value="Normal"/>
430 <xsd:enumeration value="Below"/>
433 <xsd:simpleType name="maximization">
434 <xsd:restriction base="xsd:string">
435 <xsd:enumeration value="Horizontal"/>
436 <xsd:enumeration value="Vertical"/>
437 <!-- this is a copy of ob:bool. Keep it in sync. -->
438 <xsd:enumeration value="yes"/>
439 <xsd:enumeration value="no"/>
440 <xsd:enumeration value="true"/>
441 <xsd:enumeration value="false"/>
442 <xsd:enumeration value="on"/>
443 <xsd:enumeration value="off"/>
446 <xsd:simpleType name="mouseaction">
447 <xsd:restriction base="xsd:string">
448 <xsd:enumeration value="Click"/>
449 <xsd:enumeration value="DoubleClick"/>
450 <xsd:enumeration value="Drag"/>
451 <xsd:enumeration value="Press"/>
452 <xsd:enumeration value="Release"/>
455 <xsd:simpleType name="placementpolicy">
456 <xsd:restriction base="xsd:string">
457 <xsd:enumeration value="Smart"/>
458 <xsd:enumeration value="UnderMouse"/>
461 <xsd:simpleType name="placementmonitor">
462 <xsd:restriction base="xsd:string">
463 <xsd:enumeration value="Any"/>
464 <xsd:enumeration value="Mouse"/>
465 <xsd:enumeration value="Active"/>
468 <xsd:simpleType name="popupposition">
469 <xsd:restriction base="xsd:string">
470 <xsd:enumeration value="Top"/>
471 <xsd:enumeration value="Center"/>
474 <xsd:simpleType name="popupshow">
475 <xsd:restriction base="xsd:string">
476 <xsd:enumeration value="Always"/>
477 <xsd:enumeration value="Never"/>
478 <xsd:enumeration value="Nonpixel"/>