cairo-dock.conf

#3.4.1
######## This is the conf file of Cairo-Dock, released under the GPL.##########
######## It is parsed by cairo-dock to automatically generate an appropriate GUI,##########
######## so don't mess into it, except if you know what you're doing ! ;-)##########

[Position]

#F-[Position on the screen;view-fullscreen]
frame_pos=

#l-[bottom;top;right;left] Choose which border of the screen the dock will be placed on:
screen border=0

#e-[0.;1.;left;right] Relative alignment:
#{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.}
alignment=0.5

#r- Multi-screens
num_screen=0

#X-[Offset from the screen's edge;view-restore]
frame_scr=

#I-[-1000;1000] Lateral offset:
#{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.}
x gap=0
#i-[-30;1000] Distance to the screen edge:
#{in pixels. You can also move the dock by holding the ALT or CTRL key and the left mouse button.}
y gap=0


[Accessibility]

#F-[Visibility of the main dock;edit-find]
frame_visi=

#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:
#{Modes are sorted from the most intrusive to the less intrusive.
#When the dock is hidden or below a window, place the mouse on the screen's border to call it back.
#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.}
visibility=4

#v
sep_visi=

#L-[None;Move down;Fade out;Semi transparent;Zoom out;Folding] Effect used to hide the dock:
hide effect=Fade out

#e-[0;1;high;low] Callback sensitivity:
#{The higher, the faster the dock will appear}
edge sensitivity=0

#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:
callback=0

#j-[2;999] Size of the zone :
zone size=1024;2;

#g- Image to display on the zone :
callback image=

#k- Keyboard shortcut to pop-up the dock:
#{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.}
raise shortcut=

max_authorized_width=0

#F-[Sub-docks' visibility;/usr/share/cairo-dock/icons/icon-subdock.png]
frame_sub=

#Y-[Appear on mouse over;1;1;Appear on click;0;0] Visibility:
#{they will appear either when you click or when you linger over the icon pointing on it.}
show_on_click=1

#i- Delay before displaying a sub-dock:
#{in ms.}
show delay=300

#i- Delay before leaving a sub-dock takes effect:
#{in ms.}
leaving delay=250

lock icons=true
lock all=false


[TaskBar]

#F-[Behaviour;document-properties]
frame1=

#B-[8] Show currently opened applications in the dock?
#{Cairo-Dock will then act as your taskbar. It is recommended to remove any other taskbars.}
show applications=true

#B- Mix launchers and applications
#{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.}
mix launcher appli=true

#b- Only show applications on current desktop
current desktop only=false

#b- Only show icons whose windows are minimised
hide visible=false

#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
place icons=2

#N Place new icons after this one
relative icon=

#b Automatically add a separator
separate applis=true

#B- Group windows from the same application in a sub-dock ?
#{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.}
group by class=true

#s- 		Except the following classes:
#{Enter the class of the applications, separated by a semi-colon ';'}
group exception=


#F-[Representation;edit-find]
frame3=

#B- Overwrite the X icon with the launchers' icon?
#{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.}
overwrite xicon=true

#s- 		Except the following classes:
#{Enter the class of the applications, separated by a semi-colon ';'}
overwrite exception=

#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 ?
#{A composite manager is required to display the thumbnail.
#OpenGL is required to draw the icon bent backwards.}
minimized=1

#e-[0;.6;Opaque;Transparent] Transparency of icons whose window is minimised:
visibility alpha=0.35

#a- Play a short animation of the icon when its window becomes active
animation on active window=wobbly

#i- Maximum number of caracters in application name:
#{"..." will be added at the end if the name is too long.}
max name length=20

#F-[Interaction;view-refresh]
frame2=

#l-[Nothing;Close;Minimize;Launch new;Lower] Action on middle-click on the related application
action on middle click=1

#b- Minimise the window when its icon is clicked, if it was already the active window ?
#{This is the default behaviour of most taskbars.}
minimize on click=true

#b- Present windows preview on click when several windows are grouped togather
#{Only if your Window Manager supports it.}
present class on click=true

#v-
sep_att=

#B-[2] Highlight applications requiring your attention with a dialog bubble
demands attention with dialog=true

#i-[1;20] Duration of the dialog:
#{in seconds}
duration=2

#s- Force the following applications to demand your attention
#{It will notify you even if, for instance, you are watching a movie in full screen or you are on another desktop.
#}
force demands attention=pidgin;xchat

#a- Highlight applications demanding your attention with an animation
animation on demands attention=rotate


[System]

#X-[Animations speed;/usr/share/cairo-dock/icons/icon-movment.png]
frame_mov=

#B- Animate sub-docks when they appear
animate subdocks=true

#I-[100;600;fast;slow] Animation unfolding duration:
#{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.}
unfold duration=300

