Help:Configuration

From Openbox

(Difference between revisions)
Jump to: navigation, search
m
Line 9: Line 9:
 
</resistance>
 
</resistance>
 
</pre>
 
</pre>
'''strength''' tag tells Openbox how much resistance(in pixels) there is between two windows before it let's them overlap. <br>
+
'''strength''' tag tells Openbox how much resistance(in pixels) there is between two windows before it lets them overlap. <br>
 
'''screen_edge_strength''' tag is basically the same as ''strength'' tag but between window and the screen edge.
 
'''screen_edge_strength''' tag is basically the same as ''strength'' tag but between window and the screen edge.
  

Revision as of 18:30, 4 April 2010

Openbox configuration is made essentially by modifying just one file called rc.xml. Default configuration file should be found from /etc/xdg/openbox/ and user specific file should be placed in ~/.config/openbox/. By default there is also menu.xml which is for menu configuration. Menu configuration is separated from rest of the configs for clarity but it is not necessary. rc.xml is separated into 11 different sections. All the options are discussed below with examples.


Contents

Resistance

<resistance>
  <strength>10</strength>
  <screen_edge_strength>20</screen_edge_strength>
</resistance>

strength tag tells Openbox how much resistance(in pixels) there is between two windows before it lets them overlap.
screen_edge_strength tag is basically the same as strength tag but between window and the screen edge.

Focus

<focus>
  <focusNew>yes</focusNew>
  <focusLast>yes</focusLast>
  <followMouse>no</followMouse>
  <focusDelay>200</focusDelay>
  <raiseOnFocus>no</raiseOnFocus>
</focus>

When focusNew tag is set to 'yes' Openbox will automatically give focus to new windows when they are created, otherwise the focus will stay as it is.
focusLast
followMouse tag will make focus follow mouse. e.g. when mouse is being moved the focus will always be given to window under the mouse cursor.
focusDelay tag only applies if followMouse is also set. focusDelay is time(in milliseconds) how much Openbox will wait before giving focus to the window under mouse cursor.
raiseOnFocus causes window being raised to top when given focus.

Placement

<placement>
  <policy>Smart</policy>
</placement>

policy can be either Smart or UnderMouse.

  • Smart will cause new windows to be placed automatically by Openbox.
  • UnderMouse makes new windows to be placed under the mouse cursor.

Theme

<theme>
  <name>Clearlooks</name>
  <titleLayout>NLIMC</titleLayout>
  <keepBorder>yes</keepBorder>
  <animateIconify>yes</animateIconify>
  <font place="ActiveWindow">
    <name>sans</name>
    <size>8</size>
    <weight>bold</weight>
    <slant>normal</slant>
  </font>
  <font place="InactiveWindow">
    <name>sans</name>
    <size>8</size>
    <weight>bold</weight>
    <slant>normal</slant>
  </font>
  <font place="MenuHeader">
    <name>sans</name>
    <size>9</size>
    <weight>normal</weight>
    <slant>normal</slant>
  </font>
  <font place="MenuItem">
    <name>sans</name>
    <size>9</size>
    <weight>normal</weight>
    <slant>normal</slant>
  </font>
  <font place="OnScreenDisplay">
    <name>sans</name>
    <size>9</size>
    <weight>bold</weight>
    <slant>normal</slant>
  </font>
</theme>

name tag is the name of the Openbox theme being used.

titleLayout tells in which order and what buttons should be on window's titlebar. Following letters can be used, each only once.
(thumbnail)
titleLayout example using <titleLayout>MSLDNI</titleLayout>
(thumbnail)
another titleLayout example using <titleLayout>CLIM</titleLayout>
  • N :window icon
  • L :window label (aka. title)
  • I: iconify
  • M: maximize
  • C: close
  • S: shade (roll up/down)
  • D: omnipresent (on all desktops).

keepBorder tells if window should keep the borderline drawn by Openbox when using decorate option.
animateIconify adds a little iconification animation if enabled.

Personal tools