Actions are used to specify the behavior of Openbox. Actions are used in both keyboard and mouse bindings.

Actions

As discussed in the keyboard and mouse bindings guide, actions are used inside these bindings. You can put more than one action in a row in any binding to have it perform more than one action.

Here are a couple examples of actions, with and without parameters:

<keybind key="A-Tab">
  <action name="NextWindow"/>
</keybind>
<keybind key="A-S-Tab">
  <action name="PreviousWindow"/>
</keybind>
<keybind key="C-A-Tab">
  <action name="NextWindow">
    <panels>yes</panels><desktop>yes</desktop>
  </action>
</keybind>

Syntax

The full syntax for an action is:

<action name="NAME">OPTIONS</action>

If you are not setting any parameters, you can use this (but don't forget the trailing "/" !):

<action name="NAME" />

Name

The NAME is the name of the action, which specifies which action to run. See the list of actions to see what names are possible.

Options

The OPTIONS are 0 or more options for the given action, that change how the action will behave. Each action has its own options, and some don't have any. See the list of actions to see the options available to each action.

Options are specified such as this:

<action name="NAME">
  <option1>value</option1>
  <option2>value</option2>
  ...
</action>

List of actions

Global actions

These actions are not used to manipulate windows. As such, they work whether a window is currently focused or not.

Execute

Runs a program