Home Forums Wiki Doc Install Extras Screenshots Source Code Projects Blog Users Groups Register
Glx-Dock / Cairo-Dock Wiki Tip and Tricks
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




en English

de Deutsch

ru Russian

Support Us

Flattr this


Tip and Tricks

Move the dock
either :

- After making the dock active (click on it for example) use the arrows to move the dock. The movement will accelerate if you keep pressing for ease of use

- Press ALT then click on the dock then drag it where you want. With Beryl you can activate sticky edges which allows an better positioning. Release the mouse button and then release the ALT key.

Get icons themes easily swappable for the dock
If you either downloaded a icon theme or collect some icons in a directory : Right click on the dock then choose Configure and select the Launcher tab. Add in the directory list the directory where your icons are. Add as many as you want like that . Now to go from one theme to another easily just put the correct directory at the top of the list (use up and down arrow). Cairo-Dock will automatically load the new icons when you close the configuration panel.

Note : when an icon doesn't have an extension Cairo-Dock will first look for an .SVG in all the directory. So if you have matching .PNG in the top directory and another matching .SVG in the next directory then this one will be loaded. Keep this in mind when you build your theme and try to keep them homogeneous.

Change the style of the stripes
Here are a few concrete example:

- If I want thin and well spaced stripe: put their number to 8 (8 stripes per motif) and their width to 0.02 (2% of the width of a motif).

- If now I want thicker stripes: increase their width to may be 1/8, or 0.125 (12%), this will have the effect to spread them .

- If I prefer very dense (numerous) stripes: increase their number, to 30(30 stripes per motif). As there is a lot of stripes per motif they can't be very large or they will overflow each other, their maximum width should be 1/30 roughly 0.03 (3%).

Make sure all your icons have the same size
Cairo-Dock can deal with icons of any size. But for practical reason it would be nice to make sure that all icons appear to have the same size.. But you are too lazy to resize them yourself ! The solution is to set both values for the icons size equal in the tabs for the launchers, the applications, the applets and the separator. Cairo-Dock will then resize all the icons to that size. One little nice trick : set the size to 24 in all fields and 150 in the field for the width of the wave (see CAIRO-DOCK tab). You end up with a baby version of Cairo-Dock, Cute no?

Choose a ready made theme
If the directory ~/.cairo-dock doesn't exist at launch, Cairo-Dock will offer to choose a theme to choose among the predefined one.. Later if you change your mind and wish to change the theme : Right click "cairo-dock" and choose "Manage Theme".

Cairo-dock if needed will warn you that you need to save your actual theme first if it has been changed. You can either save it on another name or overwrite the existing one, except for pre-installed themes.

Add containers
Container are launchers with a special attribute : They are like drawers, so you can group similar applications (launchers) which will only appear when you go over the container. You can create a container inside a container and create a tree structure.

You create a container the same way you create a launcher for an application. You just have to tick the last box to indicate that it is a Container rather than an application. A new sub dock will be created and associated with that container. Initially you can't see it as it is empty so you have to create launcher to put in it as explained before. You can also of course just drag and drop applications on the Container

To move a launcher from one container to another one easy way is to edit the Launcher (Right Click the icon and choose "Modify Launcher") and change the name of the container in the Container field to point towards the new container (the main dock is called "_MainDock_").

Add/Remove visual effect with Compiz-Fusion
Compiz-Fusion set visual effect by default to the predefined windows types. You can also apply specific effect to the opening and closing of the dock and subdocks.
  • Open CCSM (Compiz Config System Manager) and go the to option of the Animation plugin; in the "Open Animation" tab. Here we are going to create a new variable which will allow us to affect a specific effect when you open a window (Compiz-Fusion considers a sub-dock like a window)
  • Click "Add" an choose your effect in the list from "Open effect".
  • Add "name=cairo-dock" in the field "xxx" (don't know the exact name in english )
  • Get this value to show at the top of the list. Now Compiz-Fusion will apply that specific effect only to the windows called "cairo-dock". So all sub-dock opening will use that effect. Create the same effect in the "Close Animation" tab and while you are at it go to "Focus Animation" and create a variable there as well, but here select no effect. Name it cairo-dock again. This will make sure that no effect is triggered when you fly over the dock (focus). This can create an ugly flash if not

Recommended value
  • Open Animation: Zoom effect with a duration of 250 Close Animation: Vaccuum effect with a duration of 250

Compiz Widget Layer

Some of the cairo-dock applets can be detached from the dock. You can configure them to be displayed on the compiz widget layer, instead of the regular desktop. The compiz widget layer can be toggled by pressing F9 (default compiz settings). Hereafter we describe how to create an icon on your cairo-dock to toggle the widget layer, as it is done on MacOSX with the dashboard icon (for those who know it).

1. First, enable 'Dbus' plugin in CompizConfig Settings Manager.

2. Then create a new file and paste the following code to it, and then save as e.g. widget.sh

dbus-send --type=method_call --dest=org.freedesktop.compiz /org/freedesktop/compiz/widget/allscreens/toggle_key org.freedesktop.compiz.activate string:'root' int32:`xwininfo -root | grep id: | awk '{ print $4 }'`

3. We need to make the script executable: right-click on the file. Go to Properties -> Permissions , check 'Execute' option.

The new launcher in cairo-dock needs to be created from scratch, as described below, otherwise it might not work. It is a known cairo-dock bug that will be fixed soon

4. To create a new empty launcher, right-click on cairo-dock -> add new launcher, and select new and fill in the parameters as described below:
Name: Widget (for instance)
Command: sh /path_to_script/widget.sh
Image: choose the image you want to be displayed in cairo-dock

Glx-Dock / Cairo-Dock Wiki Tip and Tricks 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.