Differences between revisions 39 and 40
Revision 39 as of 2009-10-24 23:35:30
Size: 5362
Editor: ?MikeBentzen
Comment: Added a section about window management and effects under troubleshooting. Those pages in the troubleshooing section aren't helpful or Not found anymore.
Revision 40 as of 2009-10-25 02:12:34
Size: 5315
Editor: GeoffSimmons
Comment: Drop Compiz.org Nvidia link (superseded by Hardware/NVIDIA on compiz wiki), fix forum link.
Deletions are marked like this. Additions are marked like this.
Line 86: Line 86:
 * [[http://compiz.org/NVidia|Compiz.org Nvidia]]
Line 106: Line 105:
 * [[http://www.compiz.biz|Compiz Community Forum]]  * [[http://forum.compiz.org/|Compiz Community Forums]]

A short introduction about Compiz

From Wikipedia:

"Compiz is one of the first compositing window managers for the X Window System that is able to take advantage of OpenGL-acceleration. The integration allows it to perform compositing effects in window management, such as a minimization effect and a cube workspace. Compiz conforms to the ICCCM standard and as such can substitute for the default Metacity in GNOME or KWin in KDE. Compiz brings some of the features found in competitors, such as Exposé in Apple's Mac OS X and a new Alt-Tab application-switcher, similar to the one found in Microsoft's Windows Vista. Compiz is built on the Composite extension to X and the GLX_EXT_texture_from_pixmap extension to OpenGL. Compiz was released by Novell in January 2006 in the wake of a new Xgl version."

How to install compiz on debian (for lenny or later)

To install a standard gnome based compiz setup with some standard fusion plugins:

apt-get install compiz compizconfig-settings-manager compiz-fusion-plugins-main

To install a standard kde-based compiz setup with some standard fusion plugins:

apt-get install compiz-kde compizconfig-settings-manager compiz-fusion-plugins-main

To install a minimal gtk-based compiz setup:

apt-get install compiz-gtk compizconfig-settings-manager

Add the following options to the corresponding sections in the file /etc/X11/xorg.conf: (although note that auto-detection by xserver-xorg video drivers is always improving: with the latest version of the intel video driver, possibly no manual changes are needed to xorg.conf)

# Dedicated "Extensions" section (may not be present already)
Section "Extensions"
        Option "Composite" "enable"
EndSection
# Section "Device" of you graphic card
Section "Device"
        # Already contains
        # ...
        # Identifier "..."
        # Driver     "..."
        # ...
        # Add this option :
        Option "XAANoOffscreenPixmaps" "true"
EndSection

Nvidia user may also need:

Section "Device"
        Option "AllowGLXWithComposite" "true"
EndSection
Section "Screen"
        Option "AddARGBGLXVisuals" "True"
EndSection
Section "Module"
        #Load "dri"
        #Load "GLcore"
EndSection

Restart your X.org server and login into GNOME. Open a terminal and issue the following command:

compiz --replace

If everything is correct you will be able to use all compiz resources.
You may want to start your compiz automatically with GNOME:
Add "compiz --replace" to "Desktop -> Preferences -> Sessions -> Startup Programs", or

echo "export WINDOW_MANAGER=/usr/bin/compiz" >> ~/.gnomerc

Limitations

The water effect uses GL_ARB_fragment_program, which not currently work properly with the open source ATI drivers under AIGLX in X.org 7.1.

Troubleshooting

When I run compiz --replace, it informs me that XGL is not present. This message is just informing you that XGL is not present. It is not a requirement to run Compiz.

I've followed the instructions on this page, but when I run compiz, all the windows have lost their borders and title bars. There are no effects, and all the windows seem unusable. Window borders, resizing windows and moving windows are all plugins, which are initially disabled by default. To fix this, run the ccsm utility (from a terminal, or System -> Preferences -> ?CompizConfig Settings Manager). Go to the Effects Section and place a tick in the window decoration option. Go to the Window Management section and place a tick in the Resize Window and Move Window options.

If you still encounter problems with compiz, such as window title bars disappear, or cannot see any visual effects, refer to these web pages:

If something fail you could check /var/log/Xorg.0.log and search for possible problems with DRI and GLX. You also should verify if AIGLX was successfully loaded.

Default hot keys

  • Switch desktops on cube: Ctrl + Alt + Left/Right Arrow
  • Switch desktops on cube - with active window following: Ctrl + Shift + Alt + Left/Right Arrow
  • Rotate cube manually: Ctrl + Alt + left-click
  • Zoom-in once: Super-key + right-click
  • Zoom-in manually: Super-key + wheel mouse up
  • Zoom-out manually: Super-key + wheel mouse down
  • Move window: Alt + left-click
  • Slow-motion: Shift + F10
  • Transparency: Put mouse cursor over the window then press Alt + wheel mouse down
  • Expose effect: Ctrl + Alt + Up Arrow or Point the mouse in top right at screen
  • Take screenshot: Super-key + left-click drag