If you are looking for a guide to set up older versions of both projects (the current stable versions are 0.6.2/0.6.0) go here.
Although this guide mentions the default settings in Hardy from time to time, it is mostly distribution-independent and should be suitable for every Linux install.
Configure Compiz and its plugins
Ubuntu has some unusual default configurations that makes you miss (among other things) the "infamous" cube.
If you like them, you can, of course, leave them as they are but here are some tips to advance Compiz' configurations. If you don't like them, you will at least get familiar with the settings manager.

CompizConfig Settings Manager
This guide makes use of the CompizConfig Settings Manager (ccsm) provided by the Compiz Fusion project.
So if you do not have it already installed, you need to install it first. On Ubuntu the required package is called compizconfig-settings-manager. In order to install it on Hardy (using Firefox), all you have to do is click here: apt:compizconfig-settings-manager
Now let's start the settings manager via
System → Preferences → Advanced Desktop Effects Settings
Or simply type in the terminal (or [Alt]+[F2]):
ccsm
So don't waste your time looking for the plugins all the time – just type the initial letters in there and it will get much clearer.
Getting the cube
1. Enable the following plugins (by checking the box next to them):
![]() |
Desktop Cube You may have to disable another plugin (just follow the popup) |
![]() |
Rotate Cube This plugin is necessary to spin the cube |
| 2. |
Increase the number of the virtual desktops to 4 at General Options → Desktop Size → Horizontal Virtual Size (the other two options have to be left at 1 – it should look like this then) |
Now we can switch desktops via [Ctrl]+[Alt]+[Left]/[Right] and spin the cube via [Ctrl]+[Alt]+[Left Mousebutton] – hold the mousebutton clicked, then move the mouse around.
Optional cube plugins
![]() |
Viewport Switcher In case you want to change desktops with the mousewheel |
![]() |
Cube Caps Lets you use images on top and bottom of the cube |
![]() |
Cube Reflection Cube on a glossy plane |
![]() |
3D Windows Raises windows above while rotating |
Configuring the Cube
- Change the cube's color
Go to Cube Caps → Appearance → Cube Top/Bottom Color and choose a color for each option that fits best to your wallpaper. - Many transparency-related tweaks and plugins are following below.

Getting windows to wobble
- First of all you obviously have to enable Wobbly Windows
- Then, if you want your panel menu wobble as well, choose Shiver in the dropdown menu at Map Effect in Wobbly Windows
- And you might want to disable Snap Inverted there as well, to prevent windows from adhering to screen edges.

Bind useful plugins to screen corners
Display all active windows at once when moving the mouse pointer to the top right corner of the screen
![]() |
Make sure Scale is enabled and go to its Bindings tab. There you look for the screen icons, click on the button next to Initiate Window Picker For All Windows and choose the top right corner. |
![]() |
Make sure Expo is enabled and choose the top left corner in the Bindings tab under Expo Edge. |
| 1. |
If you enable the Scale Addons and Scale Window Title Filter plugins, it enhances your Scale mode: |
![]() |
|
2. While in Expo mode
- You can change the desktop by right-clicking on a different one
- And you can even drag the windows from one desktop to another

Nicer window switchers
While the default [Alt]+[Tab] window switcher that comes with Compiz is certainly nicer than the one that came with your desktop environment, Compiz Fusion has much nicer ones, which can be initiated via [Super]+[Tab] (with "Super" being the win-key).
![]() |
|
You can bind those to different key combinations, if you like and have three different window switchers at a time (the "usual" one, one of the Shift Switcher ones and the Ring Switcher).
Additionally you can use them for different needs, e.g. the Ring Switcher for the current workspace and a Shift Switcher for all active windows – just set them the way you like in the plugin's Key bindings.