#v
sep_unfold=

#I-[4;40;fast;slow] Number of steps in the zoom animation (grow/shrink):
#{The more there are, the slower it will be}
grow nb steps=10
#I-[4;40;fast;slow] ...
shrink nb steps=8

#v
sep_unhide=

#I-[4;40;fast;slow] Number of steps in the auto-hide animation (move up/move down):
#{The more there are, the slower it will be}
move up nb steps=10
#I-[4;40;fast;slow] ...
move down nb steps=16

#X-[Refresh rate;system-run]
frame_cpu=

#i-[5;40] Refresh rate when mouving cursor into the dock:
#{in Hz. This is to adjust behaviour relative to your CPU power.}
refresh frequency=35

#i-&[15;60] Animation frequency for the OpenGL backend:
#{in Hz. This is to adjust behaviour relative to your CPU power.}
opengl anim freq=33

#i-*[15;50] Animation frequency for the Cairo backend:
#{in Hz. This is to adjust behaviour relative to your CPU power.}
cairo anim freq=25

#b-* Reflections should be calculated in real-time?
#{The transparency gradation pattern will then be re-calculated in real time. May need more CPU power.}
dynamic reflection=false

#X-[Connection to the Internet;network-wired]
frame_conn=

#i-[1;20] Connection timeout :
#{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.}
conn timeout=7

#i-[10;300] Maximum time to download a file:
#{Maximum time in seconds that you allow the whole operation to last. Some themes can be up to a few MB.}
conn max time=120

#b- Force IPv4 ?
#{Use this option if you experience problems to connect.}
force ipv4=true

#B-[4] Are you behind a proxy ?
#{Use this option if you connect to the Internet through a proxy.}
conn use proxy=false

#s- Proxy name :
conn proxy=

#i- Port :
conn port=0

#s- User :
#{Let empty if you don't need to log-in to the proxy with a user/password.}
conn user=

#p- Password :
#{Let empty if you don't need to log-in to the proxy with a user/password.}
conn passwd=

modules=Animated icons;illusion;PowerManager;wifi;icon effects;clock;System Monitor;shortcuts;GMenu;Xgamma;Remote-Control


[Background]

#Y+[Automatic;0;0;Image;1;4,2;Colour gradation;2;3] Style
style=1


#F+[Image;image-x-generic]
#{Use a background image.}
frame2=

#g+ Image file:
background image=bg-rainbow.svg

#e+[0;1;Transparent;Opaque] Image's transparency :
image alpha=1

#b+ Repeat image as a pattern to fill background?
repeat image=false


#F+[Colour gradation;/usr/share/cairo-dock/icons/icon-gradation.png]
#{Use a colour gradation.}
frame3=

#C+ Bright colour:
stripes color bright=0.79157701991302354;0.88300907911802851;0.91279468986037993;0.80000000000000004;

#C+ Dark colour:
stripes color dark=0.61979095140001528;0.72788586251621268;0.82012664988174255;0.56461432822156099;

#f+[-90;90] Angle of the gradation :
#{In degrees, in relation to the vertical}
stripes angle=36

#i+ Repeat the gradation this number of times:
#{If not nul, it will form stripes.}
number of stripes=55

#f+[0;1] Percentage of the bright colour:
stripes width=0.49999999999999961


#F+[Background when hidden;image-x-generic]
frame4=

#C+ Default background color when the dock is hidden
#{Several applets can be visible even when the dock is hidden}
hidden bg color=0.80000000000000004;0.80000000000000004;0.80000000000000004;0.5;


#F+[External Frame;/usr/share/cairo-dock/icons/icon-frame.png]
frame_frame=
#i+[0;30] Corner radius
#{in pixels.}
corner radius=8

#i+[0;20] Outline width
#{in pixels.}
line width=1

#C+ Outline colour
line color=1;1;1;0.8666666666666667;


#F
frame4_=

#i+[0;20] Margin between the frame and the icons or their reflects :
#{in pixels.}
frame margin=4

#b+ Are the bottom left and right corners rounded?
rounded bottom corner=false

#b+ Stretch the dock to always fill the screen
extended=false


[Views]

#F+[Main Dock]
frame_main=

#n+ Choose the default view for main docks :/
main dock view=Default

#F+[Sub-Docks]
frame_sub=

#n+ Choose the default view for sub-docks :
#{You can overwrite this parameter for each sub-dock.}/
sub-dock view=Default

#e+[0.5;1.5;smaller;larger] Ratio for the size of the sub-docks' icons :
#{You can specify a ratio for the size of the sub-docks' icons, in relation to the main docks' icons size}
relative icon size=0.80000000000000004


[Dialogs]

#F+[Bubble;/usr/share/cairo-dock/icons/icon-bubble.png]
frame_bubble=

