Compiz Fusion Mini-How-to.

[Fireblend]

Hello! I decided to do something for society today and make a little how-to on what and how to install the new Compiz Fusion. These are the steps I used to get it working. As you know, ymmv so be careful when following the following steps. Also, as mentioned on the sticky, this isn't for ubuntu newbies, although anyone who can follow directions can do it, really. Also, I'd advice to follow this only if you already have either beryl or compiz installed and using, so you know your graphic card is supported and you don't get the WSOD

Anyway, here it is:


WHAT IS IT?

Well, I think the best way to explain what it is is by watching a video at youtube. Here's a few links:

Video 1 / Video 2 / Video 3

On the other hand, if you feel like a theoric definition, I guess we can use Wikipedia, which states:

"Compiz Fusion is an extension of the Compiz compositing window manager for the X Window System. It was created from the remerging of Beryl into Compiz. It aims to port almost all of the features of Beryl to Compiz plugins, and continue to improve Compiz's core functionality. There has yet to be an official release of Compiz Fusion, but preliminary packages are available."

So it basically means that unless you want to be stuck with your current beryl or compiz effects (and I'm not saying that's a bad option), you're gonna have to switch to Fusion sooner or later. Now, it's among Gutsy's goals to have this included, so if you are a patient human being you can wait. On the other hand, if you feel like upgrading now, follow these pretty simple instructions to get the current version.

Now, the current version is pretty stable (about as much as Beryl from my experience so far), so you don't have to worry about it being to unstable or anything but like any alpha/beta of anything, I can't guarantee you're gonna have the same results as me, so I'm not responsable for whatever might happen to your computer. Anyway, follow the instructions already:


HOW TO INSTALL:

I'm gonna assume we're installing on a fresh install, so most of you (specially if you already have experience installing eyecandy) might already have some steps covered, like getting Trevino's repository, for example. But to help those who might not have it installed, I'm gonna cover all the steps.

STEP 1:

First, we'll be adding Trevino's repositories, which is where we're getting our Fusion copy from. You can also find a lot of other eyecandy software from them, like Avant Window Nav. and Affinity. Anyway, first we go to System->Administration->Software sources and select the "Third-party sources" tab. You're gonna get a listbox and a button that says "add" below it. Click there and paste the following:

deb http://download.tuxfamily.org/3v1deb feisty eyecandy

Now do exactly the same and add this:

deb-src http://download.tuxfamily.org/3v1deb feisty eyecandy

Make sure that the added lines have appeared in the listbox. Done? Now close that window and open up the terminal. Once we're on the terminal, type the following to get the GPG Key for the repositories we just added (You can probably skip this step, but it's best to do this).

sudo wget http://download.tuxfamily.org/3v1deb/DD800CD9.gpg -O- | sudo apt-key add -

Once entered, just wait. If for some reason it seems to be done but the "user@computer:$ " thing doesn't appear, close the terminal and open a new one or just start hitting random keys, for some reason, that happens to me so I thought I'd add that to avoid you waiting centuries for nothing to happen. Anyway, once that's done:

sudo apt-get update

You should notice the two lines we added in the update list. If they're there, so far so good.

STEP 2:

Now we'll install what we need so we can start playing with our new beautiful effects. I should note that most of the following comes from http://forums.opencompositing.org/vi...php?f=14&t=131, so you might as well go there and continue.

Anyway, just type these on a terminal:

sudo apt-get remove compiz-core desktop-effects

sudo apt-get install compiz  # compiz-gnome AND/OR compiz-kde

sudo apt-get install compizconfig-settings-manager # compizconfig-backends-* ?!

sudo apt-get install compiz-fusion-*

If everything got removed / installed correctly, just press alt+f2 and type

compiz --replace

If all went well, congratulations, you now have Compiz Fusion! You can configure it at the System->Preferences menu.


TROUBLESHOOTING:

Alright, now to make this guide kinda useful, I'll add a couple of fixes that might help, feel free to add more in the comments or something.

1. Windows are not moving as smoothly as they used to in Beryl / Compiz.

This happened to me and it took me a while to fix. However, it shouldn't be too difficult. The current move plugin for some reason acts like that, so until they fix it we'll install a replacement plugin which is actually the old move plugin

[UPDATE] Before doing the following, you have to install the following packages from the repos if you don't have them already:

libxslt1.1
libxslt1-dev
compiz-dev


1. Go here: http://forum.compiz.org/viewtopic.php?t=1064
2. Get the douge plugin
3. Untar it anywhere, preferably home so you don't have to navigate too mcuh on terminal.
4. Navigate to the new douge directory and type

make; make install

5. Restart Fusion
6. Go to the configurator and deselect move plugin, select douge.

That should do it, but if you see no change, restart the GUI (ctrl+alt+backspace) to make sure before making sure it's not working.

