Last revision : April 23th, 2007
With the recent release of Beryl 0.2, the Beryl Project appears stronger then ever.
Folks using Debian have a good reason to be happy about that: a new Debian repository of Beryl packages has recently been unveiled.
This tutorial aims to explain in a clear and concise manner the installation and configuration of a Beryl enabled Debian desktop.
The whole process has been tested on Debian Etch, but should work just as well in Debian Sid. As always, I use sudo to get root privileges.
First, you need either an Intel, ATI, or NVIDIA video card. Regarding both ATI or NVIDIA cards, the proprietary drivers must be properly installed and configured (ie direct rendering enabled). If you need help about that, please refer to the appropriate tutorials (the ATI or the NVIDIA one).
The next step is to ensure that your /etc/X11/xorg.conf configuration file is rightly set up. As the requirement regarding this point are same as for Compiz, please refer to this article for a more in depth explanation.
Very briefly I will state them.
In Section "Modules", have
in first position.
The Section "Devices" needs this line:
Option "XAANoOffscreenPixmaps" "true"
in last position.
Also, make sure that a Section "Extensions" with this content:
Option "Composite" "Enable"
NVIDIA users have a few extra requirements.
In Section "Devices", those lines are required:
Option "AllowGLXWithComposite" "true"
Option "TripleBuffer" "true"
Finally, the Section "Screen" must includes those entries:
Option "AddARGBGLXVisuals" "true"
If you were using Compiz, I recommend uninstalling it, to avoid any potential conflicts:
sudo apt-get remove --purge compiz compiz-gtk compiz-core compiz-gnome compiz-plugins
For this point on, the rest of the process is extremely straight forward. Simply add the Beryl repository to your /etc/apt/sources.list file:
deb http://debian.beryl-project.org etch main
deb-src http://debian.beryl-project.org etch main
It is to be noted that an equivalent Ubuntu repository exists: http://ubuntu.beryl-project.org/
Then make sure the PGP key is part of your trusted sources:
wget http://firstname.lastname@example.org -O- | sudo apt-key add -
And update the repositories:
sudo apt-get update
Finally you can actually install Beryl. Of course, remember to first uninstall Compiz (if you were using it).
GNOME or Xfce folks can use this command:
sudo apt-get install beryl emerald
which will fetch and set up Beryl, along with the Emerald themes manager.
Beside the default emerald, other themes managers exist : aquarine (KDE style) and heliodor (mimics GNOME).
That's it! The last step involves adding beryl-manager to your desktop environment startup script, so that it replaces your default window manager. Again, make sure you erase any prior entry related to Compiz, as the two will not sail along smoothly.
In GNOME, go in Desktop -> Preferences -> Sessions and choose the Startup Programs tab. Simply add an entry for Beryl:
Just create a file ~/.kde/Autostart/beryl.desktop with this content :
Just edit the file /usr/share/desktop-base/profiles/xdg-config/xfce4-session/xfce4-session.rc and replace xfwm4 with beryl-manager :
It's all over! You can enjoy the advanced eye candy feature of this thing of beauty called Beryl.