This is script to install experimental plugins tailored for use with Ubuntu 9.04 - 10.10, compiz version 0.8.x. For those using any other version than 0.8 this script should not be used.
If you're not sure which version of compiz you have installed, you can use the following command to find out.
- Code: Select all
compiz --version
Intrepid:
If it returns 0.7.x or previous versions, you should upgrade compiz. However, the old guides still exist: see this post.
For those who are using Ubuntu 9.04, 9.10, 10.04 or 10.10 and would like to install additional experimental plugins not provided in the official repositories, this is a script to do just that. NOTE: compiz-fusion-plugins-unsupported is no longer in the official ubuntu repos as of 9.10 release. This script includes the plugins that were provided by this package. As of 10.04, compiz-fusion-plugins-extra is not installed by default so the script installs it as well.
Here we assume that:
1) You have a fresh install of Ubuntu.
2) You have the default version of compiz working (0.8).
2) You are running in a bash shell environment.
3) You are running as user and not root.
Compiz-Fusion is installed by default in Ubuntu and will run as long as you have a video card with appropriate drivers installed and properly configured. Installing drivers is beyond the scope of this writing, but there are plenty of guides to configure your graphics card. See the Hardware page on the Compiz Wiki for more information.
New: Added icons for all plugins (thanks coz
)Without further ado, here is how to get and use the script:
1) Install git-core
- Code: Select all
sudo apt-get install git-core
2) Download the script
- Code: Select all
git clone git://anongit.compiz.org/users/soreau/scripts
3) Run it
- Code: Select all
./scripts/compiz-addons-0.8
If you have already downloaded the script set but want to get the latest changes, go to the scripts directory in your terminal and update it
- Code: Select all
git pull
Remember, run it as user, never use sudo or run as root. It will prompt for password for two things. 1) to install dependencies and 2) to install the icons. The plugins will be installed to ~/.compiz and the source code will be placed in ~/src/compiz/plugins but the icons must be installed to /usr/share/ccsm/icons/hicolor/scalable/apps which is owned by root. In short, run the script as user and it will prompt for password if needed. Here are a few examples of how to use it.
Use it to compile the plugins:
Examples:
Installing a plugin
- Code: Select all
~/scripts/compiz-addons-0.8 install snow
Removing a plugin
- Code: Select all
~/scripts/compiz-addons-0.8 uninstall atlantis
List all available
- Code: Select all
~/scripts/compiz-addons-0.8 --list
Help with usage
- Code: Select all
~/scripts/compiz-addons-0.8 --help
Install all plugins the script supports
- Code: Select all
~/scripts/compiz-addons-0.8 install all
Remove all installed plugins
- Code: Select all
~/scripts/compiz-addons-0.8 uninstall all
Alternatively you can run the script without any arguments and it will go through the list of plugins, prompting action for each in the list.
After using the script:
Restart compiz and ccsm so the plugin will be loaded internally by compiz and it will show up in ccsm. To do this:
Press Alt+F2 and in the run dialog type 'compiz --replace' without tick marks and press enter.
Restart ccsm by simply closing and restarting the ccsm window. (System>Preferences>CompizConfig Settings Manager)
If there are any problems, please ensure you have followed all instructions and typed all commands correctly. Otherwise, post any problems or suggested changes in this thread. For irc support, join #compiz on irc.freenode.net.
Enjoy