(Credit goes to Delfick from opencompositing forums for this one)

2. No window borders!

Well actually, I think there are a million possibilities for why this happens, but everytime it happens to me I can fix it with this command. Run it with alt+f2:

emerald --replace &

Well, that's all for now, hope it works out as well for you as it did for me, best of luck!

[smartboyathome]

You should start from metacity to avoid the no window border error. Also, I would suggest using compiz --replace, as if you are using your metacity theme in compiz, that will restore it, and not cause you to have to use Emerald.

[Motoxrdude]

Works with xgl.

[KrazyPenguin]

wget http://download.tuxfamily.org/3v1deb/DD800CD9.gpg -O- | sudo apt-key add -

I believe this command needs to sudo in front of it so it looks like this:
sudo wget http://download.tuxfamily.org/3v1deb/DD800CD9.gpg -O- | sudo apt-key add -

Doing the sudo apt-get udate gave me key errors:
But since I was already logged in the terminal as root I did the wget "part" again and it didn't stall, like the first time. Then the update went perfect.

[Vorian]

you can also add the key by entering this in the terminal

KEY=81836EBF; gpg --keyserver subkeys.pgp.net --recv $KEY && gpg --export --armor $KEY | sudo apt-key add -

[zero244]

Is this new version compiz fusion for fiesty only or can you install it on Edgy. If you can install it on edgy do you us the same repository.

[superyounan1]

AWESOME! its working in my XGL session, whereas the old Compiz did not!

I noticed my wobbly windows were sluggish, so i tried compiling the bouge plugin, but got an error:

