#title Cairo-Dock ||<>|| '''The domain name cairo-dock.org has unfortunately changed !''' Now, you can find the '''website, wiki, forum, repository, doc, etc. on [[http://www.glx-dock.org|glx-dock.org]]''' = Introduction = Cairo-Dock is an animated application launch bar for the desktop, comparable to the dock in Mac OS X or Rocket Dock (for Windows). Now, you can use Cairo-Dock with '''OpenGL''' (to use your graphic card!). You can find some screenshots [[http://www.glx-dock.org/mc_album.php?a=3|here]]. Since Cairo-Dock 2.4 (by default on Ubuntu 11.10 Oneiric), it's possible to launch a Cairo-Dock session: it will launch a Gnome session with Compiz (or Metacity) without any panel/dash except Cairo-Dock. But Cairo-Dock is compatible with most WMs (Compiz-Fusion, Beryl, Compiz, Metacity, Kwin, etc.), most environments (Gnome, XFCE, LXDE, KDE, etc.), most sessions/panels/dashes (Unity, Gnome-Shell, XFCE panel, LXDE panel, KDE panel, etc.). It's better with a composite manager (if your WM doesn't support the compositing -- e.g. if you're a black/non transparent background -- simply install Compton or Xcompmgr), but it can also use fake transparency. This page only describes how to install Cairo-Dock and some basic usage instructions. If you want to know more about configuration and themes you should go to the [[http://www.glx-dock.org/index.php|Cairo-Dock website]], its [[http://www.glx-dock.org/ww_page.php?p=Accueil&lang=en|wiki]] and read this [[http://www.glx-dock.org/ww_page.php?p=A%20complete%20tutorial%20on%20how%20to%20customize%20your%20dock&lang=en|tutorial]]. The site is in French '''and''' in English, the [[http://www.glx-dock.org/ww_page.php|wiki]] has a complete English section and don't be afraid to ask questions or report bugs in the [[http://www.glx-dock.org/bg_forumlist.php|forum]]. = Installation = The project is split into two parts: the dock itself and the plug-ins. Only the installation of the dock is explained, but installing the plug-ins is the same, just make sure you install the plug-ins after the dock. The config file will not be overwritten during updates as Cairo-Dock is capable of inserting the missing fields if any without losing your previous settings. Please note that, although Cairo-Dock is listed in the Universe repository since Ubuntu 8.10 (Intrepid Ibex) and can be installed using Synaptic Package Manager, '''but''' it is recommended to install Cairo-Dock using one of the methods described below to get the most up-to-date and stable version of Cairo-Dock. == From the Repository/PPA (Stable) == Cairo-Dock devs maintain their own repository and a PPA for all supported versions of Ubuntu. === PPA === Simply launch these commands from a terminal: {{{ sudo add-apt-repository ppa:cairo-dock-team/ppa sudo apt-get update}}} If Cairo-Dock is already installed, install the updates by using the Update Manager or this command: {{{ sudo apt-get dist-upgrade}}} If not, install it via the Software Center or via this command: {{{ sudo apt-get install cairo-dock cairo-dock-plug-ins}}} === Cairo-Dock repository === To add the Cairo-Dock repository to your sources simply launch these commands from a terminal: {{{ sudo -v}}} {{{ echo "deb http://download.tuxfamily.org/glxdock/repository/ubuntu $(lsb_release -sc) cairo-dock ## Cairo-Dock-Stable" | sudo tee -a /etc/apt/sources.list wget -q http://download.tuxfamily.org/glxdock/repository/cairo-dock.gpg -O- | sudo apt-key add - sudo apt-get update sudo apt-get install cairo-dock cairo-dock-plug-ins # OR if it's already installed => # sudo apt-get dist-upgrade}}} == Development version: PPA (can be unstable) == A PPA is regularly updated. You can add it and install the latest version of Cairo-Dock with these commands launched from a terminal: {{{ sudo add-apt-repository ppa:cairo-dock-team/weekly sudo apt-get update >/dev/null sudo apt-get dist-upgrade}}} == Development version: Compilation (can be unstable) == A script has been written to compile the BZR version of Cairo-Dock easily. So, you just have to create a directory where the script will be installed in, download the script and launch it: Open a terminal, and create a new directory: {{{ mkdir /cairo-dock_bzr cd /cairo-dock_bzr}}} Then get the script, make it executable and launch it: {{{ wget http://bzr.glx-dock.org/cairo-dock_bzr.sh chmod u+x cairo-dock_bzr.sh ./cairo-dock_bzr.sh}}} Simply follow the instructions (in English) To finish, enter your own password when prompted by the script in order to proceed with to the installation. A line will appear after the installation of each module and a final message will appear indicating that everything went well. If not, consult the log.txt file in the directory you have created at the beginning. Look at the end to locate the problem, then post it in the [[http://www.glx-dock.org/bg_forumlist.php|forum]]. == What is installed? == Cairo-Dock stores your launchers and your parameters in a hidden directory, ~/.config/cairo-dock Also, binaries are in /usr/bin and data (including the default themes) in /usr/share = First Launch = If you installed Cairo-Dock from the packages, you can logout to launch the new Cairo-Dock session or if you want to use it on your current session, there should be a launcher in the applications menu, under the ''System Tools'' sub-menu. If there isn't a launcher there, just press `Alt+F2` and type in {{{cairo-dock}}}. To enable backtraces on launch (sometimes useful if a problem occurs), open a terminal and type {{{cairo-dock & disown}}} and press enter. On first launch, Cairo-Dock will configure itself and will offer you a list of themes to choose from. This allows you to have a fully functional dock immediately. You will have to move the mouse cursor to the bottom of the screen to see the dock if auto-hide has been enabled. This depends on the theme you chose at launch. If you want to use another theme, right click on the dock and select ''Cairo-Dock > Configure > Themes''. To configure the dock's settings, right click the dock and select ''Cairo-Dock > Configure''. REM: Cairo-Dock has a support of OpenGL. If you want to use it automatically, simply launch Cairo-Dock with {{{cairo-dock -o}}}. Note that the OpenGL can be badly supported by your video drivers but most of them support it well (have a look the wiki of Cairo-Dock for more details). = See Also = Cairo-Dock is not the only dock but has many possibilities (OpenGL support, many effects and views, many plug-ins, fast, a dynamic project, etc.). * [[AvantWindowNavigator]] = External Links = * [[http://www.glx-dock.org|Cairo-Dock Homepage]] * [[http://www.glx-dock.org/ww_page.php|Cairo-Dock Wiki]] * [[http://www.glx-dock.org/ww_page.php?p=Recurrents%20problems&lang=en|Recurrent problems]] ---- CategorySoftware