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



Support Us

Flattr this


From BZR

Caution: this version is regarded as unstable and can present some bugs : Use at your own risk
And stay updated

Don't forget to remove other releases of CD before install it by BZR

If you have any bugs : please and don't be shy and open a new thread on BZR forum

With BZR on Launchpad, you can help us easily !

If you can code in C (or in another language using the DBus applet), it's very easy to propose your modifications on a personal branch on lp

For more informations, read this : Help us with BZR

Adress of bazaar
For more informations about the adress or to browse sources files, go there : https://code.edge.launchpad.net/cairo-dock

Generic Method

If you aren't on Debian, Ubuntu and other forks, Fedora or ArchLinux, this section is made for you ! For the others, go to the next sections.
    • Install all dependencies. Caution : naming may vary depending on your distribution (dev can be called devel, etc.)
      bzr libtool build-essential automake1.9 autoconf m4 autotools-dev pkg-config zenity intltool gettext libcairo2-dev libgtk2.0-dev librsvg2-dev libdbus-glib-1-dev libgnomeui-dev libvte-dev libxxf86vm-dev libx11-dev libalsa-ocaml-dev libasound2-dev libxtst-dev libgnome-menu-dev libgtkglext1-dev freeglut3-dev glutg3-dev libetpan-dev libxklavier-dev libwebkit-dev libexif-dev curl
      And libthunar-vfs-1-dev for XCFE or libgnomevfs2-dev for others.
    • Download the latest source code with bzr in a directory of your choice :
      bzr checkout --lightweight lp:cairo-dock-core
      bzr checkout --lightweight lp:cairo-dock-plug-ins
      If you don't have the launchpad plug-in of bzr, the complete addresses are :
    • Compile Cairo-Dock and after its plug-ins:
      cd cairo-dock-core
      autoreconf -isvf && ./configure --prefix=/usr
      make -j $(grep -c ^processor /proc/cpuinfo) ## if you have an error, see if you have install all dependences and/or post a new thread on our forum
      # make install ## on root mode
      cd ../cairo-dock-plug-ins/
      autoreconf -isvf && ./configure --prefix=/usr
      make -j $(grep -c ^processor /proc/cpuinfo)
      # make install ## as root and if you had no errors
      Tips : with "make -j $(grep -c ^processor /proc/cpuinfo)" the compilation uses all core of your processor.
    • Update with this command in the two directories (cairo-dock-core and cairo-dock-plug-ins)
      bzr up
      Compile with the same commands as the previous box.
    • Tips : If you want to know which rev you are :
      bzr log -l1 --line

Debian / Ubuntu

Mav (with the help of matttbe ) wrote a script for Debian/Ubuntu users (cairo-dock_bzr.sh) which allows the installation and the update via BZR and avoids the tiresome steps for the recovery of the sources and the installation. Moreover, the script will automatically install all the packages necessary for the compilation (the same ones as those described in the part "By compilation").

If you are on Debian or Ubuntu (or Linux Mint) you can also install Cairo-Dock with DEB packages from our 'Weekly Build' PPA.
You can also add this PPA to your sources.list with Mav' script. Or look there : ppa Weekly

First installation

Open a Terminal, start by creating a specific directory (for example /opt/cairo-dock_bzr) and use it without administrator right:

sudo mkdir /opt/cairo-dock_bzr
sudo chown $USER:$USER /opt/cairo-dock_bzr
cd /opt/cairo-dock_bzr

Then get the script, make it executable and launch it:

wget http://bzr.glx-dock.org/cairo-dock_bzr.sh
sudo chmod u+x cairo-dock_bzr.sh
REM: For Debian users, you need to install the 'sudo' package.

After that, you have this menu :
    1 --> Mettre à jour la version BZR installée
    2 --> Installer la version BZR pour la première fois
    3 --> Reinstaller la version BZR actuelle
    4 --> Désinstaller la version BZR
    5 --> A propos

