Differences between revisions 17 and 64 (spanning 47 versions)
Revision 17 as of 2006-11-28 04:56:35
Size: 4028
Editor: ?ZhaoDifei
Comment: mystically missing word
Revision 64 as of 2018-01-30 12:04:39
Size: 6726
Comment: Add Compiz-devel link
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
#language en
~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: English - [[it/Compiz|Italiano]] - [[ru/Compiz|Русский]] -~
----

 '''Warning: The information in this page may be outdated (as of 2017-10). If you review and update the page, please remove this warning. Thanks! '''

This page is for users, the page for developers is on [[Compiz-devel]]
Line 2: Line 10:
Line 7: Line 14:
''"...Compiz works with modifications on the standard X.Org server, with AIGLX enabled. With AIGLX, Intel cards can also be used with Compiz. Even mobile cards work there."'' == How to install Compiz on Debian 6.0 "Squeeze" ==
Line 9: Line 16:
In September 2006, X.org 7.1 (AIGLX merged) and Compiz were accepted into Debian unstable and further into testing. It is currently maintained by the Debian X Strike Force.

== Debian compiz + AIGLX HOWTO ==

First, you should verify if your video card is supported. Check the list of supported cards below (on other cards, Compiz would need Xgl):

 * Intel i830 through i945 graphic cards
 * ATI Radeon cards up to X800 series
 * NVIDIA graphic cards are supported in the 9xxx-series proprietary driver

We will need to fetch some packages from testing or unstable, so point Debian official Unstable repository in your "/etc/apt/sources.list". (deb [http://ftp.debian.org] main unstable) and "apt-get update".

Install the following packages:

 xserver-xorg xserver-xorg-core libglitz1 libglitz-glx1 libdrm2 libgl1-mesa-dri libgl1-mesa-glx compiz compiz-core compiz-plugins compiz-gtk compiz-gnome mesa-utils

Add the following options to the corresponding sections in the file `/etc/X11/xorg.conf`:
To install a standard gnome based compiz setup with some standard fusion plugins:
Line 28: Line 19:
Section "ServerLayout"
        Option "AIGLX" "true"
EndSection
# apt-get install compiz compizconfig-settings-manager compiz-fusion-plugins-main compiz-gnome compiz-gtk
}}}
Line 32: Line 22:
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
}}}

In order to use compiz add the following options to the corresponding sections in the file {{{/etc/X11/xorg.conf}}}: (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)
Line 35: Line 41:
# Section "Device" of you graphic card
Line 37: Line 43:
        # Already contains
        # ...
        # Identifier "..."
        # Driver "..."
        # ...
        # Add this option :
Line 40: Line 52:

Nvidia user may also need:
Nvidia users may also need:
Line 47: Line 58:
Line 49: Line 59:
        Option "AddARGBGLXVisuals" "True"         Option "AddARGBGLXVisuals" "true"
Line 51: Line 61:
Line 57: Line 66:
Line 63: Line 71:
If everything is correct you will be able to use all compiz resources.
Line 64: Line 73:
If everything is correct you will be able to use all compiz resources.
[[BR]]
You may want to start your compiz automatically with GNOME:
[[BR]]
Add "compiz --replace" to "Desktop -> Preferences -> Sessions -> Startup Programs".
You may use the !CompizConfig Settings Manager to enable effects and configure keybinding (run ccsm from a terminal, or System -> Preferences -> !CompizConfig Settings Manager).
Line 70: Line 75:

== Start compiz instead of the default Gnome Window Manager ==
Change the gconf key with
{{{
gconftool-2 --type string --set /desktop/gnome/session/required_components/windowmanager compiz
}}}
You can go back to the default Gnome Metacity window manager with
{{{
gconftool-2 --type string --set /desktop/gnome/session/required_components/windowmanager gnome-wm
}}}
If this fails (as it did for me) You can simply add compiz --replace to your startup applications. Name the entry what you want, give it whatever description you want, but make the command
{{{
compiz --replace
}}}
Line 71: Line 90:

The water effect uses GL_ARB_fragment_program, which not currently work propely with the open source ATI drivers under AIGLX in X.org 7.1.
The water effect uses GL_ARB_fragment_program, which currently does not work properly with the open source ATI drivers under AIGLX in X.org 7.1.
Line 76: Line 94:
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. '''When I run compiz --replace, it says that XGL is not present.'''
This message is just informing you that XGL is not present. It is not a requirement to run Compiz.

'''glxinfo claims that DRI is active, yet software rendering kicks in'''
If you see issues similiar to those in [[http://lists.debian.org/debian-user/2012/02/msg00894.html|this post]], especially when using the proprietary nvidia driver, try to disable the additional options in your xorg.conf, i. e. revert it to

{{{
$ cat /etc/X11/xorg.conf
Section "Device"
 Identifier "Configured Video Device"
 Driver "nvidia"
EndSection
}}}
'''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:'''

 * [[http://bgoglin.livejournal.com/11253.html|Where are Compiz shiny effects?]]
 * [[http://wiki.compiz-fusion.org/Hardware/NVIDIA|Hardware/NVIDIA - Compiz Fusion Wiki]]
 * [[http://technowizah.com/2006/10/debian-how-to-aiglx-compiz.html|Technowizah-Debian howto-AIGLX compiz]]

If something fails check /var/log/Xorg.0.log and search for possible problems with DRI and GLX. You also should verify if AIGLX was successfully loaded.
Line 79: Line 122:
Line 91: Line 133:
Line 93: Line 134:

 [http://wizah.blogspot.com/2006/10/debian-how-to-aiglx-compiz.html Debian HOW-TO : AIGLX + Compiz]
 * [[http://technowizah.com/2006/10/debian-how-to-aiglx-compiz.html|Debian HOW-TO : AIGLX + Compiz]]
 * [[http://www.compiz.org|Compiz Official page]]
 * [[http://forum.compiz.org/|Compiz Community Forums]]
 * [[http://nixser.com/2007/06/04/debian-compiz-on-kde-installation-how-to/|Debian: Compiz on KDE Installation How-To]]
----
CategoryObsolete

Translation(s): English - Italiano - Русский


  • Warning: The information in this page may be outdated (as of 2017-10). If you review and update the page, please remove this warning. Thanks!

This page is for users, the page for developers is on Compiz-devel

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 6.0 "Squeeze"

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

# apt-get install compiz compizconfig-settings-manager compiz-fusion-plugins-main compiz-gnome compiz-gtk

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

In order to use compiz add the following options to the corresponding sections in the file /etc/X11/xorg.conf: (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 users 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 use the CompizConfig Settings Manager to enable effects and configure keybinding (run ccsm from a terminal, or System -> Preferences -> CompizConfig Settings Manager).

Start compiz instead of the default Gnome Window Manager

Change the gconf key with

gconftool-2 --type string --set /desktop/gnome/session/required_components/windowmanager compiz

You can go back to the default Gnome Metacity window manager with

gconftool-2 --type string --set /desktop/gnome/session/required_components/windowmanager gnome-wm

If this fails (as it did for me) You can simply add compiz --replace to your startup applications. Name the entry what you want, give it whatever description you want, but make the command

compiz --replace

Limitations

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

Troubleshooting

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

glxinfo claims that DRI is active, yet software rendering kicks in If you see issues similiar to those in this post, especially when using the proprietary nvidia driver, try to disable the additional options in your xorg.conf, i. e. revert it to

$ cat /etc/X11/xorg.conf
Section "Device"
        Identifier      "Configured Video Device"
        Driver          "nvidia"
EndSection

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 fails 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


CategoryObsolete