====== Configuring Keybindings ======

By default Crunchbang makes good use of keybindings, many of these can be seen in the [[conky|Conky]] window on the right of you screen.
Keybindings are defined in the ~/.config/openbox/rc.xml file.
it can be accessed from the menu in Preferences --> Openbox Config --> Edit rc.xml.

===== Adding your own tags =====

You will find the keybindings section about a 1/4 of the way down within the ''<keyboard></keyboard>'' tags, they will look something like this:
<code>
    <keybind key="W-t">
      <action name="Execute">
        <command>terminator</command>
      </action>
    </keybind>
</code>

<code>
<keybind key="W-t">
.....
</keybind>
</code>

The keybind tags surround a new keybinding, and also define the key combination, in this case the Windows/super key and 't'.

<code>
<action name="Execute">
....
</action>
</code>

The action tags define what to do, in this case execute something.

<code>
<command>terminator</command>
</code>

And finally the command tags define what to execute, in this case [[terminator]], CrunchBangs default terminal.

You can simply add your own by copying an existing keybinding and editing the relevant details or you can simply change the key combo, or command of an existing keybinding. 

Commands work in the same way as on the terminal, you don't need an '&' suffix like you do in the [[howto/autostart_programs|autostart]] file.

The official openbox documentation has details on all the options
[[http://openbox.org/wiki/Help:Bindings|Openbox Keybindings]].
which even include documentation on bindings for [[http://openbox.org/wiki/Help:Bindings#Mouse_bindings| mice]].

===== Finding Key Names =====
Many PCs will have special keys, such as volume keys, to get their name follow this [[xev-determine_custom_keybindings|guide]].

this information can be used as your keybind key eg: 
<code>
<keybind key="XF86AudioRaiseVolume">
</code>

===== Some useful keybindings =====

Configure any volume keys you may have:
<code>
    <keybind key="XF86AudioRaiseVolume">
      <action name="Execute">
        <command>amixer sset Master,0 5+</command>
      </action>
    </keybind>
    <keybind key="XF86AudioLowerVolume">
      <action name="Execute">
        <command>amixer sset Master,0 5-</command>
      </action>
    </keybind>
    <keybind key="XF86AudioMute">
      <action name="Execute">
        <command>amixer sset Master,0 toggle</command>
      </action>
    </keybind>
</code>

===== Other Useful Options =====

In openbox its possible to chain key combinations together, similar to Emacs, (not to put you off :))[[http://openbox.org/wiki/Help:Bindings#Key_chains|Key chains]]

===== Links =====
  * [[howto/keyboard_settings]], For settings such as keyboard delay and repeat rate.
  * [[http://openbox.org/wiki/Help:Bindings|Official Openbox documentation Keybindings section]]
  * [[http://openbox.org/wiki/Help:Actions| More official info on actions keybindings]]
  * [[http://crunchbanglinux.org/forums/topic/1411/keyboard-switching-in-openbox-greek-and-english-crunchbang-linux/|CrunchBang Forums: Temporarily switch keyboard layouts]]
  * [[http://crunchbanglinux.org/forums/topic/563/howto-easily-handle-windows-only-by-keyboard/| For fans of ratpoison or anyone else that just wants to control their window manager with their keyboard]]
  * [[http://crunchbanglinux.org/forums/topic/3165/howto-configure-your-multimedia-keys-for-exaile/|CrunchBang forums: configure multimedia keys for various music players]] 
  * [[http://crunchbanglinux.org/forums/topic/961/configuring-shortcuts-easy-way-to-configure-special-keys-for-laptops/|Crunchbang forums general laptop keybindings]]
  * [[http://crunchbanglinux.org/forums/post/4957/#p4957|Another link for configuring a super key]], and a [[http://crunchbanglinux.org/forums/topic/3077/super-key-windows-key-keyboard-shortcuts-on-a-laptop/|link]] on possible issues.

===== Platform specific Links =====

  * [[http://crunchbanglinux.org/forums/topic/1745/crunchbang-on-the-samsung-nc10/| Samsung NC10]] 
  * [[http://crunchbanglinux.org/forums/topic/3101/howto-change-your-super-key-windows-key-to-alt-or-cntl/|Workarounds for laptops with no windows/super key]]
  * [[http://crunchbanglinux.org/wiki/howto/aspireone#hotkeys| Acer Aspire 1]]
  * [[http://crunchbanglinux.org/forums/topic/1642/hp-pavilion-volume-buttons/|HP Pavillion volume keys]]
  * [[http://crunchbanglinux.org/forums/topic/2136/howto-install-crunchbang-810-on-ibm-thinkpad-t22/|Thinkpad T22 possible windows/super key fix]]