mention that the desktop stuff are default values only
[dana/openbox.git] / doc / rc-mouse-focus.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <!-- Do not edit this file, it will be overwritten on install.
4         Copy the file to $HOME/.config/openbox/ instead. -->
5
6 <openbox_config xmlns="http://openbox.org/3.4/rc">
7
8 <resistance>
9   <strength>10</strength>
10   <screen_edge_strength>20</screen_edge_strength>
11 </resistance>
12
13 <focus>
14   <focusNew>yes</focusNew>
15   <focusLast>yes</focusLast>
16   <followMouse>yes</followMouse>
17   <focusDelay>200</focusDelay>
18   <raiseOnFocus>no</raiseOnFocus>
19 </focus>
20
21 <placement>
22   <policy>Smart</policy>
23   <!-- 'Smart' or 'UnderMouse' -->
24 </placement>
25
26 <theme>
27   <name>Clearlooks</name>
28   <titleLayout>NLIMC</titleLayout>
29   <titleNumber>yes</titleNumber>
30   <!--
31       avaible characters are NDSLIMC, each can occur at most once.
32       N: window icon
33       L: window label (AKA title).
34       I: iconify
35       M: maximize
36       C: close
37       S: shade (roll up/down)
38       D: omnipresent (on all desktops).
39   -->
40   <keepBorder>yes</keepBorder>
41   <animateIconify>yes</animateIconify>
42   <font place="ActiveWindow">
43     <name>sans</name>
44     <size>8</size>
45     <!-- font size in points -->
46     <weight>bold</weight>
47     <!-- 'bold' or 'normal' -->
48     <slant>normal</slant>
49     <!-- 'italic' or 'normal' -->
50   </font>
51   <font place="InactiveWindow">
52     <name>sans</name>
53     <size>8</size>
54     <!-- font size in points -->
55     <weight>bold</weight>
56     <!-- 'bold' or 'normal' -->
57     <slant>normal</slant>
58     <!-- 'italic' or 'normal' -->
59   </font>
60   <font place="MenuHeader">
61     <name>sans</name>
62     <size>9</size>
63     <!-- font size in points -->
64     <weight>normal</weight>
65     <!-- 'bold' or 'normal' -->
66     <slant>normal</slant>
67     <!-- 'italic' or 'normal' -->
68   </font>
69   <font place="MenuItem">
70     <name>sans</name>
71     <size>9</size>
72     <!-- font size in points -->
73     <weight>normal</weight>
74     <!-- 'bold' or 'normal' -->
75     <slant>normal</slant>
76     <!-- 'italic' or 'normal' -->
77   </font>
78   <font place="OnScreenDisplay">
79     <name>sans</name>
80     <size>9</size>
81     <!-- font size in points -->
82     <weight>bold</weight>
83     <!-- 'bold' or 'normal' -->
84     <slant>normal</slant>
85     <!-- 'italic' or 'normal' -->
86   </font>
87 </theme>
88
89 <desktops>
90   <!-- this stuff is only used at startup, pagers allow you to change them
91        during a session
92
93        these are default values to use when other ones are not already set
94        by other applications, or saved in your session
95
96        use obconf if you want to change these without having to log out
97        and back in -->
98   <number>4</number>
99   <firstdesk>1</firstdesk>
100   <names>
101     <!-- set names up here if you want to, like this:
102     <name>desktop 1</name>
103     <name>desktop 2</name>
104     -->
105   </names>
106 </desktops>
107
108 <resize>
109   <drawContents>yes</drawContents>
110   <popupShow>Nonpixel</popupShow>
111   <!-- 'Always', 'Never', or 'Nonpixel' (xterms and such) -->
112   <popupPosition>Center</popupPosition>
113   <!-- 'Center' or 'Top' -->
114 </resize>
115
116 <dock>
117   <position>TopLeft</position>
118   <!-- (Top|Bottom)(Left|Right|)|Top|Bottom|Left|Right|Floating -->
119   <floatingX>0</floatingX>
120   <floatingY>0</floatingY>
121   <noStrut>no</noStrut>
122   <stacking>Above</stacking>
123   <!-- 'Above', 'Normal', or 'Below' -->
124   <direction>Vertical</direction>
125   <!-- 'Vertical' or 'Horizontal' -->
126   <autoHide>no</autoHide>
127   <hideDelay>300</hideDelay>
128   <!-- in milliseconds (1000 = 1 second) -->
129   <showDelay>300</showDelay>
130   <!-- in milliseconds (1000 = 1 second) -->
131   <moveButton>Middle</moveButton>
132   <!-- 'Left', 'Middle', 'Right' -->
133 </dock>
134
135 <keyboard>
136   <chainQuitKey>C-g</chainQuitKey>
137
138   <!-- Keybindings for desktop switching -->
139   <keybind key="C-A-Left">
140     <action name="DesktopLeft"><wrap>no</wrap></action>
141   </keybind>
142   <keybind key="C-A-Right">
143     <action name="DesktopRight"><wrap>no</wrap></action>
144   </keybind>
145   <keybind key="C-A-Up">
146     <action name="DesktopUp"><wrap>no</wrap></action>
147   </keybind>
148   <keybind key="C-A-Down">
149     <action name="DesktopDown"><wrap>no</wrap></action>
150   </keybind>
151   <keybind key="S-A-Left">
152     <action name="SendToDesktopLeft"><wrap>no</wrap></action>
153   </keybind>
154   <keybind key="S-A-Right">
155     <action name="SendToDesktopRight"><wrap>no</wrap></action>
156   </keybind>
157   <keybind key="S-A-Up">
158     <action name="SendToDesktopUp"><wrap>no</wrap></action>
159   </keybind>
160   <keybind key="S-A-Down">
161     <action name="SendToDesktopDown"><wrap>no</wrap></action>
162   </keybind>
163   <keybind key="W-F1">
164     <action name="Desktop"><desktop>1</desktop></action>
165   </keybind>
166   <keybind key="W-F2">
167     <action name="Desktop"><desktop>2</desktop></action>
168   </keybind>
169   <keybind key="W-F3">
170     <action name="Desktop"><desktop>3</desktop></action>
171   </keybind>
172   <keybind key="W-F4">
173     <action name="Desktop"><desktop>4</desktop></action>
174   </keybind>
175   <keybind key="W-d">
176     <action name="ToggleShowDesktop"/>
177   </keybind>
178
179   <!-- Keybindings for windows -->
180   <keybind key="A-F4">
181     <action name="Close"/>
182   </keybind>
183   <keybind key="A-Escape">
184     <action name="Lower"/>
185   </keybind>
186   <keybind key="A-space">
187     <action name="ShowMenu"><menu>client-menu</menu></action>
188   </keybind>
189
190   <!-- Keybindings for window switching -->
191   <keybind key="A-Tab">
192     <action name="NextWindow"/>
193   </keybind>
194   <keybind key="A-S-Tab">
195     <action name="PreviousWindow"/>
196   </keybind>
197   <keybind key="C-A-Tab">
198     <action name="NextWindow">
199       <panels>yes</panels><desktop>yes</desktop>
200     </action>
201   </keybind>
202
203   <!-- Keybindings for running applications -->
204   <keybind key="W-e">
205     <action name="Execute">
206       <startupnotify>
207         <enabled>true</enabled>
208         <name>Konqueror</name>
209       </startupnotify>
210       <execute>kfmclient openProfile filemanagement</execute>
211     </action>
212   </keybind>
213 </keyboard>
214
215 <mouse>
216   <dragThreshold>3</dragThreshold>
217   <!-- number of pixels the mouse must move before a drag begins -->
218   <doubleClickTime>200</doubleClickTime>
219   <!-- in milliseconds (1000 = 1 second) -->
220
221   <context name="Frame">
222     <mousebind button="A-Left" action="Press">
223       <action name="Focus"/>
224     </mousebind>
225     <mousebind button="A-Left" action="Click">
226       <action name="Raise"/>
227     </mousebind>
228     <mousebind button="A-Left" action="Drag">
229       <action name="Move"/>
230     </mousebind>
231
232     <mousebind button="A-Right" action="Press">
233       <action name="Focus"/>
234     </mousebind>
235     <mousebind button="A-Right" action="Press">
236       <action name="Raise"/>
237     </mousebind>
238     <mousebind button="A-Right" action="Drag">
239       <action name="Resize"/>
240     </mousebind> 
241
242     <mousebind button="A-Middle" action="Press">
243       <action name="Focus"/>
244       <action name="Lower"/>
245     </mousebind>
246
247     <mousebind button="A-Up" action="Click">
248       <action name="DesktopPrevious"/>
249     </mousebind>
250     <mousebind button="A-Down" action="Click">
251       <action name="DesktopNext"/>
252     </mousebind>
253     <mousebind button="A-S-Up" action="Click">
254       <action name="SendToDesktopPrevious"/>
255     </mousebind>
256     <mousebind button="A-S-Down" action="Click">
257       <action name="SendToDesktopNext"/>
258     </mousebind>
259   </context>
260
261   <context name="Titlebar">
262     <mousebind button="Left" action="Press">
263       <action name="Focus"/>
264     </mousebind>
265     <mousebind button="Left" action="Click">
266       <action name="Raise"/>
267     </mousebind>
268     <mousebind button="Left" action="Drag">
269       <action name="Move"/>
270     </mousebind>
271     <mousebind button="Left" action="DoubleClick">
272       <action name="ToggleMaximizeFull"/>
273     </mousebind>
274
275     <mousebind button="Middle" action="Press">
276       <action name="Focus"/>
277       <action name="Lower"/>
278     </mousebind>
279
280     <mousebind button="Up" action="Click">
281       <action name="Shade"/>
282     </mousebind>
283     <mousebind button="Down" action="Click">
284       <action name="Unshade"/>
285     </mousebind>
286
287     <mousebind button="Right" action="Press">
288       <action name="Focus"/>
289       <action name="ShowMenu"><menu>client-menu</menu></action>
290     </mousebind>
291   </context>
292
293   <context name="Top">
294     <mousebind button="Left" action="Press">
295       <action name="Focus"/>
296     </mousebind>
297     <mousebind button="Left" action="Click">
298       <action name="Raise"/>
299     </mousebind>
300     <mousebind button="Left" action="Drag">
301       <action name="Resize"><edge>top</edge></action>
302     </mousebind>
303   </context>
304
305   <context name="Left">
306     <mousebind button="Left" action="Press">
307       <action name="Focus"/>
308     </mousebind>
309     <mousebind button="Left" action="Click">
310       <action name="Raise"/>
311     </mousebind>
312     <mousebind button="Left" action="Drag">
313       <action name="Resize"><edge>top</edge></action>
314     </mousebind>
315   </context>
316
317   <context name="Right">
318     <mousebind button="Left" action="Press">
319       <action name="Focus"/>
320     </mousebind>
321     <mousebind button="Left" action="Click">
322       <action name="Raise"/>
323     </mousebind>
324     <mousebind button="Left" action="Drag">
325       <action name="Resize"><edge>top</edge></action>
326     </mousebind>
327   </context>
328
329   <context name="Handle">
330     <mousebind button="Left" action="Press">
331       <action name="Focus"/>
332     </mousebind>
333     <mousebind button="Left" action="Click">
334       <action name="Raise"/>
335     </mousebind>
336     <mousebind button="Left" action="Drag">
337       <action name="Resize"><edge>bottom</edge></action>
338     </mousebind>
339
340     <mousebind button="Middle" action="Press">
341       <action name="Focus"/>
342       <action name="Lower"/>
343     </mousebind>
344
345     <mousebind button="Right" action="Press">
346       <action name="Focus"/>
347       <action name="ShowMenu"><menu>client-menu</menu></action>
348     </mousebind>
349   </context>
350
351   <context name="BLCorner">
352     <mousebind button="Left" action="Press">
353       <action name="Focus"/>
354     </mousebind>
355     <mousebind button="Left" action="Click">
356       <action name="Raise"/>
357     </mousebind>
358     <mousebind button="Left" action="Drag">
359       <action name="Resize"/>
360     </mousebind>
361   </context>
362
363   <context name="BRCorner">
364     <mousebind button="Left" action="Press">
365       <action name="Focus"/>
366     </mousebind>
367     <mousebind button="Left" action="Click">
368       <action name="Raise"/>
369     </mousebind>
370     <mousebind button="Left" action="Drag">
371       <action name="Resize"/>
372     </mousebind>
373   </context>
374
375   <context name="TLCorner">
376     <mousebind button="Left" action="Press">
377       <action name="Focus"/>
378     </mousebind>
379     <mousebind button="Left" action="Click">
380       <action name="Raise"/>
381     </mousebind>
382     <mousebind button="Left" action="Drag">
383       <action name="Resize"/>
384     </mousebind>
385   </context>
386
387   <context name="TRCorner">
388     <mousebind button="Left" action="Press">
389       <action name="Focus"/>
390     </mousebind>
391     <mousebind button="Left" action="Click">
392       <action name="Raise"/>
393     </mousebind>
394     <mousebind button="Left" action="Drag">
395       <action name="Resize"/>
396     </mousebind>
397   </context>
398
399   <context name="Client">
400     <mousebind button="Left" action="Press">
401       <action name="Activate"/>
402     </mousebind>
403     <mousebind button="Middle" action="Press">
404       <action name="Activate"/>
405     </mousebind>
406     <mousebind button="Right" action="Press">
407       <action name="Activate"/>
408     </mousebind>
409   </context>
410
411   <context name="Icon">
412     <mousebind button="Left" action="Press">
413       <action name="Focus"/>
414       <action name="ShowMenu"><menu>client-menu</menu></action>
415     </mousebind>
416     <mousebind button="Right" action="Press">
417       <action name="Focus"/>
418       <action name="ShowMenu"><menu>client-menu</menu></action>
419     </mousebind>
420   </context>
421
422   <context name="AllDesktops">
423     <mousebind button="Left" action="Press">
424       <action name="Focus"/>
425     </mousebind>
426     <mousebind button="Left" action="Click">
427       <action name="ToggleOmnipresent"/>
428     </mousebind>
429   </context>
430
431   <context name="Shade">
432     <mousebind button="Left" action="Press">
433       <action name="Focus"/>
434     </mousebind>
435     <mousebind button="Left" action="Click">
436       <action name="ToggleShade"/>
437     </mousebind>
438   </context>
439
440   <context name="Iconify">
441     <mousebind button="Left" action="Press">
442       <action name="Focus"/>
443     </mousebind>
444     <mousebind button="Left" action="Click">
445       <action name="Iconify"/>
446     </mousebind>
447   </context>
448
449   <context name="Maximize">
450     <mousebind button="Left" action="Press">
451       <action name="Focus"/>
452     </mousebind>
453     <mousebind button="Middle" action="Press">
454       <action name="Focus"/>
455     </mousebind>
456     <mousebind button="Right" action="Press">
457       <action name="Focus"/>
458     </mousebind>
459     <mousebind button="Left" action="Click">
460       <action name="ToggleMaximizeFull"/>
461     </mousebind>
462     <mousebind button="Middle" action="Click">
463       <action name="ToggleMaximizeVert"/>
464     </mousebind>
465     <mousebind button="Right" action="Click">
466       <action name="ToggleMaximizeHorz"/>
467     </mousebind>
468   </context>
469
470   <context name="Close">
471     <mousebind button="Left" action="Press">
472       <action name="Focus"/>
473     </mousebind>
474     <mousebind button="Left" action="Click">
475       <action name="Close"/>
476     </mousebind>
477   </context>
478
479   <context name="Desktop">
480     <mousebind button="Up" action="Press">
481       <action name="DesktopPrevious"/>
482     </mousebind>
483     <mousebind button="Down" action="Press">
484       <action name="DesktopNext"/>
485     </mousebind>
486
487     <mousebind button="A-Up" action="Press">
488       <action name="DesktopPrevious"/>
489     </mousebind>
490     <mousebind button="A-Down" action="Press">
491       <action name="DesktopNext"/>
492     </mousebind>
493
494     <mousebind button="Left" action="Press">
495       <action name="Activate"/>
496     </mousebind>
497   </context>
498
499   <context name="Root">
500     <!-- Menus -->
501     <mousebind button="Middle" action="Press">
502       <action name="ShowMenu"><menu>client-list-combined-menu</menu></action>
503     </mousebind> 
504     <mousebind button="Right" action="Press">
505       <action name="ShowMenu"><menu>root-menu</menu></action>
506     </mousebind>
507   </context>
508
509   <context name="MoveResize">
510     <mousebind button="Up" action="Press">
511       <action name="DesktopPrevious"/>
512     </mousebind>
513     <mousebind button="Down" action="Press">
514       <action name="DesktopNext"/>
515     </mousebind>
516     <mousebind button="A-Up" action="Press">
517       <action name="DesktopPrevious"/>
518     </mousebind>
519     <mousebind button="A-Down" action="Press">
520       <action name="DesktopNext"/>
521     </mousebind>
522   </context>
523 </mouse>
524
525 <menu>
526   <!-- You can specify more than one menu file in here and they are all loaded,
527        just don't make menu ids clash or, well, it'll be kind of pointless -->
528
529   <!-- default menu file (or custom one in $HOME/.config/openbox/) -->
530   <file>menu.xml</file>
531   <hideDelay>200</hideDelay>
532   <middle>no</middle>
533   <submenuShowDelay>100</submenuShowDelay>
534   <applicationIcons>yes</applicationIcons>
535 </menu>
536
537 <applications>
538 <!--
539   # this is an example with comments through out. use these to make your
540   # own rules, but without the comments of course.
541
542   <application name="first element of window's WM_CLASS property (see xprop)"
543               class="second element of window's WM_CLASS property (see xprop)"
544                role="the window's WM_WINDOW_ROLE property (see xprop)">
545   # the name or the class can be set, or both. this is used to match
546   # windows when they appear. role can optionally be set as well, to
547   # further restrict your matches.
548
549   # the name, class, and role use simple wildcard matching such as those
550   # used by a shell. you can use * to match any characters and ? to match
551   # any single character.
552
553   # when multiple rules match a window, they will all be applied, in the
554   # order that they appear in this list
555
556
557     # each element can be left out or set to 'default' to specify to not 
558     # change that attribute of the window
559
560     <decor>yes</decor>
561     # enable or disable window decorations
562
563     <shade>no</shade>
564     # make the window shaded when it appears, or not
565
566     <position>
567       # the position is only used if both an x and y coordinate are provided
568       # (and not set to 'default')
569       <x>center</x>
570       # a number like 50, or 'center' to center on screen
571       <y>200</y>
572       # a number like 50, or 'center' to center on screen
573       <monitor>1</monitor>
574       # specifies the monitor in a xinerama setup.
575       # 1 is the first head, or 'mouse' for wherever the mouse is
576     </position>
577
578     <focus>yes</focus>
579     # if the window should try be given focus when it appears. if this is set
580     # to yes it doesn't guarantee the window will be given focus. some
581     # restrictions may apply, but Openbox will try to
582
583     <desktop>1</desktop>
584     # 1 is the first desktop, 'all' for all desktops
585
586     <layer>normal</layer>
587     # 'above', 'normal', or 'below'
588
589     <iconic>no</iconic>
590     # make the window iconified when it appears, or not
591
592     <skip_pager>no</skip_pager>
593     # asks to not be shown in pagers
594
595     <skip_taskbar>no</skip_taskbar>
596     # asks to not be shown in taskbars. window cycling actions will also
597     # skip past such windows
598
599     <fullscreen>yes</fullscreen>
600     # make the window in fullscreen mode when it appears
601
602     <maximized>true</maximized>
603     # 'Horizontal', 'Vertical' or boolean (yes/no)
604   </application>
605
606   # end of the example
607 -->
608 </applications>
609
610 </openbox_config>