1CAIRO-DOCK(1) General Commands Manual CAIRO-DOCK(1)
2
6 cairo-dock - A dock to launch your programs easily.
7
10 cairo-dock [options]
11
14 Cairo-Dock is a pretty, light and convenient interface to your desktop,
15 able to replace advantageously your system panel!
16 It features multi-docks, taskbar, launchers and a lot of useful
18 applets.
19 Applets can be detached from the dock to act as desktop widgets.
20 Numerous ready-to-use themes are downloadable in 1 click, and can be
21 easily customized at your convenience.
22 It can use hardware acceleration (OpenGL) to be very fast and low on
23 CPU.
24 It's recommended to install the PLUG-INS package ( cairo-dock-plug-ins
26 ) to have access to more views, dialogues and many plug-ins and
27 applets.
28 Some screenshots are available :
30 http://pics.glx-dock.org
31 Development site:
33 https://launchpad.net/cairo-dock
34
37 You can launch Cairo-Dock with several options :
38 (Note : you can use these options in one block. For example :
39 cairo-dock -oia )
40 -c, --cairo
42 Force Cairo backend. Use this option if you have issue with the
43 OpenGL mode.
44 -o, --opengl
46 Force OpenGL backend. Cairo-Dock with OpenGL/Hardware accelera‐
47 tion.
48 -O, --indirect-opengl
50 Use OpenGL backend with indirect rendering. There are very few
51 case where this option should be used.
52 -A, --ask-backend
54 Ask again on startup which backend to use.
55 -l, --log [option]
57 Log verbosity (options : debug, message, warning, critical,
58 error - default is 'warning').
59 For example : cairo-dock -l debug
60 -F, --colors
62 Force to display some output messages with colors even if these
63 messages are not displayed into a tty.
64 -w, --wait
66 Wait for N seconds before starting. This is useful if you notice
67 some problems when the dock starts with the session.
68 -a, --keep-above
70 Force to keep the dock above other windows.
71 -s, --no-sticky
73 Don't make the dock appear on all desktops.
74 -e, --env
76 Force the dock to consider this environment (gnome, xfce, etc.)
77 - it may crash the dock if not set properly.
78 -d, --dir
80 Force the dock to load the configuration in this directory
81 (default is ~/.config/cairo-dock).
82 -m, --maintenance
84 Allow to edit the config before the dock is started and show the
85 config panel on startup.
86 -x, --exclude
88 Exclude a given plug-in from activating (it is still loaded
89 though).
90 -f, --safe-mode
92 Don't load any plug-ins and show the theme manager on startup.
93 -W, --metacity-workaround
95 Work around some bugs in Metacity Window-Manager (invisible
96 dialogs or sub-docks)
97 -M, --modules-dir
99 Ask the dock to load additional modules contained in this direc‐
100 tory (though it is unsafe for your dock to load unofficial mod‐
101 ules).
102 -T, --testing
104 For debugging purpose only. The crash manager will not be
105 started to hunt down the bugs.
106 -E, --easter-eggs
108 For debugging purpose only. Some hidden and still unstable
109 options will be activated.
110 -S, --server
112 Address of a server containing additional themes. This will
113 overwrite the default server address.
114 -k, --locked
116 Lock the dock so that any modification is impossible for users.
117
120 Some other options with an output in the terminal :
121 -v, --version
123 Print version and quit.
124 -h, --help
126 Show the help and quit.
127 -C, --capuccino
129 Cairo-Dock makes anything, including coffee !
130
133 ~/.config/cairo-dock/
134 Your config files are saved in this repertory. You can use
135 '-d' option to change it.
136 /usr/share/cairo-dock/
138 Data files for Cairo-Dock.
139 /usr/lib/cairo-dock/
141 Binary files for Cairo-Dock and its plug-ins.
142
145 Most of the Cairo-Dock project was written by Fabrice Rey (fabounet)
146 <fabounet@glx-dock.org>.
147 The Cairo-Dock Team is currently formed by Fabounet (Fabrice Rey) and
149 Matttbe (Matthieu Baerts).
150 With the help of Eduardo Mucelli for our third-party applets.
151 Thanks to our former developers: Mav (Yann Sladek), Tofe (Christophe
153 Chapuis), Nochka85 (Yann Dulieu), ChanGFu (Rémy Robertson), Para‐
154 doxxx Zero (Florian Mounier), Necropotame (Adrien Pilleboue), Rom1
155 (Romain Perol), Ctaf , Augur and SQP as well as numerous beta testers
156 and contributors: lylambda, taiebot65, Franksuse64, ppmt, etc. see the
157 'About' menu in the dock and this web page.
158 http://glx-dock.org/userlist_messages.php
159 Don't hesitate to contribute to this project ;)
161 Please have a look at this wiki page:
162 http://glx-dock.org/ww_page.php?p=How%20to%20help%20us
163 This manual page was started by Julien Lavergne
165 <julien.lavergne@gmail.com>, for the Debian project (but may be used by
166 others).
167 Updated by Matthieu Baerts (matttbe) <matttbe@gmail.com>.
168
171 Your bug is maybe a recurrent problem (black background, window at
172 startup (use -c or -o), problem with OpenGL, etc.). Please go to:
173 http://www.glx-dock.org/ww_page.php?p=Recurrents%20problems
174 For any other bugs, you can post them on Cairo-Dock forum:
176 http://forum.glx-dock.org
177 or on Launchpad
178 https://bugs.launchpad.net/cairo-dock
179
182 < http://glx-dock.org >
183 Apr. 10, 2011 CAIRO-DOCK(1)