And the translation is :
    1 --> Update (your BZR release)
    2 --> Install (your BZR release)
    3 --> Reinstall (your BZR release)
    4 --> Uninstall (your BZR release)
    5 --> About

After pressing "2" menu, you can downloading sources by http or https (proxy).

To finish, enter your own password when the script requires it of you in order to proceed to the installation.

A message is posted with each installation of modules and the final message indicates if everything went well. If not please post in our forum the error messages (or consult the log.txt). It can be helpful !

Update it

Open a Terminal, in the specific file which you had created with the first installation (in our /opt/cairo-dock_bzr example) and start the script again:

cd /opt/cairo-dock_bzr

Press "1" to start the update.

If an update is found, enter your own password, otherwise the message “No update available” will appear and the script will exit.

Note: Mav's script “auto-updates”, therefore each time you launch it, it will seek the last version of script available…


You can create a launcher in Cairo-Dock to execute the script… For that, create a new launcher (Right Click on the dock and select “Add a launcher”). Click on “New” and Enter this:

- Name of the launcher (example) : Cairo BZR Update

- Command to execute at the click :
gnome-terminal --working-directory=/opt/cairo-dock_bzr/ -e "./cairo-dock_bzr.sh"

(change your "working-directory" if necessary

- Directory of the picture :
(your most beautiful icon !)

Validate!!! and just click on your new icon to update your BZR version.


It's easy with Yaourt !
On root mode, add arlinuxfr repositories in your file /etc/rc.conf

Server = http://repo.archlinux.fr/i686/

Server = http://repo.archlinux.fr/x86_64/

Install yaourt if you have do that before.

sudo pacman -S yaourt
yaourt -Syu

Now, install cairo-dock and its plug-ins !
yaourt -S cairo-dock-bzr cairo-dock-plug-ins-bzr

Remember to check the plugins' PGKBUILD and remove the plugins you want from the blacklist line.


  • Install this kit
    su -
    yum -y groupinstall buildsys-build

  • After that, install all dependences with yum install:
    yum install bzr alsa-lib-devel automake dbus-glib-devel desktop-file-utils gettext gnome-menus-devel gnome-vfs2-devel gtk2-devel gtkglext-devel intltool libXcomposite-devel libXinerama-devel libXrender-devel libXtst-devel libXxf86vm-devel libetpan-devel libexif-devel libgnomeui-devel librsvg2-devel libtool libxklavier-devel libxml2-devel vte-devel perl WebKit-gtk-devel curl
    Install Thunar-devel instead of gnome-vfs2-devel if you uses XFCE

  • After that go to a new repertory to download sources (for example /opt/ with user right)
    bzr checkout --lightweight lp:cairo-dock-core
    bzr checkout --lightweight lp:cairo-dock-plug-ins

  • Compile Cairo-Dock and its plug-ins:
    cd cairo-dock-core
    autoreconf -isvf && ./configure --prefix=/usr && make
    su -
    make install # If you haven't any error before that
    cd ../cairo-dock-plug-ins/
    autoreconf -isvf && ./configure --prefix=/usr && make
    su -
    make install # If you haven't any error before that

  • Update with this command in the two repertories (cairo-dock-core and cairo-dock-plug-ins)
    bzr up
    Compile with the same commands as the box before this.


For more precision go here.



An atom feed is available in order to know when there is an update (every day ) .



You can use the Atom feed on conky with a script.
  • You need curl :
    sudo apt-get install curl
    (or yum install curl, sudo pacman -S yaourt, emerge -av net-misc/curl, etc. depending of your distribution)
  • Save these line on your computer (for example '~/.conky-rss' ; a file hidden in your home)
    # RSS Display Script by Bill Woodford (admin@sdesign.us) v1.0
    # This script is designed to output story titles for most any RSS Feed.
    # This script depends on curl. Please ensure it is installed and in your $PATH
    # Gentoo: emerge -av net-misc/curl
    # Debian: apt-get install curl
    # Homepage: http://curl.haxx.se/
    # Usage:
    # .conkyrc:    ${execi [time] /path/to/script/conky-rss.sh URI LINES TITLENUM}
    #    URI = Location of feed, ex. http://www.gentoo.org/rdf/en/glsa-index.rdf
    #    LINES = How many titles to display (default 5)
    #    TITLENUM = How many times the title of the feed itself is specified, usually 1 or 2 (default 2)
    # Usage Example        
    #        ${execi 300 /home/youruser/scripts/conky-rss.sh http://www.foxnews.com/xmlfeed/rss/0,4313,1,00.rss 4 2}

    #RSS Setup - Don't change unless you want these values hard-coded!
    uri=$1                            #URI of RSS Feed
    lines=$2                        #Number of headlines
    titlenum=$3                        #Number of extra titles

    #Script start
    #Require a uri, as a minimum
    if [[ "$uri" == "" ]]; then
        echo "No URI specified, cannot continue!" >&2
        echo "Please read script for more information" >&2
        #Set defaults if none specified
        if [[ $lines == "" ]]; then lines=5 ; fi
        if [[ $titlenum == "" ]]; then titlenum=2 ; fi

        #The actual work
        curl -s --connect-timeout 30 $uri |\
        sed -e 's/<\/title>/\n/g' |\
        grep -o '.*'</span> |\ <br/>    sed -e <span class="sntx_bash_string">'s/<title>//'</span> |\ <br/>    head -n <span class="sntx_bash_var">$</span>((<span class="sntx_bash_var">$lines</span> + <span class="sntx_bash_var">$titlenum</span>)) |\ <br/>    tail -n <span class="sntx_bash_var">$</span>((<span class="sntx_bash_var">$lines</span>)) <br/>fi</span></div></div> </li><li>This script needs +x right <div class='sntx_code'><div class='sntx_code_inner'><span class="sntx_bash_default">chmod u+x CHEMIN/NAME_OF_YOUR_FILE.sh</span></div></div> (~/.conky-rss.sh) </li><li>Modify your ~/.conkyrc with, for example<div class='sntx_code'><div class='sntx_code_inner'>${color white}Cairo-Dock${color} ${hr 2} <br/>${color lightgrey}Core : ${execi 900 ~/.conky-rss.sh http://bazaar.launchpad.net/%7Ecairo-dock-team/cairo-dock-core/cairo-dock/atom 2 1} <br/>Plug-ins : ${execi 900 ~/.conky-rss.sh http://bazaar.launchpad.net/%7Ecairo-dock-team/cairo-dock-plug-ins/plug-ins/atom 2 1}</div></div> (modify every <span class="sntx_italic">2</span> in order to have more or less lines and change the path of the script (~/.conky-rss.sh)</li></ul></td> </tr> </table> </div> <br/> </td> </table> <br/> <table width="100%"><tr> <td id="hdrPlus"> <a href="index.php">Glx-Dock / Cairo-Dock</a> <a href="ww_page.php">Wiki</a> <b>From BZR</b> </td> <td id="hdrPlus" class="small" align="right"><a href="#top">Top</a></td> </tr> </table> <hr/> <div class="small"> <img src="templates/bluecloud/images/elementspeak.png" align="right"/> Online users : <span style="color:#f0f0f0;"> <br/> </span> </div> </div> <br/> <div align="center" class="small"> Powered by ElementSpeak © 2007 Adrien Pilleboue, 2009-2013 Matthieu Baerts. <br /> <font color="grey">Dock based on CSS Dock Menu (Ndesign) with jQuery. Icons by zgegball</font> <br/>Cairo-Dock is a free software under GNU-GPL3 licence. First stable version created by Fabounet.<br />Many thanks to TuxFamily for the web Hosting and Mav for the domain name. </div> </body> </html>