====== How to Edit Keyboard Shortcuts ======

===== Basics =====
Keyboard Shortcuts in Crunchbang are handled through the Openbox window manager. These keyboard shortcuts are referred to as Keybindings. The settings for these shortcuts are saved in the openbox configuration file "rc.xml", which is located in "/home/username/.config/openbox".  This can be accessed through the main menu: Preferences -> Openbox -> Edit rc.xml

For a complete guide, see the [[http://icculus.org/openbox/index.php/Help:Bindings|Help Page at the offical Openbox help wiki]]


===== How to =====

==== Changing Entries ====
Open the configuration file with a text editor.  Search (or scroll down) till you find a section called <keyboard>.
There you will see a list of configuration entries such as, for example: 

    <keybind key="A-F2">
      <action name="Execute">
        <startupnotify>
          <enabled>true</enabled>
          <name>Run Program</name>
        </startupnotify>
        <command>gmrun</command>
      </action>
    </keybind>

The above code generates a keybinding shortcut for Alt-F2 to run program 'gmrun'.

If you look the code, you will find all the basic keyboard shortcuts included by default, such as "Super"(windows key)+W -> Open Web browser, etc that you see on your Conky keyboard shortcuts cheatsheet.  You can easily go through and find most shortcuts already included by name. 

==== Creating Entries ====
If you don't find the shortcut you're looking for already included, then you can create your own.  You must include a set of three tags, plus any additional modifiers you want to include:
  <keybind>
    <action name="name">
      <command>"command"</command>
    </action>
  </keybind>

The action name is chosen from a list of available Openbox commands, available at the official site wiki: [[http://icculus.org/openbox/index.php/Help:Actions]].
==== Other Options ====

  * Keychains

Aside from setting basic keyboard shortcuts, you can set up the ever-handy [[http://icculus.org/openbox/index.php/Help:Bindings#Key_chains|Keyboard-chains]]. These allow you to set up quick chain-commands for keystrokes to greatly accelerate your actions. 

  * Mouse settings

You can also set up configuration for the [[http://icculus.org/openbox/index.php/Help:Bindings#Mouse_bindings|mouse bindings]].

===== Guides / Other Links =====
  * **Best Guide:** For an excellent guide, check out this [[http://urukrama.wordpress.com/2008/07/22/my-openbox-keybindings/|article on keyboard shortcuts]] at Urukrama's absolutely fantastic[[http://urukrama.wordpress.com/openbox-guide/|guide to Openbox]].  

  * **How to Temporarily switch keyboard shortcuts: ** From the forums: [[http://crunchbanglinux.org/forums/topic/1535/temporarily-switch-keyboard-layouts-in-openbox-resolved/|How to Temporarily switch keyboard shortcuts]]

  * **How to configure special keys for laptops:** From the forums - [[http://crunchbanglinux.org/forums/post/14556/#p14556|How to configure special keys for laptops]]

  * **Howto easily handle windows only by keyboard:** ... and another useful thread: [[http://crunchbanglinux.org/forums/topic/563/howto-easily-handle-windows-only-by-keyboard/|Howto easily handle windows only by keyboard]]







===== (Wiki page - todo) =====

Need:
  * more external links
  * internal links set up to/from other pages
  * add to possible wiki page for a [[http://crunchbanglinux.org/wiki/howto/start|complete list of howto's]]