%general-entities; ]> $LastChangedBy$ $Date$ openbox-&openbox-version; Openbox Introduction to openbox Openbox is a highly configurable desktop window manager with extensive standards support. It allows you to control almost every aspect of how you interact with your desktop. &lfs70_checked; Package Information Download (HTTP): Download MD5 sum: &openbox-md5sum; Download size: &openbox-size; Estimated disk space required: &openbox-buildsize; Estimated build time: &openbox-time; Openbox Dependencies Required , and (compiled with support for libXft). Optional (to enable icons in the right click menu). User Notes: Installation of Openbox Install Openbox by running the following commands: ./configure --prefix=/usr --sysconfdir=/etc --disable-static \ --docdir=/usr/share/doc/openbox-&openbox-version; && make To test the results, issue: make check. Now, as the root user: make install Command Explanations : This option puts Openbox's configuration files in /etc/xdg/openbox instead of /usr/etc/xdg/openbox. : This option stops it compiling static versions of the libraries. : this puts a few files in a versioned directory in /usr/share/doc. Configuring Openbox Config Files In ~/.config/openbox and /etc/xdg/openbox, menu.xml and rc.xml ~/.config/openbox/menu.xml ~/.config/openbox/rc.xml /etc/xdg/openbox/menu.xml /etc/xdg/openbox/rc.xml Configuration Information Openbox's right click menu is used to launch programs. The menu itself is configured with 2 files, /etc/xdg/openbox/menu.xml and ~/.config/openbox/menu.xml. If ~/.config/openbox/menu.xml doesn't exist then Openbox will copy /etc/xdg/openbox/menu.xml to ~/.config/openbox/menu.xml when it is launched. ~/.config/openbox/menu.xml can be edited with a text editor or you can install Obmenu (requires , PyXML and PyGTK). Many other aspects of Openbox's behaviour are configured with ~/.config/openbox/rc.xml such as what keybindings are used to launch programs or which mouse button launches the main menu. Details of the theme that Openbox applies to window decorations are configured in ~/.config/openbox/rc.xml. You can get a list of the available themes with the command: ls -d /usr/share/themes/*/openbox-3 | sed 's#.*es/##;s#/o.*##' Starting Openbox To automatically start openbox when you start Xorg: echo openbox > ~/.xinitrc Alternatively, use the openbox-session script to launch openbox. It runs another script, ~/.config/openbox/autostart and if that doesn't exist it runs /etc/xdg/openbox/autostart. You can create ~/.config/openbox/autostart and edit it to start any other programs you want running during your Openbox session (eg, a panel or Dbus). Contents Installed Programs Installed Libraries Installed Directories gdm-control, gnome-panel-control, obxprop, openbox, openbox-gnome-session, openbox-kde-session and openbox-session libobrender.so and libobt.so /etc/xdg/openbox, /usr/include/openbox, /usr/share/doc/openbox-&openbox-version; and /usr/share/themes. Short Descriptions gdm-control is a command line tool to send signals to GDM. gdm-control gnome-panel-control is a command line utility to invoke the Gnome Panel run dialog/menu. gnome-panel-control obxprop is a tool for displaying the properties on an x window. It has a similar functionality to xprop, but allows you to see UTF-8 strings as text. obxprop openbox is a standards compliant, highly configurable, window manager. openbox openbox-gnome-session is a script to launch an Gnome session with openbox as your window manager from your ~/.xinitrc. openbox-gnome-session openbox-kde-session is a script to launch an KDE session with Openbox as your window manager from your ~/.xinitrc. openbox-kde-session openbox-session is a script to launch an Openbox session from your ~/.xinitrc. openbox-session libobrender.so contains the functions used by Openbox for theme rendering. libobrender.so libobt.so is the Openbox toolkit library. libobt.so