Skip to content

Cairo-Dock/cairo-dock-core

Repository files navigation

Cairo-Dock

Cairo-Dock is a pretty, light and convenient interface to your desktop, able to replace advantageously your system panel! It features multi-docks, taskbar, launchers and a lot of useful applets. Applets can be detached from the dock to act as desktop widgets. Numerous ready-to-use themes are available in 1 click, and can be easily customized at your convenience. It can use hardware acceleration to be very fast and low on CPU.

Preview Other screenshots are available at Glx-Dock.org.

This project is split in 3 parts:

The Cairo-Dock-Session project aims to provide an easy way to install a session that is desktop agnostic and uses Cairo-Dock as a Shell (the main interface).

Installation

Please see the Wiki.

Packages for Ubuntu 22.04 and 24.04 are available on Launchpad:

Additional information for compiling from source is available here.

Need some help?

See our the updated wiki for the most important information: https://github.com/Cairo-Dock/cairo-dock-core/wiki

See also the original wiki for a lot of additional useful info: http://www.glx-dock.org/ww_page.php

You can find: how to launch the dock at startup, how to customise it, how to resolve some recurrent problems (black background, messages at startup, etc.), how to help us, who we are, etc. A useful tutorial is also available to help you customize your dock: http://www.glx-dock.org/ww_page.php?p=Tutorial-Customisation&lang=en

If you have other questions not solved on our wiki you can post them on our forum (in English or French): http://www.glx-dock.org/bg_forumlist.php

Additional information specific to running Cairo-Dock under Wayland is available here.

Join the project

  • Want to HACK into the dock or write an APPLET? see the complete C API here: http://doc.glx-dock.org
  • You don't like C and still want to write an APPLET for the dock or CONTROL it from a script or the terminal? see its powerful DBus API here: http://www.glx-dock.org/ww_page.php?p=Control_your_dock_with_DBus&lang=en
  • You have some IDEAS / PROPOSITIONS? You need some help to develop an applet? Feel free to use the Github issues or discussions, or post a topic on our forum! We'll be happy to answer you!
  • You want to TRANSLATE Cairo-Dock in your language? Use the 'Translations' tab in Launchpad, it's very simple to use it and helpful for us!

Bug reports

You can report bugs using Github issues. If possible:

  • Read our wiki specially the 'Troubleshooting' section which can help you to resolve some bugs like a black background, messages at startup, etc.
  • Please include also some information like your distribution, your achitecture (32/64bits), your Desktop Manager (Gnome, KDE, XFCE,...) your Window Manager (Compiz, Metacity, Kwin, etc.) or Wayland compositor (Wayfire, Kwin, Labwc, etc.), if you use Cairo-Dock with or without OpenGL, with which theme, etc. On a recent version (>= 3.5.99), you can just copy the "Technical info" page from the About dialog (right click on the dock -> Cairo-Dock -> About) which covers the most important details.
  • Include the method to reproduce the bug (which actions, which options activated)
  • Run the dock with the command cairo-dock -l debug > debug.txt reproduce the bug and join the content of debug.txt.
  • If it's a crash, please give us a backtrace of it with GDB. It's easy thanks to this wiki page.

Thank you for your help!