#Y-[Automatic;0;0;Custom;1;5] Style
style=0

#C+ Background colour
bg color=1;1;1;0.80000000000000004;

#C+ Outline colour
line color=0.73987945372701613;0.74772259098191807;0.84420538643472953;0.8666666666666667;

#c+ Text colour
text color=0.0;0.0;0.0;

#i+[0;20] Corner radius
corner=8

#i+[1;10] Outline width
linewidth=1

#v
sep_bul=

#t+ Shape of the bubble:
decorator=tooltip


#F+[Font;preferences-desktop-font]
frame_text=

#B+ Use a custom font for the text?
#{Otherwise the default's system one will be used.}
custom=false

#P+ Text font:
message police=Sans Medium 14

#F+[Buttons;/usr/share/cairo-dock/icons/icon-buttons.png]
frame_button=

#j+[10;64] Size of buttons in the info-bubbles (width x height) :
#{in pixels.}
button size=32;32;

#g+[Default] Name of an image to use for the yes/ok button :
button_ok image=cairo-dock-ok.svg

#g+[Default] Name of an image to use for the no/cancel button :
button_cancel image=cairo-dock-cancel.svg

#F+
fin_button=

#i+[16;96] Size of the icon displayed next to the text :
icon size=48


[Desklets]

#F+[Decorations;edit-paste]
frame_deco=

#O+ Choose a default decoration for all desklets :
#{This can be customized for each desklet separately.
#Choose 'Custom decoration' to define your own decorations below}
decorations=dark

#v
sep_deco=

#g+ Background image :
#{It's an image that will be displayed below the drawings, like a frame for example. Leave empty to not use any.}
bg desklet=
#e+[0;1;Transparent;Opaque] Background transparency :
bg alpha=1
#i+[0;256] Left offset :
#{in pixels. Use this to adjust the left position of the drawings.}
left offset=0
#i+[0;256] Top offset :
#{in pixels. Use this to adjust the top position of the drawings.}
top offset=0
#i+[0;256] Right offset :
#{in pixels. Use this to adjust the right position of the drawings.}
right offset=0
#i+[0;256] Bottom offset :
#{in pixels. Use this to adjust the bottom position of the drawings.}
bottom offset=0
#g+ Foreground image :
#{It's an image that will be displayed above the drawings, like a reflection for example. Leave empty to not use any.}
fg desklet=
#e+[0;1;Transparent;Opaque] Foreground tansparency :
fg alpha=1

#F+[Buttons;window-close]
frame_button=

#i+[4;28] Buttons size :
button size=16

#g+[Default] Name of an image to use for the 'rotate' button :
rotate image=

#g+[Default] Name of an image to use for the 'reattach' button :
retach image=

#g+[Default] Name of an image to use for the 'depth rotate' button :
depth rotate image=

#g+[Default] Name of an image to use for the 'rotate' button :
no input image=


[Icons]

#F+[Icons' themes;preferences-desktop-theme]
frame_theme=

#w+ Choose an icon theme :
default icon directory=_Custom Icons_

#g+[No background] Image filename to use as a background for icons :
icons bg=

#F+[Icons size;zoom-fit-best]
frame_size=

#j+[10;128] Icons' size at rest (width x height) :
launcher size=56;56;

#i+[0;50] Space between icons :
#{in pixels.}
icon gap=2

#F+[Zoom effect;/usr/share/cairo-dock/icons/icon-wave.png]
frame_shape=
#f+[1;5] Maximum zoom of the icons :
#{set to 1 if you don't want the icons to zoom when you hover over them.}
zoom max=1.5

#i+[1;999] Width of the space in which the zoom will be effective :
#{in pixels. Outside of this space (centered on the mouse), there is no zoom.}
sinusoid width=220

#F+[Separators]
frame_sep=

#j+[4;128] Icons' size at rest (width x height) :
separator size=24;56;

#b+ Force separator's image size to stay constant?
force size=true

#Y+[Use an image.;1;2;Flat separator;3;1;Physical separator;0;0] How to draw the separators?
#{Only the default, 3D-plane and curve views support flat and physical separators. Flat separators are rendered differently according to the view.}
separator type=0

#g+[Blank] Image file:
separator image=separateur.svg

#b+ Make the separator's image revolve when dock is on top/on the left/on the right?
revolve separator image=true

#Y-[Automatic;0;0;Custom;1;1] Style
separator_style=1

#C+ Colour of flat separators :
separator color=0.89999237048905167;0.89999237048905167;0.89999237048905167;1;

#X+[Reflections]
frame_refl=

#e+[0;1;light;strong] Reflection visibility
albedo=0.435

#e+[0;1;small;tall] Height of the reflection:
#{In percent of the icon's size. This parameter influence the total height of the dock.}
field depth=0.59999999999999998

