Difference between revisions of "Cairo-Dock"

From ArchWiki
Jump to: navigation, search
(new article - missing description about cairo-dock + information about usage with other DE's and such ++ more to come)
 
m (Added one liner on top + fixing typos)
Line 1: Line 1:
 
[[Category:Desktop environments (English)]]
 
[[Category:Desktop environments (English)]]
 +
Cairo-dock is a highly customizable dock written in C.
 
==Installation==
 
==Installation==
 
[https://aur.archlinux.org/packages.php?ID=15201 Cairo-dock] and [https://aur.archlinux.org/packages.php?ID=31144 Cairo-dock plugins] are available from the [[AUR]] and are installed using [[yaourt]] or [[makepkg]].
 
[https://aur.archlinux.org/packages.php?ID=15201 Cairo-dock] and [https://aur.archlinux.org/packages.php?ID=31144 Cairo-dock plugins] are available from the [[AUR]] and are installed using [[yaourt]] or [[makepkg]].
Line 13: Line 14:
  
 
==Configuration==
 
==Configuration==
 
 
===Running the dock===
 
===Running the dock===
To do a standard run:
+
Run as default:
 
  $ cairo-dock &
 
  $ cairo-dock &
The first time your run cairo-dock, a startup message will prompt you to run it using OpenGL backend or Cario backend. Optionally, you can specify which backend to use when running cairo-dock. Specifying a backend will suppress the startup message.<br>
+
This will generate a startup message that will ask you to choose a backend for the current session (OpenGL or Cairo). There is an option to remember the choice and if not choosing to remember the choice, a startup message will be generated each time cairo-dock is run without backend options. To supress the startup message, you can specify which backend to use when running cairo-dock by specifying it as an option.<br>
  
To run with OpenGL backend
+
Run with OpenGL backend
  $ cairo-dock -o
+
  $ cairo-dock -o &
To run with Cairo backend
+
Run with Cairo backend
  $ cairo-dock -c
+
  $ cairo-dock -c &
{{Tip|All using ATI graphics cards should use this option}}
+
{{Tip|All using ATI graphics cards should use this option. Some cards/drivers does not support OpenGL, which may prevent cairo-dock from running correctly.}}
  
 
===Running the dock at startup===
 
===Running the dock at startup===
Depending on which [[DE]] or [[Window Manager|WM]] is being used, the methods are different.
+
This depends on which [[DE]] or [[Window Manager|WM]] that is being used.
====General Method====
+
====Cario-dock====
Run cairo-dock and right-click the dock > Cairo-Dock > Launch Cairo-Dock on startup. The setting will be stored in {{Filename|~/.config/autostart/cairo-dock-cairo.desktop}} and used the next time you login.
+
Run cairo-dock and right-click the dock > Cairo-Dock > Launch Cairo-Dock on startup. The settings will be stored in {{Filename|~/.config/autostart/}} and used the next time you login.
  
 
====Openbox====
 
====Openbox====
Add the following to {{Filename|~/.config/autostart.sh}}.
+
Add the following to {{Filename|~/.config/openbox/autostart.sh}}.
 
  cairo-dock &
 
  cairo-dock &
  
Line 38: Line 38:
 
==Troubleshooting==
 
==Troubleshooting==
 
===Two instances of cairo-dock running===
 
===Two instances of cairo-dock running===
This is most likely a result of your session being saved and being runned at next startup.
+
This is most likely a result of sessions being saved and being runned at next login.
 
====Openbox====
 
====Openbox====
If you are starting the dock from {{Filename|~/.config/openbox/autostart.sh}}, remove the file
+
If you are starting the cairo-dock from {{Filename|~/.config/openbox/autostart.sh}} - remove autostart files generated by cario-dock:
  $ rm ~/.config/autostart/cairo-dock-cairo.desktop
+
  $ rm ~/.config/autostart/cairo-dock*
 
==More resources==
 
==More resources==
[http://www.glx-dock.org/index.php glx.org]
+
* [http://www.glx-dock.org/index.php glx.org]
 +
* [https://launchpad.net/cairo-dock launchpad]

Revision as of 00:16, 14 June 2011

Cairo-dock is a highly customizable dock written in C.

Installation

Cairo-dock and Cairo-dock plugins are available from the AUR and are installed using yaourt or makepkg.

Yaourt installation

To install the core packages:

$ yaourt -S cairo-dock 

The core packages provides only the strict minimum to run cairo-dock. To use applets, animations, views, effects and dialogs with the dock you will also need the plugin packages:

$ yaourt -S cairo-dock-plug-ins

To install the latest BZR snapshot packages:

Warning: These packages are unstable and should be used at own risk
$ yaourt -S cairo-dock-bzr cairo-dock-plugins-bzr 

Configuration

Running the dock

Run as default:

$ cairo-dock &

This will generate a startup message that will ask you to choose a backend for the current session (OpenGL or Cairo). There is an option to remember the choice and if not choosing to remember the choice, a startup message will be generated each time cairo-dock is run without backend options. To supress the startup message, you can specify which backend to use when running cairo-dock by specifying it as an option.

Run with OpenGL backend

$ cairo-dock -o &

Run with Cairo backend

$ cairo-dock -c &
Tip: All using ATI graphics cards should use this option. Some cards/drivers does not support OpenGL, which may prevent cairo-dock from running correctly.

Running the dock at startup

This depends on which DE or WM that is being used.

Cario-dock

Run cairo-dock and right-click the dock > Cairo-Dock > Launch Cairo-Dock on startup. The settings will be stored in Template:Filename and used the next time you login.

Openbox

Add the following to Template:Filename.

cairo-dock &

Configuring the dock

To configure the dock, right-click the dock > Cairo-Dock > Configure

Troubleshooting

Two instances of cairo-dock running

This is most likely a result of sessions being saved and being runned at next login.

Openbox

If you are starting the cairo-dock from Template:Filename - remove autostart files generated by cario-dock:

$ rm ~/.config/autostart/cairo-dock*

More resources