Home Forums Wiki Doc Install Extras Screenshots Source Code Projects Blog Users Groups Register
Glx-Dock / Cairo-Dock Wiki Tutoriel de personnalisation
The latest stable release is the *3.4.0* : How to install it here.
Note: We just switched from BZR to Git on Github! (only to host the code and your future pull requests)
Information : The version displayed on this page is not the latest available.
History View code

Glx-Dock / Cairo-Dock




de Deutsch

en English

ru Russian

fr Français

Support Us

Flattr this


Tutoriel de personnalisation

La Traduction est en cours alors soyez patient et aidez moi au besoin

Le but de ce tutoriel
Cairo-Dock utilise des themes et vous pouvez completement changer la maniere dont il se comporte ainsi que son apparence pour en faire un dock unique. Cela n'a pas que des avantages : il y a *beaucoup* d'options
Ce tutoriel n'a pas l'ambition de decrire toutes les options (elles sont deja decrites dans la configuration avec des tooltips pour la plupart), mais il vous guidera pour personnaliser votre dock.
Il contient aussi quelques astuces bien utiles.

1er pas
Ce tutoriel est base sur les versions 2.1.x ou plus de Cairo-Dock. Si votre version est plus ancienne, il est fortement recommande de la mettre a jour pour profiter des dernières améliorations.
Pour obtenir la derniere version utiliser notre depot or recuperer le paquet sur Launchpad ou bien encore intaller a partir des sources.
Tout est explique en detail sur le wiki (http://wiki.glx-dock.org).
N'oubliez pas d'installer les plug-ins.

1er Lancement
La premiere fois que vous lancer Cairo-Dock un theme par defaut est selectionne. C'est un theme parmi bien d'autres qui a ete choisi en parti par un vote mais aussi parceque je l'aime bien donc sans doute qu'il ne correspondra pas a vos gouts.
Avant de demarrer la personalisation de votre dock, vous devriez essayer les autres themes disponibles a travers le gestionnaire de themes : click-droit -> Cairo-Dock -> Gestionnaire de theme.
Ordonnez par leur notem ou bien leur simplicite selon votre gout, selectionnez les 2 petites boites en bas de la page, choississez un theme et appliquez. Simple non?

Nous allons choisir le theme Clear" de Coz comme point de depart.


Le theme Clear de Coz pour Cairo-Dock

Switching and saving themes
A good habit is to save your current theme after you made some changes to it.
To save the current theme, open the Theme Manager, and go to the 2nd tab. There choose a name for your theme, and apply.

If you want to apply another theme on your dock, go to the 1st tab, choose a theme, and validate.
You can choose to apply the theme's behaviour and/or the theme's launchers, but you probably want to keep yours, so let the 2 boxes unthicked.

If you want to delete some themes you don't want anymore, go to the 3rd tab, and thick the unwanted themes, then validate, that will delete them.

A quick overview
To open the configuration panel, <right-click> on Cairo-Dock, go to the Cairo-Dock sub-menu, and choose Configure.
Several categories are proposed in the left margin. The one that concerns us is the 2nd one (named "Appearance").
But first, we’ll quickly go through the 1st category, that defines how your dock behaves.

Select the "Behavior" category; 4 modules are present :
  • The first one, Position, can be used to modify where the dock is placed on your screen (and on which screen for people using multi-screen with Xinerama).
  • The 2nd one, Accessibility, defines how you access your docks : whether your dock auto-hides itself, stays below other windows or on the opposite reserve space for itself, whether sub-docks popup on click or on mouse-over, etc.
  • The 3rd one, Taskbar, is quite interesting. Here you can toggle on/off the display of the current applications inside the dock. If you choose to activate it, several options are at your disposal, and allow the Taskbar to act either like MacOSX, Windows7, or a normal Gnome/KDE panel. One handy option is to close aplication on middle-click.
  • The last one, System, regroups all the options that you will probably never want to tweak.

Now select the "Appearance" category; a dizain of modules are present; they define the look of your dock.
  • The Background module lets you customize everything about the background of the docks : frame, background image, etc.
  • The Icons module is about the displaying of icons : icon theme, size, order, etc.
  • The Labels module lets you customize the way text is rendered above and on icons.
  • The Views module lets you change the way the dock and sub-docks are drawn : on a 3D plane, on a curve, on a parabole, etc.
  • The Dialogs module defines the appearance of the bubbles Cairo-Dock uses to notify you.
  • The Desklets module defines how applets are rendered when they are detached from the dock, and live on your desktop.
  • The Indicators module lets you personnalize all the indicators. These are graphics that are displayed to show something, like the where you can drop something inside the dock, which is the current active window, which launchers are launched, etc
  • The others are plug-ins that provide animations and special effects on your icons.

The Background
Enough talking, let's go !
First we'll setup the Background options.

  • You can choose to display an image in the background, or to fill it with a gradation of 2 colors.
In the case of an image, you can choose to fill the background by repeating or by stretching it.
  • If you're using the auto-hide, you can also set up an image to be displayed when the dock is hidden. When hidden, the dock displays a "callback zone", where you place your cursor to let the dock show up. Usually you will set up a wide and not high rectangular zone, so choose your image accordingly, as it will be stretched to fill it.
  • To complete this, we can configure the outline of the dock : roudness of the corners, thickness and color of the line, etc.


The previous Clear theme, with a different background color.

The Icons
Now, we will take care of the icons themselves.
  • At this point, it is nice to decide of a global icon look. You can find a lot of icon themes at gnome-look.org or other such sites. The dock lets you choose whether to use an icon theme for your icons, or whether to use your owns icons (they are located in ~/.cairo-dock/current_theme/icons; when you load a theme from the Theme Manager, this is where the theme places its custom icons). If you want to choose an icon theme, untick the option that says to use the local icons, and enter the name of an icon theme in the corresponding field (for instance, Human, Gartoon, Crystal, etc). If you just want to use the current icon theme, just let it blank.
An easy way to quickly alter the global look of your icons is also to add a background to each of them. It's done easily by filling the corresponding field with the path of an image.

Now let's take care of how the icons are rendered.
  • First we have the famous zoom effect; what you probably want to set up is the maximum zoom of the icons : 1.2 will give a light effect, when 2.0 will give a strong effect.
  • Then we have the reflection of the icons (for views that use it, like the 3D-plane or Curve views). If you want to reduce the height of your dock, a good way is to reduce the reflect height. Usually a medium value looks good.
  • You can also set up the size of icons by category. Here again, you can reduce the size of your dock with small icons. 48x48 is a common value.
  • Last, we can set up the order of icons by type, if you want for exemple to place applets on the left and applications on the right.
  • A little bonus feature is to draw a string that links all the icons. Just set its width to 0 if you don't want it.


Setting "Gartoon" as the icon theme changes all the icons at once, giving your dock a completely different feeling.

Note :
You can always change the icon for a single launcher, by right-click -> modify this launcher, and setting a complete path to an image. Same goes for applets.

Note 2 :
To change the icon for a running application, you first have to activate "Overwrite X icons with launchers" in the Taskbar module. Doing this will tell Cairo-Dock to ignore the somewhat crappy icons provided by X, and to search for a better icon. Now, let's say we have Nautilus running, and its corresponding icon in the dock. There is 2 cases :
      • There is a "Nautilus" launcher in the dock, then Cairo-Dock will just use the same icon for the application, and we're done.
      • There is no such launcher, then Cairo-Dock will search for an image named "nautilus.xxx", where "xxx" can be "svg", "png", "xpm", etc. There is a great chance that such an icon will be found in the icon theme we set up previously. If you want to use your own image, just place an image with this name in the local icons folder (~/.cairo-dock/current_theme/icons).
How to name the image ?
Each icon must have the same name as the *class* for the relevant application. The class of an application is most of the time equal to its name, but not always.
To find the class for an application, make sure it’s open, and then go to a terminal and type
xprop | grep WM_CLASS

This will bring up a little pointer, which you use to click on the relevant window. You'll get something like this in the terminal :
WM_CLASS(STRING) = "nautilus", "Nautilus"

To get Cairo-Dock to show the correct icon, your custom icons must be given the same name as the application class, so for example ‘nautilus.svg’ or ‘nautilus.png’.

Changing the way docks are rendered
Each dock can be rendered differently from the others. Changing the rendering of a dock will make it appear in a totally different way.
In the "Views" module, you can set the default rendering for docks and sub-docks.
For each sub-dock, you can modify its view (<right click>-> "modify this launcher", same goes for applets).


Switching to another view really changes the rendering of your dock. Here, the "Curve" view.

The icons' labels
The "Labels" module lets you configure the labels and quick-infos (Quick-infos are some small texts displayed on the icons to give short information, like the number of files in the Dustbin).
You can set up the font, size, color (a gradation), etc.
To make the text more readable, you may want to draw a background behind them. You can choose the color, transparency, and size of the text background.

The dialog bubbles
The dock interacts with you through dialog bubbles, that can display some message, warning, information, or even ask you question or any value. In the <b>Dialogs</b> module, you can configure their look : color and style of the bubble, font and size of the text, "ok" and "cancel" buttons, etc.
Several styles are available; they change the shape of the bubbles. For instance the "comics" one will make the bubbles look like carton bubbles, whereas the "tooltip" one will give a more classic shape.

The Desklets
Each applet can be detached from the dock and placed on your desktop. This module lets you choose a default decoration for all desklets. Each desklet can also be configured with its own decoration.
You can choose one of the available theme, or define your own (it's just a background and foreground image, with an horizontal and vertical adjustment).

The little plus that will distinguish your theme from the others
To make a really personnal and original theme, you should personnalize the <b>indicators</b>.
Indicators are small extra drawings that indicates the state of icons/dock. There are indicators for the drag-and-drop, drag-over, active window, and launched launchers.
  • The drag-and-drop indicator* is displayed when you drag something over the dock (like a launcher from the Main Menu). It can be some image oriented from top to bottom, like an arrow, some rain, a starfall, etc
  • The drag-over indicator is a little emblem displayed on the icon when you drag something on it. It is drawn at 1/3 of the icon's size.
  • The active window indicator is drawn on the icon of the currently active window. you can set an image or just a back/foreground color. You should try to make it discret since it is drawn at the same place and size as the icon.
  • The launched launcher indicator shows you which indicators have been already launched, if you're using the Taskbar option "mix applications and launchers". It is displayed at the bottom of the icon, and you can adjust its position vertically. It can be a circle, a light, etc. Try to choose something that fits the icon theme and icons shape.

Animations and effects
To finish, and if you're running the OpenGL backend, you can easily add some fun to your dock.
The "Animated icons" and "Icon effects" modules will let you define one or more animations/effects when an icon is clicked or hovered by the pointer.
If the effects seems "too much" for you, you can customize each of them, and also choose to draw them behind the icon, to reduce the impact.
The "Illusion" module will let you choose an animation when the icon appear and disappear.

Last step
You're almost done ! You can now decide which applet you need, and where you'll place them (in the main dock to keep an eye on them easily, in a sud-dock or on the desktop if it's not needed). You can set up an icon for each of them, or even choose a theme for some of them (Clock, Dustbin, PowerManager, etc).
To go further, you can also try to make your own gauge theme. A gauge is made of some images and an XML file that describes the gauge. See exemples in /usr/share/cairo-dock/gauges.
When you make a personnal theme for an applet (a gauge, a clock, a dustbin, etc), put everything all the files in a folder named with the name you want for your theme, and place this folder into ~/.config/cairo-dock/extras/gauge if it's a gauge, or ~/.config/cairo-dock/extras/clock if it's a clock, etc.

Having many docks in a single instance of Cairo-Dock

Choose a launcher or an applet, and open its configuration panel (<right click> -> "modify this launcher/applet").
For a launcher, expand the "Extra Parameters", for an applet, go to the first Tab.
There you can set the name of the dock it belongs to. Just set a name that doesn't exist yet, for exemple "dock2"; a new dock will be created with this name, and the icon placed inside it. You can then populate it with other icons in the same way.
At first this dock will be placed at the bottom middle of the screen; to change it, <right click> on it -> "Cairo-dock" -> "set up this dock".
Each of these docks will share the same configuration though, and thus the same look.

There is a way to have many docks with different look, but it requires to launch Cairo-dock many times. Launch cairo-dock normally, and then launch
cairo-dock --modules-dir /path/to/dir
where /path/to/dir will act like the "~/.config/cairo-dock" folder.

How to configure Cairo-Dock so that it is as light as possible ?

Eye-candy is nice, but it has a cost. If you feel your dock is using to much CPU, here are some tricks that can help you.
  • The best way to have a smooth dock is to run it with the hardware acceleration (OpenGL). You need a nVidia card, or an Intel with the latest X.org server, and run the dock with the command
    cairo-dock -o
    (If you have an ATI, this will probably not work correctly => (see our wiki))
  • You can also configure the dock to be lighter.
Try to descrease the icon size. 48x48 is a good size, and the maximum zoom can be decreased to 1.2 or even less. Also reduce the amount of reflection.
Try to reduce the number of icons into your dock :
  • make some sub-docks to group launchers and/or applets by affinity.
  • use the TaskBar options to group applications by class, mix applications and launcher, or to display applications of the current desktop only.
  • use many root docks, each on a different screen border (see the precedent chapter).

In the "System" module, use the option to only show the labels on the pointed icon.
Also you may try to decrease the refresh frequency (don't go under 20Hz, it might have the opposite effect).
You can also decrease the refresh frequency of some applets. For instance, no displaying the seconds in Clock will make it refresh only once a minute instead of once a second, the amount of RAM can be checked only eash 10s in System-Monitor, etc.
Try to remove some applets, like Cairo-Penguin or Toons.
Try to use the "default" view instead of "3D-plane" or "Curve".


I guess your dock now looks totaly different from what it was at the beginning
I hope this little guide has helped you to not get lost during the configuration. If you have any comment/suggestion, feel free to write me at fabounet (at) users [dot] berlios -dot- de, or pay us a visit at http://glx-dock.org !

Fabounet and Lusule.

Glx-Dock / Cairo-Dock Wiki Tutoriel de personnalisation Top

Online users :

Powered by ElementSpeak © 2007 Adrien Pilleboue, 2009-2013 Matthieu Baerts.
Dock based on CSS Dock Menu (Ndesign) with jQuery. Icons by zgegball
Cairo-Dock is a free software under GNU-GPL3 licence. First stable version created by Fabounet.
Many thanks to TuxFamily for the web Hosting and Mav for the domain name.