Help:Configuration

From Openbox

(Difference between revisions)
Jump to: navigation, search
(New page: 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 ...)
 
Line 28: Line 28:
 
   <policy>Smart</policy>
 
   <policy>Smart</policy>
 
  </placement>
 
  </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.
+
'''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>
 +
  <titleNumber>yes</titleNumber>
 +
  <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.<br>
 +
'''titleLayout''' tells in which order and what buttons should be on window's titlebar. Following letters can be used, each only once.
 +
*N :window icon
 +
*L :window label (aka. title)
 +
*I: iconify
 +
*M: maximize
 +
*C: close
 +
*S: shade (roll up/down)
 +
*D: omnipresent (on all desktops).

Revision as of 05:06, 25 May 2007

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 let's 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>
  <titleNumber>yes</titleNumber>
  <keepBorder>yes</keepBorder>
  <animateIconify>yes</animateIconify>
  
    <name>sans</name>
    <size>8</size>
    <weight>bold</weight>
    <slant>normal</slant>
  
  
    <name>sans</name>
    <size>8</size>
    <weight>bold</weight>
    <slant>normal</slant>
  
  
    <name>sans</name>
    <size>9</size>
    <weight>normal</weight>
    <slant>normal</slant>
  
  
    <name>sans</name>
    <size>9</size>
    <weight>normal</weight>
    <slant>normal</slant>
  
  
    <name>sans</name>
    <size>9</size>
    <weight>bold</weight>
    <slant>normal</slant>
  
</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.

  • N :window icon
  • L :window label (aka. title)
  • I: iconify
  • M: maximize
  • C: close
  • S: shade (roll up/down)
  • D: omnipresent (on all desktops).
Personal tools