Openbox is a highly configurable, next generation window manager with extensive standards support.
|branding||No||Enable Gentoo specific branding|
|debug||No||Enable extra debug codepaths, like asserts and extra output. If you want to get meaningful backtraces see http://www.gentoo.org/proj/en/qa/backtraces.xml|
|imlib||No||Adds support for imlib, an image loading and rendering library|
|nls||No||Adds Native Language Support (using gettext - GNU locale utilities)|
|python||No||Install the python xdg files for xdg autostart|
|session||Yes||Yes||Enables support for session managers|
|startup-notification||Yes||Enable application startup event feedback mechanism|
|static-libs||No||Build static libraries|
|svg||No||Adds support for SVG (Scalable Vector Graphics)|
|xdg||No||Install the python xdg files for xdg autostart|
There are four files to consider when configuring Openbox:
Openbox installs these files to /etc/xdg/openbox/. If you want to override them, create your own in ~/.config/openbox/.
To start Openbox you can use a display manager or startx.
If want to use startx and want ConsoleKit support, setup ConsoleKit and create the following file:
The autostart file is the ideal way to execute specific commands and programs when Openbox starts. It makes no difference if you start Openbox using startx or any display manager. Here is an example:
This is the ideal place to export global variables and configure your Openbox environment as appropriate:
rc.xml is used to specify keybindings and mousebindings. It is located in /etc/xdg/openbox or ~/.config/openbox.
The following are the modifiers.
|W||Super (windows) key|
To make a keybinding, you can combine modifiers and a key. They are separated with the '-' sign.
If you want to open xterm with Super-t, you should add the following to the rc.xml:
You can also bind menus. For example, you can bind Openbox right click and middle click menu with the following:
In the above example, the right click menu is bound with Super-x, and the middle click menu is bound with Super-z. It is useful especially if you prefer not to use any panel with Openbox.
Since version 3.5.0 you can have icons next to your menu entries. For this:
1) You must emerge openbox with imlib support: Add USE flag imlib for x11-wm/openbox into you /etc/portage/package.use like this:
2) Add <showIcons>yes</showIcons> in the <menu> section of the rc.xml file.
3) Add in menu.xml icon="<path>" like this: