Personal tools
You are here: Home Team Members Scott Glaser AKA Sonar_Guy Compiz-Fusion with Fusion Icon

Compiz-Fusion with Fusion Icon

by scott_glaser last modified Jan 10, 2010 10:37 PM

Compiz Fusion is the "cool desktop effects" most notably the Cube that most of you have seen in a screenshot or videos all over the Internet. Fedora comes with a version called Desktop Effects, simply compiz, however is does not have all the features of compiz-fusion. You can take a look at it under System -> Preferences -> Look and Feel -> Desktop Effects. Now if you want to use all the effects, plugins, etc . . . this is the post for you to follow.

Applicable to Fedora Versions

  • Fedora versions 11+


  1. You must have an active internet connection.
  2. For nVidia Cards follow this link to include the requirements section.
  3. For ATI Video Cards follow this link to include the requirements section.

Doing the Work

The compiz-fusion packages are found in Fedora repositories. To install them perform the following:

  1. Open a Terminal.
  2. Enter the following into the terminal:
    su -c 'yum remove compiz'

    At the password prompt, enter the password for the root user then press enter.  This will remove the current version of compiz installed on your system.

  3. As your user, enter the following into the terminal:
    rm -rf ~/.gconf/apps/compiz

    Then press enter.  This removes the default settings for compiz from the previously installed version.

  4. Enter the following into the terminal:
    su -c 'yum install compiz-fusion compiz-fusion-gnome compiz-fusion-extras compiz-fusion-extras-gnome compiz-manager gnome-compiz-manager ccsm fusion-icon fusion-icon-gtk emerald emerald-themes'

    At the password prompt, enter the password for the root user then press enter.  This installs the pacakages that include all the compiz bells and whistles including the emerald theme.

  5. Auto start

    For GNOME:
    Go to System -> Preferences -> Personal -> Sessions and click Add. Then enter the following information in the Edit Statup Program window

    Name: Fusion Icon
    Command: fusion-icon
    Comment: Compiz Fusion panel applet

    Then press Save, then in the Sessions Preferences window select Close.

    For KDE:
    Enter the following into the terminal:
    ln -s /usr/bin/fusion-icon ~/.kde/Autostart/fusion-icon
    Then press enter.
  6. Logout and then back in. Now you should see a blue icon in your tray.
  7. Right click on it and go to Select Window Manager -> Compiz. You can leave the default Window Decorator or select emerald through Select Window Decorator -> Emerald. If you click on Settings Manager, ccsm will run and you can configure compiz fusion as you like.

What you should see on startup

  1. When Compiz starts with Compiz Fusion Icon, you should see window borders and be able to move windows around by dragging the titlebars.

  2. When Compiz Fusion starts by itself (through the compiz --replace ccp command, for example), you may not see any window borders, but you should still be able to move the windows around by holding down the Alt key and dragging them with the left mouse button. You will notice that they are "wobbly".

  3. If you start Compiz by itself without specifying a configuration plugin on the command line, you will not be able to move or resize windows. To check whether Compiz is running, open two windows and see if you can switch between them by clicking on the windows. If you can, that means Compiz is running but no plugins are loaded. You will need to start Compiz with the name of a configuration plugin on the command line, such as ccp, gconf, kconfig, or ini. If this still doesn't work, you may have a plugin ABI version mismatch, and you will need to re-compile your plugins.

  4. If you don't see window borders, can't move windows around by Alt-dragging, and can't switch between windows, you most likely couldn't start Compiz. See below for potential problems and solutions.


More Information

Any additional information or notes.


We test this stuff on our own machines, really we do. But you may run into problems, if you do, come to #fedora on

Added Reading

Document Actions
Log in

Forgot your password?
New user?