#e+[0;1;Transparent;Opaque] Icons' transparency at rest :
#{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.}
alpha at rest=1

#X+[Link the icons with a string]
frame_string=

#i+[0;20] Linewidth of the string, in pixels (0 to not use string) :
string width=0

#C+ Colour of the string (red, blue, green, alpha) :
string color=0;0;0.59983215075913632;0.40000000000000002;


[Indicators]

#X+[Indicator of the active window]
frame_window=

#Y+[Automatic;2;1;Image;1;1;Frame;2;4] Style
active style=2

#g+ Image file:
active indicator=

#l+[Fill background;Frame] Frame
active frame=1

#C+ Colour
active color=1;1;1;0.75000000000000011;

#i+[1;20] Linewidth
active line width=3

#i+[0;30] Corner radius
active corner radius=8

#v
sep_active=

#b+ Draw indicator above the icon?
active frame position=true


#X+[Indicator of active launcher]
frame_launch=

#g+ Image file:
#{Indicators are drawn on launchers icons to show that they have already been launched. Leave blank to use the default one.}
indicator image=

#b- Display an indicator on application icons too ?
#{The indicator is drawn on active launchers, but you may want to display it on applications too.}
indic on appli=false

#v
sep_ind=

#e+[-0.4;1.2] Vertical offset :
#{Relatively to the icons' size. You can use this parameter to adjust the indicator's vertical position.
#If the indicator is linked to the icon, the offset will be upwards, otherwise downwards.}
indicator offset=0.034722222222222224

#b+ Link the indicator with its icon?
#{If the indicator is linked to the icon, it will then be zoomed like the icon and the offset will be upwards.
#Otherwise it will be drawn directly on the dock and the offset will be downwards.}
indicator on icon=true

#e+[0.1;1.5;smaller;bigger] Indicator size ratio :
#{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.}
indicator ratio=1.1399999999999999

#b+ Rotate the indicator with dock?
#{Use it to make the indicator follow the orientation of the dock (top/bottom/right/left).}
rotate indicator=true

#b+ Draw indicator above the icon?
indicator above=true


#X+[Indicator of grouped windows]
frame_class=

#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 :
use class indic=0

#g+ Image file:
#{It only makes sense if you chose to group the applis of the same class together. Leave blank to use the default one.}
class indicator=

#b+ Zoom the indicator with its icon?
zoom class=true


#X+[Progress bars]
frame_bar=

#Y-[Automatic;0;0;Custom;1;3] Style
bar_colors=1

#C+ Start color
bar_color_start=0.53000000000000003;0.53000000000000003;0.53000000000000003;0.84999999999999998;

#C+ End color
bar_color_stop=0.87;0.87;0.87;0.84999999999999998;

#C+ Outline colour
bar_color_outline=1;1;1;0.84999999999999998;

#i-[2;10] Bar thickness
bar_thickness=4


[Labels]

#F-[Label visibility;format-text-underline]
frame_label=

#Y+[No;0;0;On pointed icon;0;0;On all icons;1;1] Show labels:
show_labels=1

#e-[0;50;more visible;less visible] Neighbouring labels visibility:
alpha threshold=16.25

#F+[Appearance;image-x-generic]
frame_bg=

#Y-[Automatic;0;0;Custom;1;4] Style
style=0

#C+ Background colour
text bg color=0;0;0;.85

#C+ Outline colour
text line color=1.0; 1.0; 1.0; 1.0

#c+ Text colour
text color=1;1;1

#b+ Draw the outline of the text?
text oulined=true

#i+[0;20] Margin around the text (in pixels) :
text margin=8

#F+[Font;preferences-desktop-font]
frame_font=

#B+ Use a custom font for the text?
#{Otherwise the default's system one will be used.}
custom=false

#P+ Text font:
police=OpenSymbol Heavy 16

#F+[Quick-info;stock_dialog-info]
#{Quick-info are short information drawn on the icons.}
frame_qi=

#B[-2] Use the same look as the labels?
qi same=true

#c+ Text colour
qi text color=1;1;1

#C+ Background colour
qi bg color=0;0;0;0.8


[Style]

#F+[Appearance;image-x-generic]
frame_bg=

#Y-[System;0;0;Custom;1;3] Style
colors=1

#C+ Background colour
bg color=1;1;1;0.80000000000000004;

#C+ Outline colour
line color=0.73987945372701613;0.74772259098191807;0.84420538643472953;0.8666666666666667;

#c+ Text colour:
text color=0.0;0.0;0.0;1;

#v
sep_shape=

#i+[0;20] Corner radius
corner=0

#i+[1;10] Outline width
linewidth=1

#F+[Font;preferences-desktop-font]
frame_text=

#B+ Use a custom font for the text?
custom font=false

#P+ Text font:
font=