Home Forums Wiki Doc Install Extras Screenshots Source Code Projects Blog Users Groups Register
Glx-Dock / Cairo-Dock Wiki F.A.Q
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

Home

History

Language

en English

de Deutsch

fr Français

ru Russian

Support Us

Flattr this

Cairo-Dockon

F.A.Q

Good to know
Cairo-Dock is developed on Ubuntu. So of course some wiki pages are slanted toward Ubuntu, and may be update arrive faster if you are also using Ubuntu.

But fear not! Cairo-Dock is being adopted by people who use other distros such as OpenSUSE, Arch Linux, Toutou/Puppy Linux, etc each with its own way of pushing the dock to you.
If your distro has some repository, please be patient as the maintainer needs some time to update them so delays are to be expected.

I just installed Cairo-Dock, How do I launch it?
From a terminal type
cairo-dock &
disown

This way you can see debug information (at least until you close the terminal).

Without a terminal
Type ALT+F2, then enter "cairo-dock" and finally validate.

To launch it at every startup
Add an entry in the session manager to launch cairo-dock
  • For Gnome : System / Preference / Sessions / Startup Programs select Add.
In Command, enter cairo-dock
You can also use the script launch-cairo-dock-after-beryl.sh if needed (see below).

I just choose a theme and I can't find the dock !
Most likely this theme is using the auto-hide function. Move your mouse to one of the edge of your desktop and it shoudl appear.

It can also be that the dock is hidden by the application of your Window Manager. Try to move it somewhere and you should see the dock again .

I have an ugly black border all around the dock !
This means that your window manager doesn't need support transparency (composite). If you can't/don't want to install a window manager that supports it such as Compiz or Beryl, here are other solutions :

  • If you are using XFCE, the easiest way is to activate the composite manager

  • If you are using KDE, the latest version of KDE support transparency. If it is not yet activated:
Launch kconfig => section Desktop => Windows Behaviour => Transparency).

  • If you are using Metacity, you will have to install xcompmgr (a module to add composite to Metacity). Use your favorite method to install (aptitude, apt-get, rpm...). YOou can have xcompmgr and Compiz or Beryl installed at the same time but you can run both in paralell.

Once installed you need to add it to your startup. See above for the method
Use the following command
xcompmgr -c -f -n


This will activate transparency as well as a shadow on your windows

You can also list all the options. Type this in a terminal:
xcompmgr --help


With some old cards (old ATI for example), xcompmgr will not work. The only solution to get transparency is to install XGL

The dock will only appear on one desktopn
when the dock loads before the window manager the dock will only appear on the first desktopn (This will happend with Beryl). Quite annoying, isn't it?
To solve that issue you have to make sure that cairo-dock will load after the WM. With the dock a little script is provided (/usr/bin/launch-cairo-dock-after-beryl.sh) to help you achieve this.
Use that script instead of just cairo-dock to launch the dock at startup (see above how to do it!). By default the waiting time in the script is 12 secondes (sleep 12). If you need more or less just edit the script.

sometime sub-dcoks are hidden by other windows
This behaviour is WM dependant. The sub-docks havee a "menu" type( or it can be "dock" for application sub-docks).
  • With Beryl deactivate the option to prevent focus stealing in General options.
  • Compiz a similaer option and Metacity doesn't have that problem.


Even when I stick the dock to the edge of the screen there is always 1 pixel extra
In Beryl, with the vertical view there is 1 pixel reserved on the edge of the screen, even when you have a value of 0 or negative in the edge distance option.

There is only 32 bits package no 64 bits
This is no longer strictly true. Some people are working on creating 64 bits package for various distro.

If you can find one for yours the ultimate solutions is to compile the dock yourself using either the SVN method or if you use Ubuntu this method For 64 bits processor.

How to get that wonderful 3D view I saw on the web?
Cairo-Dock engine has a view system which allw you to radically modify the appearance of the dock. Vous pouvez spécifiez la vue du dock principal dans le panneau de conf, onglet "cairo-dock", et la vue des sous-docks dans l'onglet "sub-docks"; il est possible de définir une vue par sous-dock en éditant l'icône pointant sur le sous-dock.
View are provide by the applets called "rendering" so you have to activate it is if not already done. Go to the tab Applets in the configuration window and tick it

Quand je regarde une vidéo en plein écran, le dock reste devant
Encore une fois, cela dépend du WM. Pour parer à ce cas (si vous n'avez pas déjà l'auto-hide), faites clique droit, puis sélectionnez "quick-hide" dans le menu. Le dock va activer l'auto-hide jusqu'à ce que vous passiez la souris dans la zone de rappel. Pour ne pas voir la zone de rappel, ne lui spécifiez pas d'image.

Mon Dock disparait quand j'active la fonction "auto-hide" !
Si la fonction auto hide est activé, le dock semble disparaitre. En fait, il est caché derrière le tableau de bord. Pour corriger ça, il faut lancer le Dock avec la commande suivante :
cairo-dock --keep-above


Glx-Dock / Cairo-Dock Wiki F.A.Q 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.