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;fast;slow] Callback sensitivity:
58
edge sensitivity = 0.15
60
#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:
63
#j-[2;999] Size of the zone :
66
#S- Image to display on the zone :
69
#k- Keyboard shortcut to pop-up the dock:
70
#{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.}
73
#F-[Additional parameters]
76
max_authorized_width=0
78
#b- Automatically hide the dock when a window becomes full screen?
79
#{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).}
82
#F-[Sub-docks' visibility;/usr/share/cairo-dock/icons/icon-subdock.png]
85
#Y-[Appear on mouse over;1;1;Appear on click;0;0] Visibility:
86
#{they will appear either when you click or when you linger over the icon pointing on it.}
89
#i- Delay before displaying a sub-dock:
93
#i- Delay before leaving a sub-dock takes effect:
103
#F-[Behaviour;gtk-properties]
106
#B-[5] Show currently opened applications in the dock?
107
#{Cairo-Dock will then act as your taskbar. It is recommended to remove any other taskbars.}
108
show applications=true
110
#b- Only show icons whose windows are minimised
113
#b- Only show applications on current desktop
114
current desktop only=false
116
#b- Mix launchers and applications
117
#{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.}
118
mix launcher appli=true
120
#B- Group windows from the same application in a sub-dock ?
121
#{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.}
124
#s- Except the following classes:
125
#{Enter the class of the applications, separated by a semi-colon ';'}
129
#F-[Representation;gtk-find]
132
#B- Overwrite the X icon with the launchers' icon?
133
#{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.}
136
#s- Except the following classes:
137
#{Enter the class of the applications, separated by a semi-colon ';'}
138
overwrite exception=evince;totem;gimp
140
#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 ?
141
#{A composite manager is required to display the thumbnail.
142
#OpenGL is required to draw the icon bent backwards.}
145
#e-[0;.6;Opaque;Transparent] Transparency of icons whose window is minimised:
146
visibility alpha=0.35
148
#a- Play a short animation of the icon when its window becomes active
149
animation on active window=wobbly
151
#i- Maximum number of caracters in application name:
152
#{"..." will be added at the end if the name is too long.}
155
#F-[Interaction;gtk-refresh]
158
#l-[Nothing;Close;Minimize;Launch new] Action on middle-click on the related application
159
action on middle click=1
161
#b- Minimise the window when its icon is clicked, if it was already the active window ?
162
#{This is the default behaviour of most taskbars.}
163
minimize on click=true
165
#b- Present windows preview on click when several windows are grouped togather
166
#{Only if your Window Manager supports it.}
167
present class on click=true
172
#B-[2] Highlight applications requiring your attention with a dialog bubble
173
demands attention with dialog=true
175
#i-[1;20] Duration of the dialog:
179
#s- Force the following applications to demand your attention
180
#{It will notify you even if, for instance, you are watching a movie in full screen or you are on another desktop.
182
force demands attention=
184
#a- Highlight applications demanding your attention with an animation
185
animation on demands attention=rotate
190
#X-[Animations speed;/usr/share/cairo-dock/icons/icon-movment.png]
193
#B- Animate sub-docks when they appear
194
animate subdocks=true
196
#I-[100;600;fast;slow] Animation unfolding duration:
197
#{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.}
203
#I-[4;40;fast;slow] Number of steps in the zoom animation (grow/shrink):
204
#{The more there are, the slower it will be}
206
#I-[4;40;fast;slow] ...
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}
215
#I-[4;40;fast;slow] ...
216
move down nb steps=16
218
#X-[Refresh rate;gtk-execute]
221
#i-[5;40] Refresh rate when mouving cursor into the dock :
222
#{in Hz. This is to adjust behaviour relative to your CPU power.}
225
#i-[15;60] Animation frequency for the OpenGL backend :
226
#{in Hz. This is to adjust behaviour relative to your CPU power.}
229
#i-[15;50] Animation frequency for the Cairo backend :
230
#{in Hz. This is to adjust behaviour relative to 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 need more CPU power.}
235
dynamic reflection=false
237
#X-[Composition;gtk-clear]
239
#b- Emulate composition with fake transparency?
240
#{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.}
241
fake transparency=false
243
#b- Make the config panel transparent?
244
#{You need to re-open the panel. It is deactivated by default on KDE.}
245
config transparency=false
247
#X-[Connection to the Internet;gtk-network]
250
#i-[1;20] Connection timeout :
251
#{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.}
254
#i-[10;300] Maximum time to download a file:
255
#{Maximum time in seconds that you allow the whole operation to last. Some themes can be up to a few MB.}
259
#{Use this option if you experience problems to connect.}
262
#B-[4] Are you behind a proxy ?
263
#{Use this option if you connect to the Internet through a proxy.}
273
#{Let empty if you don't need to log-in to the proxy with a user/password.}
277
#{Let empty if you don't need to log-in to the proxy with a user/password.}
280
modules=switcher;dnd2share;illusion;logout;showDesktop;shortcuts;Quick Browser;GMenu;Recent-Events;Animated icons;icon effects;Scooby-Do;musicPlayer;Help;Remote-Control
285
#y+[Image;Colour gradation] Fill the background with:
288
#F+[Image;gtk-orientation-portrait]
289
#{Use a background image.}
292
#S+ Image filename to use as a background :
293
#{Any format allowed; if empty, the colour gradation will be used as a fall back.}
294
background image=bg.svg
296
#e+[0;1;Transparent;Opaque] Image's transparency :
299
#b+ Repeat image as a pattern to fill background?
302
#F+[Colour gradation;/usr/share/cairo-dock/icons/icon-gradation.png]
303
#{Use a colour gradation.}
307
stripes color bright=0.064515144579232478;0.064515144579232478;0.064515144579232478;0.78429846646829937;
310
stripes color dark=0;0;0;0.96078431372549022;
312
#f+[-90;90] Angle of the gradation :
313
#{In degrees, in relation to the vertical}
316
#i+ Repeat the gradation this number of times:
317
#{If not nul, it will form stripes.}
320
#f+[0;1] Percentage of the bright colour:
321
stripes width=0.49999999999999961
326
#b+ Stretch the dock to always fill the screen
329
#F+[External Frame;/usr/share/cairo-dock/icons/icon-frame.png]
331
#i+[0;30] Corner radius :
335
#i+[0;20] Linewidth of the external line :
339
#C+ Colour of the external line:
340
line color=0;0;0;0.54999618524452587;
342
#i+[0;20] Margin between the frame and the icons or their reflects :
346
#b+ Are the bottom left and right corners rounded?
347
rounded bottom corner=true
355
#n+ Choose the default view for main docks :/
356
main dock view=3D plane
361
#n+ Choose the default view for sub-docks :
362
#{You can overwrite this parameter for each sub-dock.}/
365
#e+[0.1;1.5;smaller;same size] Ratio for the size of the sub-docks' icons :
366
#{You can specify a ratio for the size of the sub-docks' icons, in relation to the main docks' icons size}
367
relative icon size=1.2
372
#F+[Bubble;/usr/share/cairo-dock/icons/icon-bubble.png]
375
#C+ Background colour of the bubble:
376
background color=0;0;0;0.74509803921568629;
381
#t+ Shape of the bubble:
384
#F+[Text;gtk-select-font]
387
#B+ Use a custom font for the text?
388
#{Otherwise the default's system one will be used.}
392
message police=Sans 11
394
#b+ Draw the outline of the text?
400
#F+[Buttons;/usr/share/cairo-dock/icons/icon-buttons.png]
403
#j+[10;64] Size of buttons in the info-bubbles (width x height) :
407
#S+ Name of an image to use for the yes/ok button :
408
#{If you don't provide any, a default image will be used.}
411
#S+ Name of an image to use for the no/cancel button :
412
#{If you don't provide any, a default image will be used.}
418
#i+[16;96] Size of the icon displayed next to the text :
424
#F+[Decorations;gtk-paste]
427
#O+ Choose a default decoration for all desklets :
428
#{This can be customized for each desklet separately.
429
#Choose 'Custom decoration' to define your own decorations below}
435
#S+ Background image :
436
#{It's an image that will be displayed below the drawings, like a frame for example. Leave empty to not use any.}
438
#e+[0;1;Transparent;Opaque] Background transparency :
440
#i+[0;256] Left offset :
441
#{in pixels. Use this to adjust the left position of the drawings.}
443
#i+[0;256] Top offset :
444
#{in pixels. Use this to adjust the top position of the drawings.}
446
#i+[0;256] Right offset :
447
#{in pixels. Use this to adjust the right position of the drawings.}
449
#i+[0;256] Bottom offset :
450
#{in pixels. Use this to adjust the bottom position of the drawings.}
452
#S+ Foreground image :
453
#{It's an image that will be displayed above the drawings, like a reflection for example. Leave empty to not use any.}
455
#e+[0;1;Transparent;Opaque] Foreground tansparency :
458
#F+[Buttons;gtk-close]
461
#i+[4;28] Buttons size :
464
#S+ Name of an image to use for the 'rotate' button :
465
#{If you don't provide any, a default image will be used.}
468
#S+ Name of an image to use for the 'reattach' button :
469
#{If you don't provide any, a default image will be used.}
472
#S+ Name of an image to use for the 'depth rotate' button :
473
#{If you don't provide any, a default image will be used.}
476
#S+ Name of an image to use for the 'rotate' button :
477
#{If you don't provide any, a default image will be used.}
483
#F+[Icons' themes;gtk-select-color]
486
#w+ Choose an icon theme :
487
#{Leave empty to use the current icon 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.}
488
default icon directory=_Custom Icons_
490
#S+ Image filename to use as a background for icons :
491
#{Any format allowed; leave this field empty if you don't want to use an image as background.}
494
#F+[Zoom effect;/usr/share/cairo-dock/icons/icon-wave.png]
496
#f+[1;5] Maximum zoom of the icons :
497
#{set to 1 if you don't want the icons to zoom when you hover over them.}
500
#i+[1;999] Width of the space in which the zoom will be effective :
501
#{in pixels. Outside of this space (centered on the mouse), there is no zoom.}
504
#i+[0;50] Space between icons :
511
#e+[0;1;light;strong] Reflective power of the plane :
512
#{It is its albedo (reflectivity); at 1 the icons reflect to the maximum, at 0 reflections are not used.}
515
#e+[0;1;small;tall] Height of the reflection:
516
#{In percent of the icon's size. This parameter influence the total height of the dock.}
517
field depth=0.40000000000000002
519
#e+[0;1;Transparent;Opaque] Icons' transparency at rest :
520
#{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.}
526
#j+[10;128] Launcher's size at rest (width x height) :
529
#j+[10;128] Application's size at rest (width x height) :
532
#j+[10;128] Applet's size at rest (width x height) :
535
#m[Animated icons] Configure icons' animations.
538
#M[icon effects] Configure icons' special effects (requires OpenGL).
541
#M[illusion] Configure icons' animations on appearing/disappearing (require OpenGL capacity).
547
#j+[4;128] Icon size at rest (width x height) :
550
#b+ Force separator's image size to stay constant?
553
#Y+[Use an image.;1;2;Flat separator;3;1;Physical separator;0;0] How to draw the separators?
554
#{Only the default, 3D-plane and curve views support flat and physical separators. Flat separators are rendered differently according to the view.}
557
#S+ Filename of an image to use for separators :
558
#{If you don't provide one, blanks will be used.}
561
#b+ Make the separator's image revolve when dock is on top/on the left/on the right?
562
revolve separator image=true
564
#C+ Colour of flat separators :
565
separator color=0.61290913252460522;0.61290913252460522;0.61290913252460522;0.78820477607385364;
571
#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?
572
#{If you separate a type of icons, the icons of this type will be placed together, separated from the others by a separator.
573
#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 one, or after the last launcher.}
576
#T+[launchers;applications;applets] Order of the different types of icons :
577
icon's type order=0;1;2;
580
#X+[Link the icons with a string]
583
#i+[0;20] Linewidth of the string, in pixels (0 to not use string) :
586
#C+ Colour of the string (red, blue, green, alpha) :
587
string color=0;0;0.59995422293430989;0.40000000000000002;
592
#F+[Indicator of the active window]
595
#Y+[Image;1;1;Frame;2;3] Type of indicator:
601
#C+ Colour of the frame :
602
#{Set transparency to 0 if you don't want to use an indicator.}
603
active color=0.70160982681010142;0.70160982681010142;0.70160982681010142;0.74999618524452583;
605
#i+[0;20] Linewidth of the frame around the active window :
606
#{Set 0 to fill the frame.}
609
#i+[0;30] Corner radius of the frame around the active window :
610
active corner radius=8
615
#b+ Draw indicator above the icon?
616
active frame position=true
619
#F+[Indicator of active launcher]
623
#{Indicators are drawn on launchers icons to show that they have already been launched. Leave blank to use the default one.}
624
indicator image=indicator.png
626
#b- Display an indicator on application icons too ?
627
#{The indicator is drawn on active launchers, but you may want to display it on applications too.}
633
#e+[-0.4;1.2] Vertical offset :
634
#{Relatively to the icons' size. You can use this parameter to adjust the indicator's vertical position.
635
#If the indicator is linked to the icon, the offset will be upwards, otherwise downwards.}
636
indicator offset=1.1469534050179211
638
#b+ Link the indicator with its icon?
639
#{If the indicator is linked to the icon, it will then be zoomed like the icon and the offset will be upwards.
640
#Otherwise it will be drawn directly on the dock and the offset will be downwards.}
641
indicator on icon=false
643
#e+[0.1;1.5;smaller;bigger] Indicator size ratio :
644
#{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.}
645
indicator ratio=1.0189999999999999
647
#b+ Rotate the indicator with dock?
648
#{Use it to make the indicator follow the orientation of the dock (top/bottom/right/left).}
649
rotate indicator=true
651
#b+ Draw indicator above the icon?
655
#F+[Indicator of grouped windows]
658
#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 :
662
#{It only makes sense if you chose to group the applis of the same class together. Leave blank to use the default one.}
663
class indicator=active.png
665
#b+ Zoom the indicator with its icon?
671
#F-[Label visibility;gtk-underline]
674
#Y+[No;0;0;On pointed icon;0;0;On all icons;1;1] Show labels:
677
#f-[0.;50.] label's visibility threshold :
678
#{the bigger, the more the labels next to the selected icon will be transparent.}
681
#b- Should the labels always be horizontal, even when dock is vertical?
682
always horizontal=true
684
#F+[Font;gtk-select-font]
687
#B+ Use a custom font for labels?
688
#{Otherwise the default's system one will be used.}
691
#P+ Font used for labels :
694
#b+ Draw the outline of the text?
697
#F+[Background;gtk-orientation-portrait]
700
#C+ Colour of the label's background :
701
#{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.}
702
text background color=0;0;0;1;
704
#i+[0;20] Margin around the text (in pixels) :
707
#F+[Colour;gtk-select-color]
711
#{It's the first color of the gradation.}
712
text color start=1;1;1;
715
#{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.}
716
text color stop=1;1;1;
718
#b+ Pattern should be vertical?
719
#{If checked, the pattern will go from top to bottom, otherwise from left to right.}
720
vertical label pattern=true
722
#F+[Quick-info;stock_dialog_info]
723
#{Quick-info are short information drawn on the icons.}
726
#B[-2] Use the same look as the labels?
732
#C+ Background color:
733
qi bg color=0;0;0;0.667;