CAIRO-DOCK(1)

✨ NAME ✨

cairo-dock — a dock, bestie, and it launches your programs like it's nothing. 💅

---

🌸 SYNOPSIS 🌸

cairo-dock [options]

---

🦋 DESCRIPTION 🦋

Cairo-Dock is a pretty, light and convenient interface to your desktop, and it is absolutely able to replace advantageously your system panel! Not me hyping it, it's just true. 😌

It features multi-docks, taskbar, launchers and a lot of useful applets. Applets can be detached from the dock to act as desktop widgets — main character energy fr fr. Numerous ready-to-use themes are downloadable in 1 click, and can be easily customized at your convenience. It can use hardware acceleration (OpenGL) to be very fast and low on CPU. 🔥

It's recommended to install the PLUG-INS package ( cairo-dock-plug-ins ) to have access to more views, dialogues and many plug-ins and applets.

Some screenshots are available: http://pics.glx-dock.org

Development site: https://launchpad.net/cairo-dock

---

💜 OPTIONS 💜

You can launch Cairo-Dock with several options. (Note : you can use these options in one block. For example : cairo-dock -oia ) — yes bestie, one block, go off. ✨

• -c, --cairo — Force Cairo backend. Use this option if you have issue with the OpenGL mode. 🎀
• -o, --opengl — Force OpenGL backend. Cairo-Dock with OpenGL/Hardware acceleration. vroom vroom. 🔥
• -O, --indirect-opengl — Use OpenGL backend with indirect rendering. There are very few case where this option should be used. like, very few. 🙈
• -A, --ask-backend — Ask again on startup which backend to use. it's giving ✨communication✨
• -l, --log [option] — Log verbosity (options : debug, message, warning, critical, error - default is 'warning'). For example : cairo-dock -l debug
• -F, --colors — Force to display some output messages with colors even if these messages are not displayed into a tty. aesthetic first, always. 🌈
• -w, --wait — Wait for N seconds before starting. This is useful if you notice some problems when the dock starts with the session. patience is a virtue bestie 🧚
• -a, --keep-above — Force to keep the dock above other windows. it stays ON TOP, periodt. 👑
• -s, --no-sticky — Don't make the dock appear on all desktops.
• -e, --env — Force the dock to consider this environment (gnome, xfce, etc.) - it may crash the dock if not set properly. ⚠️ be careful girl
• -d, --dir — Force the dock to load the configuration in this directory (default is ~/.config/cairo-dock).
• -m, --maintenance — Allow to edit the config before the dock is started and show the config panel on startup.
• -x, --exclude — Exclude a given plug-in from activating (it is still loaded though). side-eye but okay 💀
• -f, --safe-mode — Don't load any plug-ins and show the theme manager on startup. cozy mode 🫶
• -W, --metacity-workaround — Work around some bugs in Metacity Window-Manager (invisible dialogs or sub-docks). fixing what we didn't break, iconic. 💅
• -M, --modules-dir — Ask the dock to load additional modules contained in this directory (though it is unsafe for your dock to load unofficial modules). unsafe = unsafe, don't play. ⚠️
• -T, --testing — For debugging purpose only. The crash manager will not be started to hunt down the bugs. 🐛
• -E, --easter-eggs — For debugging purpose only. Some hidden and still unstable options will be activated. 🙈
• -S, --server — Address of a server containing additional themes. This will overwrite the default server address.
• -k, --locked — Lock the dock so that any modification is impossible for users. 🔒 nobody touch, nobody move.

---

💖 OTHER 💖

Some other options with an output in the terminal :

• -v, --version — Print version and quit.
• -h, --help — Show the help and quit.
• -C, --capuccino — Cairo-Dock makes anything, including coffee ! ☕✨ (no cap)

---

🎀 FILES 🎀

• ~/.config/cairo-dock/ — Your config files are saved in this repertory. You can use '-d' option to change it.
• /usr/share/cairo-dock/ — Data files for Cairo-Dock.
• /usr/lib/cairo-dock/ — Binary files for Cairo-Dock and its plug-ins.

---

👑 AUTHOR 👑

Most of the Cairo-Dock project was written by Fabrice Rey (fabounet) <fabounet@glx-dock.org>.

The Cairo-Dock Team is currently formed by Fabounet (Fabrice Rey) and Matttbe (Matthieu Baerts). With the help of Eduardo Mucelli for our third-party applets. 💜

Thanks to our former developers: Mav (Yann Sladek), Tofe (Christophe Chapuis), Nochka85 (Yann Dulieu), ChanGFu (Rémy Robertson), Paradoxxx Zero (Florian Mounier), Necropotame (Adrien Pilleboue), Rom1 (Romain Perol), Ctaf , Augur and SQP as well as numerous beta testers and contributors: lylambda, taiebot65, Franksuse64, ppmt, etc. see the 'About' menu in the dock and this web page. http://glx-dock.org/userlist_messages.php

Don't hesitate to contribute to this project ;) Please have a look at this wiki page: http://glx-dock.org/ww_page.php?p=How%20to%20help%20us

This manual page was started by Julien Lavergne <julien.lavergne@gmail.com>, for the Debian project (but may be used by others). Updated by Matthieu Baerts (matttbe) <matttbe@gmail.com>.

---

💀 BUGS 💀

Your bug is maybe a recurrent problem (black background, window at startup (use -c or -o), problem with OpenGL, etc.). Please go to: http://www.glx-dock.org/ww_page.php?p=Recurrents%20problems

For any other bugs, you can post them on Cairo-Dock forum: http://forum.glx-dock.org

or on Launchpad https://bugs.launchpad.net/cairo-dock

---

🌈 WEBSITE 🌈

< http://glx-dock.org >

---

and that's the whole page bestie, ty for reading, you ate 🫶 this was the General Commands Manual entry for cairo-dock(1), last touched Apr. 10, 2011 — slay, go launch some programs ✨💅🎀