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