Window Animations
There's nothing particularly wrong with the settings provided by Ubuntu but some of them can get quite annoying and it's always fun to fiddle with that part of Compiz.
All of the following options are located at the Animations plugin.
Reasonable window effects
- Close Animation
Double-click on the first entry ("Glide 2" by default) and pick Zoom in the drop-down menu.
Additionally, double the Duration to 400 (that's obviously not the most reasonable thing to do but it's such a nice effect) - Minimize Animation
Double-click on the first entry ("Zoom" by default) and pick Magic Lamp - Open Animation
Double-click on the first entry ("Glide 1" by default) and pick Glide 2 - Focus Animation (optional)
I don't recommend changing the effect, just increase it's duration to 300 or 400 to actually see the nice effect.
Popular/exciting window effects
Just like in the section before, all of the effects mentioned here can be found in the dropdown menu after you double-clicked the first entry of the respective animation tab.
Also keep in mind to increase the respective Duration to e.g. 400, so you can see the animation in all its glory.
- Close Animation
The most sought after effect is definitely the one where the windows go up in flames when you close them – this effect is called Burn.
Other animations that make people go "awesome" include:Beam Up
If you consider yourself a "Trekkie", this one's definitely for you. Explode Bursts your windows to pieces. Leaf Spread
Similar to Explode but the blocks scatter from top to bottom.
- Minimize Animation
Magic Lamp is pretty much the best effect for this one already.
If you are looking for something incredibly cool (and silly) though, choose Airplane – this folds your window into a paper plane which will then travel to your window list. - Open Animation
Vacuum may be the perfect choice here – this effect "swooshes" the window out of your cursor, it's particularly fitting when opening applications from panel icons.
Other interesting choices would be the cartoonish Dream and the (in this case) "Matrix" like Razr. - Focus Animation
If you're a wobbly fanatic, change the Focus Effect to Wave.
But the most popular (and – if you ask me – annoying) effect here would be Dodge, which will make your windows shuffle.
Transparency
One of the main reasons for me, why I wanted to try Compiz, was the fact that you could have real transparency (and not just the fake one, where you can't see what's actually going on below your window). It's still one of the most impressive effects to me, that you are able to move a transparent window over your desktop and it's like, well, an actual window, where you can look right through.
General transparency tweaks
- Real transparency in the GNOME-Terminal
That's the easiest way to enjoy real transparency, since the GNOME-Terminal already supports it. All we have to do, is open the terminal and go to Edit → Current Profile → Effects and select Transparent background. You can change the level of opacity with the scrollbar, if you like. - Steplessly adjust window transparency
That's a basic feature of Compiz. Just press [Alt] and increase/decrease the level of opacity with the mousewheel while hovering over any window (even the panel). - Transparent panels and menus
Unlike the Xfce panel, the GNOME panel doesn't support real transparency. Therefore we have to adjust this manually:- Go to General Options → Opacity Settings and choose Add. Then in the popup window type dock and for Opacity Window values type 85 (that means the transparency is set to 15% – you can set it higher or lower, of course – but I wouldn't recommend something lower than 75, because icons and the like get transparent too).
- Now that you have a transparent panel, the opaque menus doesn't fit too well. Click on Add again, this time type dropdownmenu and set the transparency the same way as your panel (if you are using the Main Menu, you have to type popupmenu instead of dropdownmenu – this will make your context menus transparent too!)
Window transparency plugins
![]() |
Go to the Move Window plugin and set Opacity to 85. Now the windows get 15% transparent every time you drag them. |
![]() |
The Trailfocus plugin makes windows more transparent the later you last focused them. |
![]() |
If you enable ADD Helper and set Misc. Options → Opacity to 85, all of your windows get 15% transparent except for the focused one (you may want to set the other options to 0). |

