CompizConfig Settings Manager main view

CCSM, short for CompizConfig Settings Manager, is a configuration tool for Compiz Fusion. It is used to configure the many plugins included in Compiz and Compiz Fusion, as well as the use of various profiles and intergrating better with existing desktop settings. CCSM uses the CompizConfig compiz configuration system.

Using CCSM

The main view in CCSM contains a list of the plugins you have installed. To view and edit the settings for a plugin, click on its icon. Hover the mouse over a plugin to view its description.

To enable or disable plugins, check or uncheck the boxes next to them. Most plugins can be separately disabled, but some depend on others. CCSM will inform you if you are about to disable such plugins, or if you need to enable other plugins to provide functionality to the one you enable.



CompizConfig Settings Manager Advanced Search

A search bar at the top left corner allows for quick and easy filtering of the plugin list by matching the text you enter; partial text also works. You can also use this filter box to filter through options when navigating a plugin's page.

The advanced search button on the plugins page allows you to filter through all options of all plugins. It does take a while to load, as all the metadata must be parsed first. When using advanced search, you can find options by name, long description and by what value you have set them to. When entering criteria into the filter, the list of plugins that match that filter will narrow down. By clicking on the plugin, you can see which groups contain the option you have searched for. Clicking on that group will bring you to a filtered options page.


The plugins are divided into 8 categories:

You can choose a category from the list on the left sidebar, if you wish, clicking All to return to the main view.

Changing options

Changing an option in CCSM is fairly intuitive.

Basic configuration


Changing a Keybinding


An action is a function that is called when you press a key, button, hit an edge or have the system bell ring. No two actions can have the same binding, and CCSM will notify you if so and offer you to change to another binding, or disable the one conflicting with the binding you set.


A Keybinding option is an option that has a keyboard icon next to it. To edit a keybinding, you need to specify 'modifiers' by clicking on the Ctrl, Alt, Super and Shift buttons in the window and entering a key. If you just want to press the keys, hit 'Grab Key Combination' and enter in your modifiers and keys. The window will close automatically. If you don't like what you have entered in, you can press Escape and try again.

Mouse Buttons

A Mouse Button option is an option that has a mouse icon next to it.


Changing a mouse button binding

To edit a mouse button you will need to specify 'modifiers' by clicking on the Ctrl, Alt, Super and Shift buttons in a window and/or optionally toggle a screencorner where this action can only happen. To set a screencorner, you will need to click on one of the red areas of the picture of the screen. Finally, select which button to use, you will need to select a button number from the combo box. Below is a list of Button numbers and what they usually correspond to:

Buttons 6-9 can differ depending on the type of mouse you have. Some mice may not even have these buttons at all!

Screen Edges

A screen edge is a type of binding that makes an action occur when you move your mouse to a screen corner or edge. Screen Edge options have a display icon next to them. To set a screen edge simply select one or more of the red areas of the picture of the screen.

System Bell

The System Bell is called when an application or the system wants to notify you about something.By default, the system bell is usually a sound or a beep on most desktop environments.


Setting a Screen Edge

You can also have a function be called when the system bell sounds. System Bell options are options that have a picture of a note next to them. Checking the box calls that function on system bell.

Clearing a setting

To clear a setting back to the defaults, press the broom icon.


The 'Preferences' area allows you to configure CCSM and LibCompizConfig itself, with profile settings, backend settings and plugin list settings.


Profiles allow you to save and switch between different configurations of Compiz Fusion easily, without changing too many settings at once.

Backends and Integration

CompizConfig allows you to write your settings to a specific desktop configuration backend, for better integration with your desktop. The list of current backends are as follows

'Enable integration into the desktop environment' allows you to read and write to and from settings from your desktop's normal window manager. Integrated options are shown in blue.

Plugin List

This allows you to manually add and change the loading order of various plugins. It is recommended that you do not change settings here as they are there for debugging purposes. CCSM will automatically generate the best plugin loading order for you by default.

CCSM (last edited 2008-03-30 18:34:29 by localhost)