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 screen border the dock will placed on :
12
#{The icons will scroll according to the chosen placement type. Of course the dock can be placed anywhere on the screen, here we specify regarding to what.}
15
#e-[0.;1.;left;right] Relative alignment :
16
#{At 0, the dock will place itself regarding the left corner if horizontal and the top corner if vertical, at 1 regarding the right corner if horizontal and the bottom corner if vertical, and at 0.5, regarding the middle of the screen's edge.}
19
#F-[Offset to the screen's edge;gtk-leave-fullscreen]
22
#I-[-1000;1000] Lateral offset :
23
#{Gap from the absolute position on the screen's edge, in pixels. You can also move the dock by holding ALT or CTRL key and left mouse button.}
25
#i-[-30;1000] Distance to the screen's edge :
26
#{in pixels. You can also move the dock by holding ALT or CTRL key and left mouse button.}
35
#i-[0;12] Number of the screen where the dock should be located :
42
#F-[Visibility of the main dock;gtk-find]
45
#Y-[Always on top;0;0;Prevent windows from overlapping the dock;0;0;Keep the dock below windows;1;1;Automatically hide the dock;0;0;Automatically hide when a window is maximized;0;0;Pop-up on shortcut;2;1] Visibility :
46
#{Prevent windows from overlapping the dock : reserve space at the edge of the screen for the dock.
47
#Auto-hide : the dock will automatically hide itself outside of the scren when the mouse leaves it. Instead, it will show a zone where placing the mouse will trigger the dock and make it re-appear.
48
#Keep the dock below windows : the dock will pop-up on the foreground when you place the mouse on its screen border.
49
#Pop-up on shortcut : When you press the shortcut, the dock will pop-up at the position of your mouse. The rest of the time, it stays invisible, thus acting like a menu.}
52
#b- Pop-up only if the mouse hits a screen corner ?
53
pop in corner only = false;
55
#k- Keyboard shortcut to pop-up the dock :
56
#{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.}
59
#F-[Additionnal parameters]
62
max_authorized_width = 0
64
#b- Extend the dock to always fill the screen ?
67
#j-[1;1600] Size of the callback zone (width x height, in pixels) :
68
#{Place the mouse into it will make the dock re-appear.}
71
#b- Automatically hide the dock when a window becomes fullscreen ?
72
#{This is only usefull if you don't already use the auto-hide, and if your WM let the dock in front of fullscreen windows (which is rare).}
73
auto quick hide = false
76
#F-[Sub-docks' visibility;/usr/share/cairo-dock/icon-subdock.png]
79
#b- Click to show sub-docks ?
80
#{Otherwise they will appear when you linger over the icon pointing on it.}
83
#i- Delay before you effectively leave from a sub-dock or to a sub-dock :
87
#i- Delay before displaying a sub-dock :
88
#{in ms. Unused if you set up to click to show sub-docks.}
97
#F-[Behaviour;gtk-properties]
100
#b- Show currently opened applications in the dock ?
101
#{Cairo-Dock will then replace your taskbar. It is recommanded to remove any other taskbar, and to not force the dock's type to normal.}
102
show applications = true
104
#b- Only show icons whose window is minimized ?
107
#b- Only show applis on current desktop ?
108
current desktop only = false
110
#b- Mix launchers and applis ?
111
#{Allows launchers to act as applis when their program is running, and displays an indicator on their icon to signal it. You can launch other occurences of the program with SHIFT+click.}
112
mix launcher appli = true
114
#B- Group windows of the same application in a sub-dock ?
115
#{This allows 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.}
116
group by class = true
118
#s- Except the following classes :
119
#{enter the class of the applications, separated by a semi-colon ';'}
120
group exception = pidgin;xchat;amsn
123
#F-[Representation;gtk-find]
126
#B- Overwrite X icons with launchers' one ?
127
#{If not set, will use the icon provided by X for each appli. If set, the same icon as the corresponding launcher will be used for each appli.}
128
overwrite xicon = true
130
#s- Except the following classes :
131
#{enter the class of the applications, separated by a semi-colon ';'}
132
overwrite exception = pidgin;xchat;amsn;gimp-2.6
134
#Y-[Make the icon transparent;1;1;Show the window thumbnail;0;0;Draw it bent backwards;0;0] How to draw minimized windows ?
135
#{A composite manager is required to display the thumbnail.
136
#OpenGL is required to draw the icon bent backwards.}
139
#e-[0;.6;opaque;transparent] Transparency of icons whose window is minimized :
140
visibility alpha = 0.35
142
#b- Display an indicator even if the icon is not a launcher ?
143
#{The indicator is drawn on active launchers, but you may want to display it on applis too.}
144
indic on appli = false
146
#a- Play a short animation of the icon when its window becomes active ?
147
animation on active window = wobbly
149
#i- Maximum number of caracters in application's name :
150
#{"..." will be added at the end if the name is too long.}
153
#F-[Interaction;gtk-refresh]
156
#b- Minimize the window when its icon is clicked, if it was already the active window ?
157
#{It is the default behaviour of most of taskbars.}
158
minimize on click = true
160
#b- Middle click on an icon closes its relative application ?
161
#{In a Firefox's tabs manner.}
162
close on middle click = true
167
#B-[2] Signal the applications demanding your attention with a dialog bubble ?
168
demands attention with dialog = true
170
#i-[1;20] Duration of the dialog :
174
#s- Force the following applications to demand your attention ?
175
#{It will notify you even if, for instance, you are watching a movie in fullscreen or you are on another desktop.
177
force demands attention =
179
#a- Signal the applications demanding your attention with an animation ?
180
animation on demands attention = rotate
185
#F-[Animations speed;/usr/share/cairo-dock/icon-movment.png]
188
#b- Animate the dock when auto-hiding ?
189
#{The dock will unfold when it hides/shows itself. No effect if auto-hide is not activated or unfold acceleration is nul.}
190
animate on auto-hide = false
192
#b- Animate sub-docks when they appear ?
193
animate subdocks = true
195
#I-[100;600;fast;slow] Unfolding animation duration :
196
#{The icons will appear folded on themselves, then will unfold untill they fill the whole dock. The smaller, the faster it will be.}
197
unfold duration = 350
202
#I-[4;40;fast;slow] Number of steps in the zoom animation (grow up/shrink down) :
203
#{The more there are, the slower it will be}
205
#I-[4;40;fast;slow] ...
208
#I-[4;40;fast;slow] Number of steps in the fade out animation :
209
#{This is the animation when the dock goes below a window; The greater, the slower it will be}
210
fade out nb steps = 15
212
#I-[4;40;fast;slow] Number of steps in the auto-hide animation (move up/move down) :
213
#{The more there are, the slower it will be}
214
move up nb steps = 10
215
#I-[4;40;fast;slow] ...
216
move down nb steps = 12
218
#F-[Refresh frequency;gtk-execute]
221
#i-[5;40] Refresh frequency when mouving cursor into the dock :
222
#{in Hz. This is to adjust regarding your CPU power.}
223
refresh frequency = 35
225
#i-[15;60] Animation frequency for the opengl backend :
226
#{in Hz. This is to adjust regarding your CPU power.}
227
opengl anim freq = 33
229
#i-[15;50] Animation frequency for the cairo backend :
230
#{in Hz. This is to adjust regarding your CPU power.}
233
#b- Reflections should be calculated in real-time ?
234
#{The transparency gradation pattern will then be re-calculated in real time. May needs more CPU power.}
235
dynamic reflection = false
237
#F-[Label readability;gtk-underline]
240
#b- Should the labels be always horizontal, even when dock is vertical ?
241
always horizontal = true
243
#f-[0.;50.] label's visibility threshold :
244
#{the bigger, the more the labels next to the pointed icon will be transparent.}
245
alpha threshold = 10.
247
#m[Labels] Configure labels appearence.
253
#l-[Name;Size;Date] Sort files by :
256
#b- Show hidden files ?
257
show hidden files = false
259
#F-[Composition;gtk-clear]
261
#b- Emulates composition with fake transparency ?
262
#{Only use this if you don't run a composite manager like Compiz, xcompmgr, etc and have a black background around your dock. For esthetic reason, the dock will be kept under other windows.}
263
fake transparency = false
265
#b- Make the config panel transparent ?
266
#{You need to re-open the panel. It is deactivated by default on KDE.}
267
config transparency = false
269
#X-[Connection to the themes server;/usr/share/cairo-dock/icon-connection.svg]
271
#i-[1;20] Connection timeout to the themes server :
272
#{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.}
275
#i-[10;300] Maximum time to download a theme :
276
#{Maximum time in seconds that you allow the whole operation to take. Some themes can take up to a few MB.}
279
#i-[0;5] Number of retries :
280
#{If an error occurs during downloading a theme, it will retry this number of times before giving up.}
289
#y+[Image;Color gradation] Fill the background with :
292
#F+[Image;gtk-orientation-portrait]
293
#{Use a background image.}
296
#S+ Image's filename to use as a background :
297
#{Any format allowed; if empty, the color gradation will be used as a fallback.}
300
#e+[0;1;transparent;opaque] Image's transparency :
303
#b+ Repeat image as a pattern to fill background ?
306
#F+[Color gradation;/usr/share/cairo-dock/icon-gradation.png]
307
#{Use a color gradation.}
311
stripes color bright = 0.933; 0.933; 0.925; 0.4
314
stripes color dark = 0.827; 0.843; 0.811; 0.6
316
#f+[-90;90] Angle of the gradation :
317
#{In degrees, in relation to the vertical}
320
#i+ Repeat the gradation this number of times :
321
#{If not nul, it will form stripes.}
322
number of stripes = 0
324
#f+[0;1] Percentage of the bright color :
327
#F+[Extern Frame;/usr/share/cairo-dock/icon-frame.png]
329
#i+[0;30] Corner radius :
333
#i+[0;20] Linewidth of the extern line :
337
#C+ Color of the extern line :
338
line color = 0.0; 0.0; 0.8; 0.4
340
#i+[0;20] Margin between the frame and the icons or their reflects :
344
#b+ Are the bottom left and right corners rounded ?
345
rounded bottom corner = true
350
#F[Hidden dock;/usr/share/cairo-dock/icon-hidden-dock.png]
351
#{Configure the dock's appearence when hidden.}
354
#S+ Filename of an image to put on :
355
#{This is what you see when the dock hides itselfs. Any format is allowed. Let this field empty to have an invisible zone.}
356
callback image = background-cairo-dock.svg
358
#e+[0;1;transparent;opaque] Transparency of the image :
361
#b+ Rotate the image when the dock is on top/left/right ?
362
#{Use it when the image is an arrow pointing to the center of the screen for exemple.}
363
callback reverse = true
365
#m[Accessibility] Configure the auto-hide behaviour.
368
#X+[Background movement;/usr/share/cairo-dock/icon-mouse.png]
371
#Y+[No;0;0;Follow the mouse;1;1;Link with the mouse;1;1] Move the background image along with the cursor ?
374
#e+[0.1;1;slow;fast] Speed :
375
#{The smaller, the slower the decorations will move along with the cursor.}
376
decorations speed = 0.5
381
#l+[No;On pointed icon;On all icons] Show labels :
384
#F+[Font;gtk-select-font]
387
#B+ Use a custom font for labels ?
388
#{Otherwise the default system one will be used.}
391
#P+ Font used for labels :
394
#b+ Draw the outline of the text ?
397
#F+[Color;gtk-select-color]
401
#{It's the first color of the gradation.}
402
text color start = 1;1;1
405
#{It's the second color of the gradation. Set it to the same value as the first if you just don't want to have a gradation.}
406
text color stop = 1;1;1
408
#b+ Pattern should be vertical ?
409
#{If checked, the pattern will go from top to bottom, otherwise from left to right.}
410
vertical label pattern = false
412
#F+[Background;gtk-orientation-portrait]
415
#C+ Color of the label's background :
416
#{If you set it to fully transparent, there will be no background for the text, but the margin around the text will still be effective.}
417
text background color = 0;0;0;.5
419
#b+ Use background color for labels ?
420
#{If false, only the quick-info will have this background color.}
421
background for label = false
423
#i+[0;20] Margin around the text (in pixels) :
429
#F+[Icons' themes;gtk-select-color]
432
#w+ Choose a theme of icons :
433
#{Let empty to use the current icons theme of your system. You can enter the name of a theme that is installed on your system (like 'Gartoon' or 'Human'), or even a path to a folder containing icons.}
434
default icon directory =
436
#S+ Image's filename to use as a background for icons :
437
#{Any format allowed; let this field empty if you don't want to use an image as background.}
440
#F+[Zoom effect;/usr/share/cairo-dock/icon-wave.png]
442
#f+[1;5] Maximum zoom of the icons :
443
#{set to 1 if you don't want the icons to zoom when you hover them.}
446
#i+[1;999] Width of the interval in which the zoom will be effective :
447
#{in pixels. Outside of this interval (centered on the mouse), there is no zoom.}
450
#i+[0;50] Space between icons :
457
#e+[0;1;light;strong] Reflecting power of the plane :
458
#{It is its albedo; at 1 the icons reflect to the maximum, at 0 reflects are not used.}
461
#e+[0;1;small;tall] Height of the reflect :
462
#{In percent of the icon's size. This parameter influence the total height of the dock.}
465
#e+[0;1;transparent;opaque] Icons' transparency at rest :
466
#{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.}
472
#j+[10;128] Launcher's size at rest (width x height) :
473
launcher size = 48;48
475
#j+[10;128] Appli's size at rest (width x height) :
478
#j+[10;128] Applet's size at rest (width x height) :
481
#m[Animated icons] Configure icons animations.
484
#M[icon effects] Configure icons special effects (require OpenGL capacity).
487
#M[illusion] Configure icons animations on appearing/disappearing (require OpenGL capacity).
493
#j+[4;64] Icon size at rest (width x height) :
494
separator size = 48;48
496
#Y+[Use an image;1;4;Flat separator;4;1;Physical separator;0;0] How to draw the separators :
497
#{Only the default, 3D-plane and curve views support flat and physical separators. Flat separators are rendered differently according to the view.}
500
#S+ Filename of an image to use for separators :
501
#{If you don't provide one, blanks will be used.}
502
separator image = separateur.svg
504
#b+ Make the separator's image revolve when dock is on top/on the left/on the right ?
505
revolve separator image = true
507
#b+ Force separator's image size to stay constant ?
510
#C+ Color of flat separators :
511
separator color = 0.9;0.9;0.9;1.0
517
#Y+[No;0;0;Separate applications from others;1;1;Separate applets from others;1;1;Separate all;1;1] Separate the different types of icons ?
518
#{If you separate a type of icons, the icons of this type will be placed togather, separated from the others by a separator.
519
#If you don't separate the icons, you can place them wherever you want, and insert separators manually. Applications will then be placed next to their launcher if they have, or after the last launcher.}
522
#T+[launchers;applications;applets] Order of the different types of icons :
523
icon's type order = 0;1;2
526
#X+[Link the icons with a string]
529
#i+[0;20] Linewidth of the string, in pixels (0 to not use string) :
532
#C+ Color of the string (red, blue, green, alpha) :
533
string color = 0.0; 0.0; 0.8; 0.4
541
#n+ Choose the default view for main docks :/
542
main dock view = default
547
#n+ Choose the default view for sub-docks :
548
#{You can overwrite this parameter for each sub-dock.}/
549
sub-dock view = default
551
same_horizontality = true
553
#e+[0.1;1.;smaller;same size] Ratio for the size of the sub-docks' icons :
554
#{You can specify a ratio for the size of the sub-docks' icons, regarding the main docks' icons size}
555
relative icon size = .8
560
#F+[Bubble;/usr/share/cairo-dock/icon-bubble.png]
563
#C+ Background color of the bubble :
564
background color = 1.0; 1.0; 1.0; 0.8
569
#t+ Shape of the bubble :
572
#F+[Text;gtk-select-font]
575
#B+ Use a custom font for the text ?
576
#{Otherwise the default system one will be used.}
582
#b+ Draw the outline of the text ?
586
text color = 0.0; 0.0; 0.0
588
#F+[Buttons;/usr/share/cairo-dock/icon-buttons.png]
591
#j+[10;64] Size of buttons in the info-bubbles (width x height) :
595
#S+ Name of an image to use for the yes/ok button :
596
#{If you don't provide any, a default image will be used.}
599
#S+ Name of an image to use for the no/cancel button :
600
#{If you don't provide any, a default image will be used.}
601
button_cancel image =
606
#i+[16;96] Size of the icon displayed next to the text :
612
#F+[Decorations;gtk-paste]
615
#O+ Choose a default decoration for all desklets :
616
#{This can be customized for each desklet separately.
617
#Choose 'Custom decoration' to define your own decorations below}
623
#S+ Background image :
624
#{It's an image that will be displayed below the drawings, like a frame for exemple. Let empty to not use any.}
626
#e+[0;1;transparent;opaque] Background tansparency :
628
#i+[0;256] Left offset :
629
#{in pixels. Use this to adjust the left position of the drawings.}
631
#i+[0;256] Top offset :
632
#{in pixels. Use this to adjust the top position of the drawings.}
634
#i+[0;256] Right offset :
635
#{in pixels. Use this to adjust the right position of the drawings.}
637
#i+[0;256] Bottom offset :
638
#{in pixels. Use this to adjust the bottom position of the drawings.}
640
#S+ Foreground image :
641
#{It's an image that will be displayed above the drawings, like a reflect for exemple. Let empty to not use any.}
643
#e+[0;1;transparent;opaque] Foreground tansparency :
646
#F+[Buttons;gtk-close]
649
#i+[4;28] Buttons size :
652
#S+ Name of an image to use for the 'rotate' button :
653
#{If you don't provide any, a default image will be used.}
656
#S+ Name of an image to use for the 'retach' button :
657
#{If you don't provide any, a default image will be used.}
660
#S+ Name of an image to use for the 'depth rotate' button :
661
#{If you don't provide any, a default image will be used.}
667
#F+[Indicator of the active window]
670
#Y+[Image;1;1;Frame;2;3] Type of indicator :
671
active indic type = 1
676
#C+ Color of the frame :
677
#{Set transparency to 0 if you don't want to use an indicator.}
678
active color = 0.; 0.4; 0.8; 0.5
680
#i+[0;20] Linewidth of the frame around the active window :
681
#{Set 0 to fill the frame.}
682
active line width = 3
684
#i+[0;30] Corner radius of the frame around the active window :
685
active corner radius = 6
690
#b+ Draw indicator above the icon ?
691
active frame position = true
694
#F+[Indicator of active launcher]
698
#{Indicators are drawn on launchers icons to show that they have already been launched. Let blank to use the default one.}
701
#b+ Draw indicator above the icon ?
702
indicator above = true
704
#e+[0.1;1.5;smaller;bigger] Indicator size ratio :
705
#{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.}
708
#i+[-10;64] Vertical offset :
709
#{in pixels. You can use this parameter to adjust the indicator's vertical position.}
712
#b+ Link the indicator with its icon ?
713
#{It will then be resized like the icon, move like the icon, etc. Otherwise it will be drawn directly on the dock.}
714
link indicator = true
716
#b+ Rotate the indicator with dock ?
717
#{Use it to make the indicator rotate according to the position of the dock (top/bottom/right/left)}
718
rotate indicator = true
721
#F+[Indicator of grouped windows]
725
#{It only makes sense if you choosed to group the applis of the same class togather. Let blank to use the default one.}
728
#b+ Zoom the indicator with its icon ?