Cube related transparency options
Set the cube (semi-)transparent
Set Desktop Cube → Transparent Cube → Opacity During Rotation to 75.0000 (or whatever suits you best)
- Additionally you might want to disable Lighting in
General Options → Display Settings
Transparency related cube plugins
Those plugins make use of the ability to make the cube transparent, to see what's going on inside.
![]() |
Cube Gears Show the cube's engine |
![]() |
Atlantis Turns your cube into a fishtank |
| ∗ | ∗ | ∗ |
There are obviously many other plugins and lots of additional options to explore and we haven't even mentioned the really useful effects like "rain on your desktop" and "setting your screen on fire" (OK, we already had the incredibly important gears) but I guess you should be experienced enough by now to find them yourself – and customizing everything on your own is much more fun.
Troubleshooting
No window boarders (titlebars)
Insert the window decorator of your choice (gtk-window-decorator, kde-window-decorator or emerald) in
CompizConfig Settings Manager → Window Decoration → Command
Additionally for Nvidia users
Make sure you have a nvidia-glx driver installed and use the following command to configure your xorg.conf:
sudo nvidia-xconfig --add-argb-glx-visuals -d 24
(you have to restart X to make it work)
16 Desktops instead of 4 (although configured correctly)
This can happen on KDE, try starting Compiz like this from now on:
compiz --replace --ignore-desktop-hints
Clicking on a window doesn't bring it to the front
Again, this is a known KDE problem
Go to CompizConfig Settings Manager → Preferences and disable Enable integration into the desktop environment
Can't drag windows around
Make sure the Move Window plugin is enabled.
No Cubecaps or Skydome
Make sure the JPEG and/or Png plugin(s) are enabled, depending on the image(s) you want to use.
Trackbacks
No trackbacks, yet.
Not sure what is wrong with Compiz in Hardy. I have an ATI video card. That the drivers loaded without a problem using the Hardware drivers settings. However I can't get any of the compiz features to work. Compiz Fusion doesn't pop any errors when I execute the program.
In case you are on GNOME, try resetting all Compiz settings:
gconftool-2 --recursive-unset -a /apps/compiz
In my ATI Radeon AGP x1650 don`t work compiz fusion...Have crashes when i run compiz...
Great. Exactly the tutorial I was looking for. Clearly written, worked perfectly. Danke.
After a clean install of 8.04 Hardy Heron (64 bit) compiz worked fantastic and smooth with my ATI card out of the box. But after I tried to enable the proprietary driver everything is ruined. Can't run fglrx, Envy failes to install the driver + a manual install also seems to fail me. Each time x resets itself. Now if I try to turn on desktop effects I'm prompted to enable the restricted driver. And I can't enable because it will freeze my desktop and break everything once again. How can I proceed? I would really like to have my awesome Compiz back again.....
When I enable the NVIDIA accelerated graphic driver which is needed for extra effects my screen turns all whitish grey after the boot up screen for ubuntu.
Thanks a ton mate that was really helpful. keep up the good work.
Does anyone know what to enter in Opacity Settings to have Firefox's drop down menus have a transparency?
They are popupmenus like the Main Menu (but as I said in the guide: be aware that context menus will be affected too, so don't set it too low).
Gidday,
This is a really wicked guide.
I just have one weird thing with my pc. It's running an ATI graphics card with the open driver. I run compiz check and it's all good except apparently the resolution is set too high for the card 1400x1050 vs 1024x1024.
However, it mostly runs perfectly when I boot into the failsafe Gnome session.
Any ideas?
Thanks again.
Marc
The open radeon driver should be running Compiz fine but you will have to run Compiz like this:
SKIP_CHECKS=yes compiz
If it works, run this in a terminal:
echo SKIP_CHECKS=yes >>~/.config/compiz/compiz-manager
Brilliant guide, very useful, i now have a much prettier desktop to play around on!
I've got Kubuntu 8.04 with old KDE 3.5 (and I'm not going to upgrade to v.4 yet), i386 / nVidia GeForce MX 440. Got everything Compiz (drivers, compiz, plugins and emerald) installed by the hand, downloading appropriate debs from another computer. Things work fine except that when I try to shutdown my PC ("Log out..." from K Menu) I have only "Log out" button, no Shutdown or Restart or Hibernate or whatever else (I have them with kwin running). Log out button leads to total X hangout. What may be wrong in my system? Any help appreciated. Thanks in advance.
> Do you have Xgl installed?
I can't tell right now, but most probably no, I don't have. I heard that compiz runs well on AIGLX and that modern X.org server ships AIGLX mode by default. Only I needed to install Nvidia GLX. Am I terribly wrong?
The installation guides were so detailed in past times of Edgy, now everything they say is "Check Advanced Desktop Effects checkbox and enjoy"
Sorry, missing Turn off button was not a compiz issue, I found a way to put in back in some ksmservicerc option in my ~/. Yet, sometimes the PC doesn't comletely turn off when I shutdown it. It stops at some last stage and hangs forever, I have to cut power off by the hand. Think, it's a driver issue or something like that, compiz is bleeding killed at this stage of shutdown. Sorry for bothering.
0.7.4 doesn't have Cube Atlantis. I've got 0.7.4-0ubuntu7 installed, and while Cube Gears is there (as always), Cube Atlantis isn't. Isn't that still one of the experimental plugins you have to compile from the Compiz Fusion wiki?
It was there by the time I wrote this How-To. I don't know why they decided to get rid of it in Ubuntu's packages.
But yes, you can compile most additional plugins from source, it's no big deal.
hi, compiz fuzion works fine with me I just follow the instruction above after I installed hardy heron on my laptop, im using Asus A8Hseries Core Duo T280 with GMA 950 gfx
defe rthtykjk,uiikuil;uiiu
Hi! This is a very helpful and comprehensive guide. Thank you very much. I have this page bookmarked as a reference. But I think Video Playback is a useful plugin too not to mention its wicked cool. Unfortunately I haven't been able to make it work. Perhaps you can add a how to on that plugin too.
Wow this helped a LOT! Thank you kind friend. I've found bits and pieces of Compiz documented all over the internet -- There needs to be an effort to make cohesive documentation -- esp. for compiz newbies. (I've got over 2 years linux experience).
I dunno, but compiz is NOT at all intuitve for me. For example to Zoom a window, it says hit the super button (windows key) and button4. Do they mean the #4 key? F4? or the numeric keypad 4?
Just don't know.
Fortunately, logging out/in fixed that problem! Crude, but effective!
Wayno
hi everybody sorry about my english but i have a problem with my configuration, i did all the steps that you gave but i cant rotate my cube and averything, when i try to acces TO ADVANCED DESKTOP EFFECTS SETTINGS nothing change, does anybody can helpme? thank for everything
man you rocked... was looking for something awesome from ubuntu and there you go... simply a lot of difference between windows and linix ..
keep up the good work..
recommend to everyone who want to use Compiz..
Hi, there. I tried compiz with the setteings of your guide on ubuntu jaunty. My machine: hp pavilion tx1270es; 2 x amd64 turion; nvidia Geforce Go 6150. Everything I tried worked perfectly. Very nice guide. I searched and googled net for long before I found this guide - it is THE Guide. Thank you.
Thanks. I've always been wondering how to do all that.
OMG!! This tut is great man! Thanks! I have a cool ass desktop now.
Great guide! Solved my tryst with Compiz.
Nice tutorial. Thanks. I picked up a few missing pieces as a result.
EXCELLENT tutorial!!! Thank you so very much, Forlong, for your efforts! Understanding the different plug-ins and how to enable them and what effects to expect and to top them all, some troubleshooting hints, are really so rare to find in the same tutorial. Keep up the good work please and if you find the time to elaborate more effects please do so. Like myself, I'm sure there are countless newbies who don't know how or where to begin and most of the tutorials have technical jargons that are almost impossible to comprehend. Take care and have fun!!!
can I have Compiz in my pc even if I don't have a powerful video card?
I only have the integrated graphics chip. will that run Compiz?
thanks!
Hey Forlong,I double click on the top entry in close animation but do not see the ,beamup,explode,etc
Im running ccsm 0.8.2
Thx
I TRIED YOUR COMPIZ-CHECK SUCCESSFULLY.
OUTPUT
rendering NONE
I TRIED TO RENDER BY COMMAND IN TREMINAL dpkg -l | grep xgl
AND AGAIN RUN COMPIZ-CHECK
I GET rendering none
PLZ HELP ?



















Ubuntu
Ubuntu forums
Compiz
Compiz Fusion forum
Thank you. Just upgraded from Gutsy with Compiz and Cairo Dock to Hardy. I checked most of the features you describe, but don't have Compiz-effects. I'm on a Travelmate 4001WLMi with a Ati mobility radeon 9700. I think me not having Compiz-effects is related to the driver. I had video-problems when i did the upgrade, so i'm a little hesitant with fiddling around with my video-settings. But any hints are appreciated!