• Immutable Page
  • Info
  • Attachments

Installation

Setting Up the Build Environment

Create a build folder for all of the compiz fusion sources

mkdir -p ~/src/compiz/

Change to this directory for all downloading to keep all your sources in one place.

Each install step in this guide will use a custom prefix to ensure that this installation does not conflict with your system packages. The prefix used by this guide is /opt/compiz but you may use any one that you want (you could even use a folder in your home directory).

In order for pkg-config to see this custom prefix during the build process, you must:

export PKG_CONFIG_PATH=/opt/compiz/lib/pkgconfig:/opt/compiz/share/pkgconfig

This variable only needs to be set for the duration of the build process.

You will need to install git (available as git-core on debian-based systems). You will also need numerous build dependencies. If you are using apt, you can get nearly everything with:

sudo apt-get build-dep compiz 

Compiz

Clone compiz's source with:

git clone git://anongit.freedesktop.org/xorg/app/compiz

Change to the created compiz directory, then generate and configure the buildsystem with

./autogen.sh --prefix=/opt/compiz

You may need to specify additonal build options, but most of the time you will not.

Proceed to build it with

make

And install with

sudo make install

Return to the main source directory for the next step, and continue to do so after each package.

BCOP

Many of the plugins in Compiz Fusion use a package called BCOP for option code generation, so it must be installed for them to compile:

Clone:

git clone git://anongit.compiz-fusion.org/fusion/libraries/bcop

Configure:

./autogen.sh --prefix=/opt/compiz

Install:

sudo make install

Compiz Fusion Plugins

There are three Compiz Fusion plugin packs, but only the first two are supported. Clone:

git clone git://anongit.compiz-fusion.org/fusion/plugins-main
git clone git://anongit.compiz-fusion.org/fusion/plugins-extra

If you want the third, unsupported pack:

git clone git://anongit.compiz-fusion.org/fusion/plugins-unsupported

For each plugin pack that you are building:

Configure:

./autogen.sh --prefix=/opt/compiz

Build:

make

Install:

sudo make install

<!> Note that you must build plugins-main before plugins-extra because the the former contains development headers required by the latter.

CompizConfig

Compiz Fusion offers an alternative configuration system for compiz called CompizConfig made up of several packages. You must use this configuration system to use the CompizConfig Settings Manager (CCSM).

libcompizconfig

This is the main part of the CompizConfig system. It provides a library and a compiz plugin (ccp).

Clone:

git clone git://anongit.compiz-fusion.org/fusion/compizconfig/libcompizconfig

Configure:

./autogen.sh --prefix=/opt/compiz

Build:

make

Install:

sudo make install

Backends

Libcompizconfig ships with a Flat File (ini) backend, and there are two external backends for CompizConfig which may be installed. These backends provide better integration with the Gnome and KDE desktop environments.

Gnome users may wish to get

git clone git://anongit.compiz-fusion.org/fusion/compizconfig/compizconfig-backend-gconf

And KDE users may want

git clone git://anongit.compiz-fusion.org/fusion/compizconfig/compizconfig-backend-kconfig

Both of them can be built in the usual way:

Configure:

./autogen.sh --prefix=/opt/compiz

Build:

make

Install:

sudo make install

compizconfig-python

Python bindings for libcompizconfig.

Clone:

git clone git://anongit.compiz-fusion.org/fusion/compizconfig/compizconfig-python

Configure:

./autogen.sh --prefix=/opt/compiz

Build:

make

Install:

sudo make install

CCSM

The CompizConfig Settings Manager may be installed with:

Clone:

git clone git://anongit.compiz-fusion.org/fusion/compizconfig/ccsm

Install:

sudo python setup.py install --prefix=/opt/compiz

It requires compizconfig-python and pygtk.

Running

Compiz may be started by something like

/opt/compiz/bin/compiz --replace ccp

but it varies by platform.

In order to make python-based tools, such as CCSM, function, you must put

export PYTHONPATH=/opt/compiz/lib/python2.5/site-packages

in a file that is sourced automatically such as /etc/profile or ~/.bashrc. The path may vary slighty if you have a different version of python or architecture, so check /opt/compiz/ to see what the exact path is on your system.

Updating

To update, simply repeat the steps of this guide, however, instead of running

git clone

run

git pull

from within each source directory before repeating the build process.

Installation/CompileGuide (last edited 2008-04-20 06:50:00 by CPE-58-161-138-188)