make; make install
[: 1: ==: unexpected operator
-e compiling : bouge.c -> build/libbouge.loPackage compiz was not found in the pkg-config search path.
Perhaps you should add the directory containing `compiz.pc'
to the PKG_CONFIG_PATH environment variable
No package 'compiz' found
bouge.c:32:20: error: compiz.h: No such file or directory
bouge.c:47: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveMetadata'
bouge.c:76: error: expected specifier-qualifier-list before 'HandleEventProc'
bouge.c:93: error: expected specifier-qualifier-list before 'PaintWindowProc'
bouge.c:120: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveInitiate'
bouge.c:222: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveTerminate'
bouge.c:264: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveGetYConstrainRegion'
bouge.c:353: error: expected ')' before '*' token
bouge.c:535: error: expected ')' before '*' token
bouge.c:676: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'movePaintWindow'
bouge.c:711: error: expected declaration specifiers or '...' before 'Display'
bouge.c: In function 'moveDisplayInitOptions':
bouge.c:713: error: 'CompOption' undeclared (first use in this function)
bouge.c:713: error: (Each undeclared identifier is reported only once
bouge.c:713: error: for each function it appears in.)
bouge.c:713: error: 'o' undeclared (first use in this function)
bouge.c:715: error: 'MoveDisplay' has no member named 'opt'
bouge.c:717: error: 'CompOptionTypeAction' undeclared (first use in this function)
bouge.c:718: error: 'moveInitiate' undeclared (first use in this function)
bouge.c:719: error: 'moveTerminate' undeclared (first use in this function)
bouge.c:720: error: 'FALSE' undeclared (first use in this function)
bouge.c:722: error: 'CompBindingTypeButton' undeclared (first use in this function)
bouge.c:723: error: 'CompActionStateInitButton' undeclared (first use in this function)
bouge.c:724: error: 'CompAltMask' undeclared (first use in this function)
bouge.c:725: error: 'Button1' undeclared (first use in this function)
bouge.c:726: error: 'CompBindingTypeKey' undeclared (first use in this function)
bouge.c:727: error: 'CompActionStateInitKey' undeclared (first use in this function)
bouge.c:730: warning: implicit declaration of function 'XKeysymToKeycode'
bouge.c:730: error: 'display' undeclared (first use in this function)
bouge.c:730: warning: implicit declaration of function 'XStringToKeysym'
bouge.c:732: error: 'MoveDisplay' has no member named 'opt'
bouge.c:734: error: 'CompOptionTypeInt' undeclared (first use in this function)
bouge.c:739: error: 'MoveDisplay' has no member named 'opt'
bouge.c:741: error: 'CompOptionTypeBool' undeclared (first use in this function)
bouge.c:744: error: 'MoveDisplay' has no member named 'opt'
bouge.c: At top level:
bouge.c:750: error: expected '=', ',', ';', 'asm' or '__attribute__' before '*' token
bouge.c:762: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveSetDisplayOption'
bouge.c:798: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveInitDisplay'
bouge.c:835: error: expected ')' before '*' token
bouge.c:848: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveInitScreen'
bouge.c:873: error: expected ')' before '*' token
bouge.c:891: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveInit'
bouge.c:901: error: expected ')' before '*' token
bouge.c:908: error: expected ')' before '*' token
bouge.c:913: error: expected '=', ',', ';', 'asm' or '__attribute__' before '*' token
bouge.c:919: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveVTable'
bouge.c:941: error: expected '=', ',', ';', 'asm' or '__attribute__' before '*' token
make: *** [build/libbouge.lo] Error 1
[: 1: ==: unexpected operator
-e compiling : bouge.c -> build/libbouge.loPackage compiz was not found in the pkg-config search path.
Perhaps you should add the directory containing `compiz.pc'
to the PKG_CONFIG_PATH environment variable
No package 'compiz' found
bouge.c:32:20: error: compiz.h: No such file or directory
bouge.c:47: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveMetadata'
bouge.c:76: error: expected specifier-qualifier-list before 'HandleEventProc'
bouge.c:93: error: expected specifier-qualifier-list before 'PaintWindowProc'
bouge.c:120: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveInitiate'
bouge.c:222: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveTerminate'
bouge.c:264: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveGetYConstrainRegion'
bouge.c:353: error: expected ')' before '*' token
bouge.c:535: error: expected ')' before '*' token
bouge.c:676: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'movePaintWindow'
bouge.c:711: error: expected declaration specifiers or '...' before 'Display'
bouge.c: In function 'moveDisplayInitOptions':
bouge.c:713: error: 'CompOption' undeclared (first use in this function)
bouge.c:713: error: (Each undeclared identifier is reported only once
bouge.c:713: error: for each function it appears in.)
bouge.c:713: error: 'o' undeclared (first use in this function)
bouge.c:715: error: 'MoveDisplay' has no member named 'opt'
bouge.c:717: error: 'CompOptionTypeAction' undeclared (first use in this function)
bouge.c:718: error: 'moveInitiate' undeclared (first use in this function)
bouge.c:719: error: 'moveTerminate' undeclared (first use in this function)
bouge.c:720: error: 'FALSE' undeclared (first use in this function)
bouge.c:722: error: 'CompBindingTypeButton' undeclared (first use in this function)
bouge.c:723: error: 'CompActionStateInitButton' undeclared (first use in this function)
bouge.c:724: error: 'CompAltMask' undeclared (first use in this function)
bouge.c:725: error: 'Button1' undeclared (first use in this function)
bouge.c:726: error: 'CompBindingTypeKey' undeclared (first use in this function)
bouge.c:727: error: 'CompActionStateInitKey' undeclared (first use in this function)
bouge.c:730: warning: implicit declaration of function 'XKeysymToKeycode'
bouge.c:730: error: 'display' undeclared (first use in this function)
bouge.c:730: warning: implicit declaration of function 'XStringToKeysym'
bouge.c:732: error: 'MoveDisplay' has no member named 'opt'
bouge.c:734: error: 'CompOptionTypeInt' undeclared (first use in this function)
bouge.c:739: error: 'MoveDisplay' has no member named 'opt'
bouge.c:741: error: 'CompOptionTypeBool' undeclared (first use in this function)
bouge.c:744: error: 'MoveDisplay' has no member named 'opt'
bouge.c: At top level:
bouge.c:750: error: expected '=', ',', ';', 'asm' or '__attribute__' before '*' token
bouge.c:762: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveSetDisplayOption'
bouge.c:798: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveInitDisplay'
bouge.c:835: error: expected ')' before '*' token
bouge.c:848: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveInitScreen'
bouge.c:873: error: expected ')' before '*' token
bouge.c:891: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveInit'
bouge.c:901: error: expected ')' before '*' token
bouge.c:908: error: expected ')' before '*' token
bouge.c:913: error: expected '=', ',', ';', 'asm' or '__attribute__' before '*' token
bouge.c:919: error: expected '=', ',', ';', 'asm' or '__attribute__' before 'moveVTable'
bouge.c:941: error: expected '=', ',', ';', 'asm' or '__attribute__' before '*' token
make: *** [build/libbouge.lo] Error 1

[Nezing]

Also had a look at Compiz-Fusion here:

http://news.softpedia.com/news/Beryl...on-57881.shtml

Some people say that "eye candy" should not sell the product alone,but on this evidence,it is a straight five.Woo hoo.
Sorry,I got carried away there.

It will also be pre-installed with Ubuntu 7.10 (Gutsy Gibbon) .

[Stephen Howard]

I just wish I didn't keep reading 'compositing' and 'composting'.

[Stephen Howard]

sudo apt-get remove compiz-core desktop-effects

It says that its going to remove: compiz compiz-core compiz-extra compiz-gtk compiz-plugins desktop-effects ubuntu-desktop

Should I be worried that its going to remove ubuntu-desktop?