2
######## This is the conf file of Cairo-Dock, released under the GPL.##########
3
######## It is parsed by cairo-dock to automatically generate an appropriate GUI,##########
4
######## so don't mess into it, except if you know what you're doing ! ;-)##########
8
#F-[Position on the screen;gtk-fullscreen]
11
#l-[bottom;top;right;left] Choose which border of the screen the dock will be placed on:
14
#e-[0.;1.;left;right] Relative alignment:
15
#{When set to 0 the dock will position itself relative to the left corner if horizontal and the top corner if vertical. When set to 1 it will position itself relative to the right corner if horizontal and the bottom corner if vertical. When set to 0.5, it will position itself relative to the middle of the screen's edge.}
18
#F-[Offset from the screen's edge;gtk-leave-fullscreen]
21
#I-[-1000;1000] Lateral offset:
22
#{Gap from the absolute position on the screen's edge, in pixels. You can also move the dock by holding the ALT or CTRL key and the left mouse button.}
24
#i-[-30;1000] Distance to the screen edge:
25
#{in pixels. You can also move the dock by holding the ALT or CTRL key and the left mouse button.}
32
#{This option is to use if you have a dual-screen and use Xinerama to manage them.}
35
#i-[0;12] Number of the screen where the dock should be located:
36
#{0 is the first screen.}
42
#F-[Visibility of the main dock;gtk-find]
45
#Y-[Always on top;0;0;Reserve space for the dock;0;0;Keep the dock below;2;2;Hide the dock when it overlaps the current window;1;3;Hide the dock whenever it overlaps any window;1;3;Keep the dock hidden;1;3;Pop-up on shortcut;4;1] Visibility:
46
#{Modes are sorted from the most intrusive to the less intrusive.
47
#When the dock is hidden or below a window, place the mouse on the screen's border to call it back.
48
#When the dock pops up on shortcut, it will appear at the position of your mouse. The rest of the time, it stays invisible, thus acting like a menu.}
54
#L-[None;Move down;Fade out;Semi transparent;Zoom out;Folding] Effect used to hide the dock:
57
#e-[0;1;high;low] Callback sensitivity:
58
#{The higher, the faster the dock will appear}
59
edge sensitivity=0.20000000000000001
61
#Y-[Hit the screen's border;0;0;Hit where the dock is;0;0;Hit the screen's corner;0;0;Hit a zone;1;2] How to call the dock back:
64
#j-[2;999] Size of the zone :
67
#S- Image to display on the zone :
70
#k- Keyboard shortcut to pop-up the dock:
71
#{When you press the shortcut, the dock will show itself at the potition of your mouse. The rest of the time, it stays invisible, thus acting like a menu.}
74
#F-[Additional parameters]
77
max_authorized_width=0
79
#b- Automatically hide the dock when a window becomes full screen?
80
#{This is only usefull if you do not already use auto-hide and if your Window Manager allows the dock in front of fullscreen windows (which is rare).}
83
#F-[Sub-docks' visibility;/usr/share/cairo-dock/icons/icon-subdock.png]
86
#Y-[Appear on mouse over;1;1;Appear on click;0;0] Visibility:
87
#{they will appear either when you click or when you linger over the icon pointing on it.}
90
#i- Delay before displaying a sub-dock:
94
#i- Delay before leaving a sub-dock takes effect:
104
#F-[Behaviour;gtk-properties]
107
#B-[8] Show currently opened applications in the dock?
108
#{Cairo-Dock will then act as your taskbar. It is recommended to remove any other taskbars.}
109
show applications=true
111
#b- Mix launchers and applications
112
#{Allows launchers to act as applications when their programs are running and displays a marker on icons to indicate this. You can launch other occurences of the program with SHIFT+click.}
113
mix launcher appli=true
115
#b- Only show applications on current desktop
116
current desktop only=false
118
#b- Only show icons whose windows are minimised
121
#Y-[At the beginning of the dock;0;0;Before the launchers;0;0;After the launchers;0;0;At the end of the dock;0;0;After a given icon;1;1] Place new icons
124
#N Place new icons after this one
127
#B- Group windows from the same application in a sub-dock ?
128
#{This allows you to group all the windows of a given application into a unique sub-dock, and to act on all of the windows at the same time.}
131
#s- Except the following classes:
132
#{Enter the class of the applications, separated by a semi-colon ';'}
136
#F-[Representation;gtk-find]
139
#B- Overwrite the X icon with the launchers' icon?
140
#{If not set, the icon provided by X for each application will be used. If set, the same icon as the corresponding launcher will be used for each application.}
143
#s- Except the following classes:
144
#{Enter the class of the applications, separated by a semi-colon ';'}
145
overwrite exception=evince;totem;gimp;nautilus
147
#Y-[Make the icon transparent;1;1;Show a window's thumbnail;0;0;Draw it bent backwards;0;0] How to draw minimised windows ?
148
#{A composite manager is required to display the thumbnail.
149
#OpenGL is required to draw the icon bent backwards.}
152
#e-[0;.6;Opaque;Transparent] Transparency of icons whose window is minimised:
153
visibility alpha=0.34999999999999998
155
#a- Play a short animation of the icon when its window becomes active
156
animation on active window=wobbly
158
#i- Maximum number of caracters in application name:
159
#{"..." will be added at the end if the name is too long.}
162
#F-[Interaction;gtk-refresh]
165
#l-[Nothing;Close;Minimize;Launch new;Lower] Action on middle-click on the related application
166
action on middle click=1
168
#b- Minimise the window when its icon is clicked, if it was already the active window ?
169
#{This is the default behaviour of most taskbars.}
170
minimize on click=true
172
#b- Present windows preview on click when several windows are grouped togather
173
#{Only if your Window Manager supports it.}
174
present class on click=true
179
#B-[2] Highlight applications requiring your attention with a dialog bubble
180
demands attention with dialog=true
182
#i-[1;20] Duration of the dialog:
186
#s- Force the following applications to demand your attention
187
#{It will notify you even if, for instance, you are watching a movie in full screen or you are on another desktop.
189
force demands attention=
191
#a- Highlight applications demanding your attention with an animation
192
animation on demands attention=rotate
198
#F[Keyboard shortcuts currently available;gtk-select-font]
202
#{Many applets provide shortkeys for their actions. As soon as an applet is enabled, its shortkeys become available.
203
#Double-click on a line, and press the shortkey you want to use for the corresponding action.}
204
shortkeys=Show/hide the systray;Show/hide the Sound menu;Enable/disable the keyboard control of the dock;Show/hide the Recent Events;Show/hide the quick-launch dialog;Show/hide the Applications menu;Show/hide the folder menu;Pop-up the items menu;Enable/disable the Finder;Pouet;Show the log-out menu;Lock the screen;
209
#X-[Animations speed;/usr/share/cairo-dock/icons/icon-movment.png]
212
#B- Animate sub-docks when they appear
213
animate subdocks=true
215
#I-[100;600;fast;slow] Animation unfolding duration:
216
#{Icons will appear folded on themselves and will then unfold until they fill the whole dock. The smaller this value, the faster this will be.}
222
#I-[4;40;fast;slow] Number of steps in the zoom animation (grow/shrink):
223
#{The more there are, the slower it will be}
225
#I-[4;40;fast;slow] ...
231
#I-[4;40;fast;slow] Number of steps in the auto-hide animation (move up/move down):
232
#{The more there are, the slower it will be}
234
#I-[4;40;fast;slow] ...
235
move down nb steps=11
237
#X-[Refresh rate;gtk-execute]
240
#i-[5;40] Refresh rate when mouving cursor into the dock :
241
#{in Hz. This is to adjust behaviour relative to your CPU power.}
244
#i-&[15;60] Animation frequency for the OpenGL backend :
245
#{in Hz. This is to adjust behaviour relative to your CPU power.}
248
#i-*[15;50] Animation frequency for the Cairo backend :
249
#{in Hz. This is to adjust behaviour relative to your CPU power.}
252
#b-* Reflections should be calculated in real-time?
253
#{The transparency gradation pattern will then be re-calculated in real time. May need more CPU power.}
254
dynamic reflection=false
256
#X-[Composition;gtk-clear]
258
#b- Emulate composition with fake transparency?
259
#{Only use this if you don't run a composite manager like Compiz, xcompmgr, etc and have a black background around your dock. For aesthetic reasons, the dock will be kept under other windows.}
260
fake transparency=false
262
#X-[Connection to the Internet;gtk-network]
265
#i-[1;20] Connection timeout :
266
#{Maximum time in seconds that you allow the connection to the server to take. This only limits the connection phase, once the dock has connected this option is of no more use.}
269
#i-[10;300] Maximum time to download a file:
270
#{Maximum time in seconds that you allow the whole operation to last. Some themes can be up to a few MB.}
274
#{Use this option if you experience problems to connect.}
277
#B-[4] Are you behind a proxy ?
278
#{Use this option if you connect to the Internet through a proxy.}
288
#{Let empty if you don't need to log-in to the proxy with a user/password.}
292
#{Let empty if you don't need to log-in to the proxy with a user/password.}
295
modules=switcher;GMenu;logout;Animated icons;Status-Notifier;Remote-Control;AlsaMixer;Calendar;Recent-Events;Messaging Menu;icon effects;musicPlayer;dnd2share;Clipper;illusion;showDesktop;clock;Quick Browser;PowerManager;Help;shortcuts
300
#y+[Image;Colour gradation] Fill the background with:
303
#F+[Image;gtk-orientation-portrait]
304
#{Use a background image.}
307
#S+ Image filename to use as a background :
308
#{Any format allowed; if empty, the colour gradation will be used as a fall back.}
309
background image=bg.svg
311
#e+[0;1;Transparent;Opaque] Image's transparency :
314
#b+ Repeat image as a pattern to fill background?
317
#F+[Colour gradation;/usr/share/cairo-dock/icons/icon-gradation.png]
318
#{Use a colour gradation.}
322
stripes color bright=0.064515144579232478;0.064515144579232478;0.064515144579232478;0.78429846646829937;
325
stripes color dark=0;0;0;0.96078431372549022;
327
#f+[-90;90] Angle of the gradation :
328
#{In degrees, in relation to the vertical}
331
#i+ Repeat the gradation this number of times:
332
#{If not nul, it will form stripes.}
335
#f+[0;1] Percentage of the bright colour:
336
stripes width=0.49999999999999961
338
#F+[Background when hidden;gtk-orientation-portrait]
341
#C+ Default background color when the dock is hidden
342
#{Several applets can be visible even when the dock is hidden}
343
hidden bg color=0.80000000000000004;0.80000000000000004;0.80000000000000004;0.49999237048905165;
348
#b+ Stretch the dock to always fill the screen
351
#F+[External Frame;/usr/share/cairo-dock/icons/icon-frame.png]
353
#i+[0;30] Corner radius :
357
#i+[0;20] Linewidth of the external line :
361
#C+ Colour of the external line:
362
line color=0;0;0;0.59505607690547035;
364
#i+[0;20] Margin between the frame and the icons or their reflects :
368
#b+ Are the bottom left and right corners rounded?
369
rounded bottom corner=true
377
#n+ Choose the default view for main docks :/
378
main dock view=3D plane
383
#n+ Choose the default view for sub-docks :
384
#{You can overwrite this parameter for each sub-dock.}/
385
sub-dock view=Parabolic
387
#e+[0.5;1.5;smaller;larger] Ratio for the size of the sub-docks' icons :
388
#{You can specify a ratio for the size of the sub-docks' icons, in relation to the main docks' icons size}
389
relative icon size=1.25
394
#F+[Bubble;/usr/share/cairo-dock/icons/icon-bubble.png]
397
#C+ Background colour of the bubble:
398
background color=0;0;0;0.74509803921568629;
403
#t+ Shape of the bubble:
406
#F+[Text;gtk-select-font]
409
#B+ Use a custom font for the text?
410
#{Otherwise the default's system one will be used.}
414
message police=Sans 9
416
#b+ Draw the outline of the text?
422
#F+[Buttons;/usr/share/cairo-dock/icons/icon-buttons.png]
425
#j+[10;64] Size of buttons in the info-bubbles (width x height) :
429
#S+ Name of an image to use for the yes/ok button :
430
#{If you don't provide any, a default image will be used.}
433
#S+ Name of an image to use for the no/cancel button :
434
#{If you don't provide any, a default image will be used.}
440
#i+[16;96] Size of the icon displayed next to the text :
446
#F+[Decorations;gtk-paste]
449
#O+ Choose a default decoration for all desklets :
450
#{This can be customized for each desklet separately.
451
#Choose 'Custom decoration' to define your own decorations below}
457
#S+ Background image :
458
#{It's an image that will be displayed below the drawings, like a frame for example. Leave empty to not use any.}
460
#e+[0;1;Transparent;Opaque] Background transparency :
462
#i+[0;256] Left offset :
463
#{in pixels. Use this to adjust the left position of the drawings.}
465
#i+[0;256] Top offset :
466
#{in pixels. Use this to adjust the top position of the drawings.}
468
#i+[0;256] Right offset :
469
#{in pixels. Use this to adjust the right position of the drawings.}
471
#i+[0;256] Bottom offset :
472
#{in pixels. Use this to adjust the bottom position of the drawings.}
474
#S+ Foreground image :
475
#{It's an image that will be displayed above the drawings, like a reflection for example. Leave empty to not use any.}
477
#e+[0;1;Transparent;Opaque] Foreground tansparency :
480
#F+[Buttons;gtk-close]
483
#i+[4;28] Buttons size :
486
#S+ Name of an image to use for the 'rotate' button :
487
#{If you don't provide any, a default image will be used.}
490
#S+ Name of an image to use for the 'reattach' button :
491
#{If you don't provide any, a default image will be used.}
494
#S+ Name of an image to use for the 'depth rotate' button :
495
#{If you don't provide any, a default image will be used.}
498
#S+ Name of an image to use for the 'rotate' button :
499
#{If you don't provide any, a default image will be used.}
505
#F+[Icons' themes;gtk-select-color]
508
#w+ Choose an icon theme :
509
default icon directory=_Custom Icons_
511
#S+ Image filename to use as a background for icons :
512
#{Any format allowed; leave this field empty if you don't want to use an image as background.}
515
#F+[Icons size;gtk-zoom-fit]
518
#j+[10;128] Icons' size at rest (width x height) :
521
#F+[Zoom effect;/usr/share/cairo-dock/icons/icon-wave.png]
523
#f+[1;5] Maximum zoom of the icons :
524
#{set to 1 if you don't want the icons to zoom when you hover over them.}
527
#i+[1;999] Width of the space in which the zoom will be effective :
528
#{in pixels. Outside of this space (centered on the mouse), there is no zoom.}
531
#i+[0;50] Space between icons :
538
#j+[4;128] Icon size at rest (width x height) :
541
#b+ Force separator's image size to stay constant?
544
#Y+[Use an image.;1;2;Flat separator;3;1;Physical separator;0;0] How to draw the separators?
545
#{Only the default, 3D-plane and curve views support flat and physical separators. Flat separators are rendered differently according to the view.}
548
#S+ Filename of an image to use for separators :
549
#{If you don't provide one, blanks will be used.}
552
#b+ Make the separator's image revolve when dock is on top/on the left/on the right?
553
revolve separator image=true
555
#C+ Colour of flat separators :
556
separator color=0.61290913252460522;0.61290913252460522;0.61290913252460522;0.78820477607385364;
561
#e+[0;1;light;strong] Reflective power of the plane :
562
#{It is its albedo (reflectivity); at 1 the icons reflect to the maximum, at 0 reflections are not used.}
565
#e+[0;1;small;tall] Height of the reflection:
566
#{In percent of the icon's size. This parameter influence the total height of the dock.}
567
field depth=0.40000000000000002
569
#e+[0;1;Transparent;Opaque] Icons' transparency at rest :
570
#{It is their transparency when the dock is at rest; they will "materialize" progressively as the dock grows up. The closer to 0, the more transparent they will be.}
573
#X+[Link the icons with a string]
576
#i+[0;20] Linewidth of the string, in pixels (0 to not use string) :
579
#C+ Colour of the string (red, blue, green, alpha) :
580
string color=0;0;0.59995422293430989;0.40000000000000002;
585
#F+[Indicator of the active window]
588
#Y+[Image;1;1;Frame;2;3] Type of indicator:
594
#C+ Colour of the frame :
595
#{Set transparency to 0 if you don't want to use an indicator.}
596
active color=0.70160982681010142;0.70160982681010142;0.70160982681010142;0.74999618524452583;
598
#i+[0;20] Linewidth of the frame around the active window :
599
#{Set 0 to fill the frame.}
602
#i+[0;30] Corner radius of the frame around the active window :
603
active corner radius=8
608
#b+ Draw indicator above the icon?
609
active frame position=true
612
#F+[Indicator of active launcher]
616
#{Indicators are drawn on launchers icons to show that they have already been launched. Leave blank to use the default one.}
617
indicator image=indicator.png
619
#b- Display an indicator on application icons too ?
620
#{The indicator is drawn on active launchers, but you may want to display it on applications too.}
626
#e+[-0.4;1.2] Vertical offset :
627
#{Relatively to the icons' size. You can use this parameter to adjust the indicator's vertical position.
628
#If the indicator is linked to the icon, the offset will be upwards, otherwise downwards.}
629
indicator offset=1.1469534050179211
631
#b+ Link the indicator with its icon?
632
#{If the indicator is linked to the icon, it will then be zoomed like the icon and the offset will be upwards.
633
#Otherwise it will be drawn directly on the dock and the offset will be downwards.}
634
indicator on icon=false
636
#e+[0.1;1.5;smaller;bigger] Indicator size ratio :
637
#{You can choose to make the indicator smaller or bigger than the icons. The bigger the value is, the bigger the indicator is. 1 means the indicator will have the same size as the icons.}
638
indicator ratio=1.0189999999999999
640
#b+ Rotate the indicator with dock?
641
#{Use it to make the indicator follow the orientation of the dock (top/bottom/right/left).}
642
rotate indicator=true
644
#b+ Draw indicator above the icon?
648
#F+[Indicator of grouped windows]
651
#Y[Draw an emblem;1;2;Draw the sub-dock's icons as a stack;0;0] How to show that several icons are grouped :
655
#{It only makes sense if you chose to group the applis of the same class together. Leave blank to use the default one.}
656
class indicator=active.png
658
#b+ Zoom the indicator with its icon?
664
#F-[Label visibility;gtk-underline]
667
#Y+[No;0;0;On pointed icon;0;0;On all icons;1;1] Show labels:
670
#f-[0.;50.] label's visibility threshold :
671
#{the bigger, the more the labels next to the selected icon will be transparent.}
674
#b- Should the labels always be horizontal, even when dock is vertical?
675
always horizontal=true
677
#F+[Font;gtk-select-font]
680
#B+ Use a custom font for labels?
681
#{Otherwise the default's system one will be used.}
684
#P+ Font used for labels :
687
#b+ Draw the outline of the text?
690
#F+[Background;gtk-orientation-portrait]
693
#C+ Colour of the label's background :
694
#{If you set it to fully transparent, there will be no background for the text, but the margin around the text will still be in effect.}
695
text background color=0;0;0;1;
697
#i+[0;20] Margin around the text (in pixels) :
700
#F+[Colour;gtk-select-color]
704
#{It's the first color of the gradation.}
705
text color start=1;1;1;
708
#{It's the second color of the gradation. Set it to the same value as the first if you don't want to have any gradation.}
709
text color stop=1;1;1;
711
#b+ Pattern should be vertical?
712
#{If checked, the pattern will go from top to bottom, otherwise from left to right.}
713
vertical label pattern=true
715
#F+[Quick-info;stock_dialog-info]
716
#{Quick-info are short information drawn on the icons.}
719
#B[-2] Use the same look as the labels?
725
#C+ Background color:
726
qi bg color=0;0;0;0.68627450980392157;