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

Support Us

Flattr this

Cairo-Dockon

First Steps

A new feature with Cairo-Dock 2 : OpenGL support

With Cairo-Dock 2.0 version, you can choose between using Cairo-Dock with or without OpenGL.
With OpenGL, the use of your video card is maximized and the dock with many effects and plug-ins is fluid all the time even with a CPU under heavy load!
Unfortunately all ATI and many Intel cards don't support the OpenGL v2 as well as Nvidia cards (it seems to be resolved for Intel cards on Ubuntu Karmic / Fedora 12). For the owner of ATI or Intel video card, for which DRI2 support is under development, as well as for the legacy video card which do no support OpenGL v2, the Cairo back-end is still available. This allow everybody to be able to enjoy most of the dock's improvements and the new applets. But, this drivers are improving every day and we hope that you can use Cairo-Dock with OpenGL with every graphics cards!
Note that with the "same" config of AWN and Cairo-Dock without OpenGL, Cairo-Dock use less CPU than AWN.



To skip the OpenGl message at startup you have to force the mode that you want.

Cairo-Dock WITH OpenGL, add the parameter "-o" :
cairo-dock -o


Cairo-Dock WITHOUT OpenGL (with Cairo backend), add the parameter "-c" :
cairo-dock -c







First Launch

There are several ways to launch Cairo-Dock. A launcher is created in System Tools. For example with Gnome :
  • Go to Applications / System Tools / Cairo-Dock or GlxDock (Cairo-Dock with OpenGL)
  • Or Press Alt + F2 and type cairo-dock in the box that opened then validate.
  • You can also do it from a terminal:
    cairo-dock &
For ATI cards owners you have to force Cairo-Dock to don't use OpenGL :
cairo-dock -c






Launch Cairo-Dock at statup
Go there : Execute cairo-dock at startup

Launch Cairo-Dock at startup WITHOUT any additional message

To skip the info message at startup you have to force the mode that you want. Launch Cairo-Dock with one of these two commands :


Cairo-Dock with OpenGL
cairo-dock -o


Cairo-Dock with Cairo back-end
cairo-dock -c



For Gnome
Menu : System> Preferences> Sessions> Select the tab "Startup Programs> Add
Enter the commands for the program: cairo-dock -o (with OpenGL) or cairo-dock -c (without OpenGL)

For KDE
KDE Configuration Center> KDE Components> Add
Enter the commands for the program: cairo-dock -o (with OpenGL) or cairo-dock -c (without OpenGL)

For XFCE
Menu :
Parameters> Applications started Automatically> Add++
Enter the commands for the program: cairo-dock -o (with OpenGL) or cairo-dock -c (without OpenGL)







Customization

If you have any problems (normally ) you can see how to customize easily your favorite dock in the next section : Customization.







Recurrent problems
A black background? Problem with (S)Mplayer or VirtualBox?
See this section : Recurrent problems


Problem when Cairo-Dock is launched automatically ?

If you have some bug when Cairo-Dock is launched automatically at startup and not when it's launched manually : Try to launch it with a delay.

In your session manager (help here), use this command :
sh -c "sleep 15 && cairo-dock -o"

Change any parameters according to your configuration (here we have 15 seconds and Cairo-Dock with OpenGL)









Cairo-Dock works on Linux
Several research on the web shows that some people have been able to use the dock on a few Linux distributions:
  • Ubuntu/Debian (Cairo-Dock is developed on that distribution)
  • Fedora
  • ArchLinux
  • Mandriva
  • Gentoo
  • Frugalware
  • OpenSuSe

As well as a few windows manager:
  • Gnome (of course with Gnome-integration plug-in)
  • Xfce (of course with xfce-integration plug-in)
  • KDE


So if you have any problems (except these recurrent problems) please report your bug on our forum.
Also if you have some ideas, propositions, new applets, etc. ! Don't be shy !


Glx-Dock / Cairo-Dock Wiki First Steps 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.