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