Revision 28 as of 2008-01-21 05:02:43

Clear message
  • Immutable Page
  • Info
  • Attachments


Compiz Fusion is beta software under heavy development. We recommend that you make backups of all important data before installing it, and advise against installing Compiz on important production machines such as servers and always-on business workstations since there is a fairly high chance of Compiz Fusion crashing or locking up your system at least once while you use it. It is, however, suitable for normal desktop use.

Different ways of obtaining the software

There are currently three different ways to obtain Compiz Fusion.

  • Use packages made for your distribution. We recommend this approach as most packagers will provide builds that are unbroken and fairly stable.
  • Use the source tarballs for the most recent stable release. This requires some technical experience since it involves installing compile-time dependencies as well as compiling C source code with make.
  • Use the most up-to-date Git version. The Compiz Fusion team will try to keep this as break-free as possible, although there may be sometimes when Compiz Fusion is completely broken. This is not recommended unless you are a packager, or must have the absolute bleeding-edge version.

You may use each of these methods to obtain Compiz Fusion and each will have a different success rate and positives and negatives.

Distribution Packages

{i} Please edit this page to add guides from your own distribution. Thanks!

Arch Linux

Frugalware Linux:

Fedora 7:




Installing from source tarball

This method will work on every distribution, as long as you have satisfied the dependencies required to compile Compiz Fusion. The exact names of the following packages will vary across different Linux distributions, but the following list should apply fairly well to Debian-based distributions.

build-essential libxcomposite-dev libpng12-dev libsm-dev libxrandr-dev libxdamage-dev libxinerama-dev libstartup-notification0-dev libgconf2-dev libgl1-mesa-dev libglu1-mesa-dev libmetacity-dev librsvg2-dev libdbus-1-dev libdbus-glib-1-dev libgnome-desktop-dev libgnome-window-settings-dev gitweb curl autoconf automake automake1.9 libtool intltool libxslt1-dev xsltproc

Once these are installed, you can obtain the source tarball from [].

To compile the source tarballs, extract each one by running the following command on a console:

tar -zxvf <module>.tar.gz

then execute

./configure --prefix=/usr/local
sudo make install

Installing From Git

This is not recommended unless you want the absolute bleeding-edge version or are a developer. Because Git is divided into many different repositories, you can use a script to download and build all the components for you. You can check these out by using:

git clone git://
git clone git://

The 'get-git' script will clone and update all Compiz Fusion related modules such as libcompizconfig, compiz and emerald and the 'YAGS' script will clone all plugin repositories. Using yags is fairly simple, just execute './yags $COMMAND' where $COMMAND can be 'pull' 'make' 'make install' 'make clean' 'clone'. YAGS will then apply this command to all applicable directories.


If you hadn't already, you will need to configure your system using one of the many [:Hardware: hardware guides] available.