5
#> Note : many answers have an extra hint.
6
#To popup the hint, simply let the mouse over the sentence for 1 second, a tooltip will appear.
4
13
#X [How can I re-order my icons ?]]
6
15
#> Simply drag them with the mouse, and drop it where you want.
16
25
#> In the “Icons” module, you can choose a <b>icon theme</b>. Enter a name of a theme, for exemple : Human or Gartoon.
17
26
#You can even enter the path of a folder containing personnal icons.
18
#By default, all the Cairo-Dock themes put here the local icons folder “_LocalIcons_”, that is in fact ~/.config/cairo-dock/current_theme/icons.
19
27
#You can enter many themes or folders, the dock will search for images in them in the same order as you entered them.
20
28
#If you let it empty, the default icon theme of your system wil be used.
21
29
#{Hint : you can also directly edit a launcher’s configuration, and set a path for an image. If you don’t write a path, but simply the name of an image, don’t put the extension (.svg, .png, etc), to let the dock choose the best.}
49
57
#> it’s normal, because they both are “docks”. You can either move the dock out of the panel, or launch it wih the command “cairo-dock -–keep-above”.
59
#X [I don’t want other windows to hover the dock]
61
#> Just use the option “reserve space for dock” in the “Accessibility” module.
62
#{Hint : if you use it, you don’t need to use the “keep the dock below “option.}
64
#X [I don’t want that the dock hovers windows]
66
#> Two choices are available, in the “Accessibility” module :
67
# - either choose to “keep the dock below other windows”. The dock will then pop-up when you place the mouse on its screen border.
68
# - or activate the auto-hide. The dock will then appear when you enter the trigger zone.
69
#{Hint : you can choose to pop-up the dock only when the mouse hits the screen corner instead of the whole screen border.
70
#You can also setup the size of the trigger zone in the “Hidden dock” module, and even set an image to it.}
51
74
#X [How can I add a separator ?]
53
76
#> Simply right-click on the dock where you want to add a separator, and select “add a separator”.
71
94
#X [How do I get a 3D dock ?]
73
#> any dock can be displayed with one view, and many views are available (3D, Curve, etc). They are mostly provided by the “dock-rendering” plug-in, so be sure to activate it.
74
#Then, go to the “Views” module, and choose the view you want for main dock, and for sub-dock.
96
#> Any dock can be displayed with one view, and many views are available (3D, Curve, etc).
97
#Go to the “Views” module, and choose the view you want for main dock, and for sub-docks.
75
98
#{Hint : you can setup the view for each sub-dock; just edit the icon pointing on the sub-dock, and choose the view you want for it.}
77
#X [I don’t want other windows to hover the dock]
79
#> Just use the option “reserve space for dock” in the “Accessibility” module.
80
#{Hint : if you use it, you don’t need to use the “keep the dock below “option.}
82
#X [I don’t want that the dock hovers windows]
84
#> Two choices are available, in the “Accessibility” module :
85
# - either choose to “keep the dock below other windows”. The dock will then pop-up when you place the mouse on its screen border.
86
# - or activate the auto-hide. The dock will then appear when you enter the trigger zone.
87
#{Hint : you can choose to pop-up the dock only when the mouse hits the screen corner instead of the whole screen border.
88
#You can also setup the size of the trigger zone in the “Hidden dock” module, and even set an image to it.}
100
#X [How can I change the background of my docks ?]
102
#> In the 'Background' module, you can either choose an image, or a color gradation.
103
#If you set an image, it will be used as the background, if you don't, the gradatoin will be used.
104
#{Hint : the Parabolic view doe not have a background, and the Slide and Rainbow views have their own background parameters.}
106
#X [I find the dock too much flashy, can it be more sober ?]
108
#> Who can do more can do less ! You can for instance deactivate the "Icon effects" plug-in,
109
# or deactivate the effect on mouse hovering in "Animated Icon" plug-in.
110
#You can also decrease the zoom effect or lower the icons' reflect in the "Icon" module,
111
# change the background colors in the "Background" module, or change the view to the "default" view in the "Views" module.
112
#In brief, you can easily have something as much sober as a gnome-panel, but this would be a shame ! ^_^
113
#{Hint : try different themes, some are already very sober, like Dust-Sand or Elementary.}
108
134
#X [How can I change their decorations ?]
110
#> You need to have the “desklet-rendering” plug-in activated. The default decoration is defined in the “Desklets” module.
111
#Moreover, each desklet can have its own decoration. To change a desklet’s decoration,
136
#> The default decoration is defined in the “Desklets” module.
137
#You can setup a different decoration for each desklet. To change a desklet’s decoration,
112
138
# go to the applet’s configuration, click on the “desklet” tab, and then choose the decoration you want.
113
#{Hint : you can add new decorations, by choosing the “personnal” decoration, and providing a background and/or foreground image. You can setup the offsets of these images to adjust the position of the drawings inside the decorations.
139
#{Hint : you can add new decorations, by choosing the “personnal” decoration, and providing a background and/or foreground image. You can setup the offsets of these images to adjust the position of the drawings inside the decorations.}
115
141
#X [How do I insert a desklet into the dock ?]
117
143
#> Simply click on the top right button.
118
#{Hint : if the desklet is locked, the button won’t appear.
144
#{Hint : if the desklet is locked, the button won’t appear.}
120
146
#X [How can I place a desklet on the <i>Compiz Widget Layer</i> ?]
169
195
#> activate the Gmenu applet.
170
196
#{Hint : if you removed your gnome-panel, then the “alt+F1” shortkey does not work anymore. This applet let you setup a shortcut to pop up the menu at the mouse’s location.}
172
#X [How can I have a simple “quick launch” panel ?]
198
#X [How can I have a simple “quick launch” window ?]
174
200
#> activate the Gmenu applet, then you can have it by middle-clicking on its icon.
175
201
#{Hint : if you removed your gnome-panel, then the “alt+F2” shortkey does not work anymore. This applet let you setup a shortcut to pop up the quick-launch dialog.}
187
213
#X [How can I access to my mount points ?]
189
215
#> Simply activate the “shortcuts” applet.
190
#{Hint : you can mount a volume by clicking on its icon. To unmount it, right-click and select “unmount”.}
216
#{Hint : you can mount a volume by clicking on its icon. To unmount it, middle-click on its icon, or right-click -> unmount.}
192
218
#X [How can I access to my Nautilus bookmarks ?]
225
#X [How can I have a same applet many times ?]
251
#X [How can I have a same applet many times ?]
227
253
#> Some applets can run several times at the same time : Clock, Cairo-Penguin, Weather, Netspeed, …
228
254
#Right click on the applet’s icon, and select “launch another instance”. A new instance of this applet appears in the main dock.
229
255
#You can configure this new one like any other applet.
230
256
#{Hint : This allows you, for example, to have the time of different countries in your dock, or to have many animated caracters in your dock, or the weather of different cities.}
232
#X [I have a personal gauge that I want to use in the dock (for cpusage or others)]
258
#X [I have a personal gauge that I want to use in the dock (for System-Monitor or others)]
234
260
#> move the folder containing your gauge in ~/.config/cairo-dock/extras/gauges, you’re done !
236
262
#X [I have a personal Cairo-Clock theme that I want to use in the “clock” applet.]
238
#> move the folder containing your theme in ~/.config/cairo-dock/extras/clock, you’re done !
264
#> move the folder containing your theme in ~/.config/cairo-dock/extras/clock, now it will appear in the list of themes !
239
265
#{Hint : the same goes on for all the applets that propose a theme : dustbin, Cairo-Penguin, weather, etc.}
241
267
#X [How can I change quickly the luminosity of my screen ?]
247
273
#> Activate the AlsaMixer applet, then you can scroll up/down on the icon with the mouse.
275
#X [How can I quickly switch to another desktop ?]
277
#> Activate the Switcher applet, then you can scroll up/down on the icon with the mouse to go to the previous/next desktop,
278
# or click on the icon to select a desktop.
279
#{Hint : this applet even lets you add/remove quickly a desktop !}
281
#X [How can I control my dock with the keyboard ?]
283
#> Many applets have events that can be triggered by a keyboard shortcut :
284
# - the <i>AlsaMixer</i> applet allows you to pop-up a <b>volume button</b> that can be controlled with the left/right arrows.
285
# - the <i>Terminal</i> applet allows you to pop-up the <b>terminal window</b> and directly write inside it.
286
# - the <i>Systray</i> applet allows you to pop-up the <b>notification area</b>.
287
# - the <i>Quick Browser</i> applet allows you to pop-up the <b>menu browser</b>, you can then navigate inside it with the arrows.
288
# - the <i>GMenu</i> applet allows you to pop-up the <b>Applications</b> menu, and also a <b>quick-launcher</b> dialog box.
289
# - the <i>Clipper</i> applet allows you to pop-up the <b>clipboard history</b> menu.
290
# - and of course, the <i>Scooby-Do</i> plug-in let you <b>navigate inside your docks</b> and quickly <b>find and launch</b> applications and files !
291
#{Hint : when you define a shorkey, try it before to be sure it's not already used by another application.}
251
295
[Troubleshooting]
254
298
#> You have to turn on the compositing. For instance, you can run Compiz or xcompmgr.
255
299
#If you’re under XFCE or KDE, you can just activate the compositing in the window manager’s options.
300
#If you're under Gnome, you can activate it in Metacity in this way :
301
# Open gconf-editor, edit the key '/apps/metacity/general/compositing_manager' and set it to 'true'.
256
302
#{Hint : If yo have an ATI or an Intel, you should try without OpenGL first, because their drivers are not yet perfect.}
258
304
#X [My machine is too old to run a composite manager]
291
337
#or if you just made a dream about the dock, pay us a visit on cairo-dock.org.
292
338
#English speakers are welcome, so don’t be shy ! ;-)
294
#If you made a theme for the dock or one of the applet, and want to share it, we’ll be happy to integrate it with the other themes !
340
#If you made a theme for the dock or one of the applet, and want to share it, we’ll be happy to integrate it on our server !
341
#If you wish to develop an applet, a complete documentation is available at http://doc.cairo-dock.org.