OroboROX User Manual

Introduction

OroboROX is a window-manager and nothing else. It has no panel/taskbar,
desktop icons or root-menu. OroboROX is meant to be used with ROX-Filer,
which provides all these. While OroboROX is currently quite generic,
this might change in the future. We're planning uncompromising ROX
Desktop integration.

OroboROX features a capable pixmap theme engine, mostly backwards
compatible with Xfm4, which has a few enhancements not yet available in
OroboROX. Easily portable are also themes created for OroborOSX, the
window-manager Apple ships with MacOS X (X11.app). Thus a wealth of
themes is readily available from the start. 24 high-quality themes are
included in this distribution.

Title fonts are freely configurable. The title may be centered, left
aligned or right aligned. Button layout is also freely configurable. 
Color schemes may be defined independent from the themes. There is lots
of settings that can be changed by right- clicking the OroboROX icon and
choosing 'Options...'

OroboROX is fully keyboard controllable. Shortcuts can be freely defined
in the options.

Mouse buttons

Some window title buttons have extra functions when clicked with
mousebutton 2 or 3:

  Minimize: Button 3 toggles Shaded
  Sticky:   Button 3 toggles OnTop
  Close:    Button 3 does hard kill of client (use with care)
  Maximize: Button 2/3 does Vertical/Horizontal maximize

ScrollWheel on window title shades/unshades.

Button 3 or 2 (configurable in Options) on window title lowers and moves
the window, while the other one moves the window without changing its
stacking order.

Some functions are also available by holding down the
Window-ops-modifier key (default is Ctrl+Alt) while clicking or
dragging with the mouse somewhere inside the window:

  Button 1: raise and move
  Button 2: raise and resize
  Button 3: lower and move

Theme and Scheme AppDir's

Themes and Schemes are packaged as AppDir's and are relocatable.
To create a Theme-AppDir, just put your theme in a dir and copy
LoadTheme.sh to AppRun and make it executable, and put a .DirIcon
preview image and an AppInfo.xml file as usual... Same thing for
Schemes, but use LoadScheme.sh instead. 
OroboROX themes consist of a number of bitmap graphics elements (tiles)
in XPM format. These are the four corner pieces,  the three elements 
which form the left, right and bottom of the frame, and the titlebar 
made of five elements, to allow for fancy and assymetrical themes.
Each frame element must be provided for the active and inactive state.
When you want an element to look similar in both states, you achieve this
by copying or symlinking the pixmap file to the proper name.
OroboROX supports five types of titlebar buttons with three distinct states 
– the active and inactive states like with the other frame elements, plus 
the pressed state. Again you can use the copying or symlinking trick, if you
don't intent to make these states visually distinct.

Supported Button Types: