Requirements

You need the following components to run Xhotkeys:

- X-Window system (XFree86 or Xorg)
- Python 2.4
- Python-Xlib and Python-GTK2

Setup

You have to configure your destkop environment to run Xhotkeys at startup. For example, with GNOME you will do:

- System-> Preferences -> Sessions
- StartUp Programs -> Add
- StartUp Command: xhotkeys (order: 50)

GNOME Session configuration

At this point, you should restart the session.

Hotkey configuration

Run xhotkeys --config
Xhotkeys configuration

Add new entries, delete them or edit existing ones. Configuration will be saved on exit.

On the 
Edit hotkey window you must fill the name and command entries (hotkey can be disabled). While you are in recording mode (after Change Hotkey was pressed), you can abort it pressing Esc. To disable the hotkey for this entry, just press BackSpace.

The fields Name and Hotkey cannot be used by another hotkey. The field Command uses the default environment, so it's not necessary to write the full path.


Edit hotkeys

There is a configuration file for each user located at $HOME/.xhotkeys. If the user has not this configuration file, the one located at /etc/xhotkeys.conf will be used. 

# Configuration file for xhotkeys

# You can edit this file by hand, but it's easier to
# use the GTK+ graphical configurator: xhotkeys --config.

# Syntax:
# name=<modifier1>[<modifier2>]...[<modifierN>]key:command

# Allowed modifiers are "alt", "control", "altgr" and "winkey"

# Some keynames are obvious, others are not, take a look at this files:
# /usr/lib/python@VERSION@/site-packages/Xlib/keysymdef/latin1.py
# /usr/lib/python@VERSION@/site-packages/Xlib/keysymdef/miscellany.py
# Note: remove heading "XK_" from keynames. For instance: XK_F1 -> F1

# example:
# calculator=<control><alt>F2:xcalc

calc=<winkey>c:gnome-calculator
terminal=<alt>Return:gnome-terminal
k3b=<winkey><control>k:k3b
poweroff=<shift><control><alt>p:poweroff
gaim=<control><alt>g:gaim

Last modified: @DATE@