Xhotkeys - Hotkeys for the X-Window


Home | How to use | Download Area | Workspace | Contact

Requeriments

You need the following components to run Xhotkeys:

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

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)

You will have to restart the session. Then open the graphical configurator running xhotkeys --config:

Here you can add new entries, delete them or edit the existing ones. Configuration will be saved on exit.

On the Edit hotkey window you must fill the name and command entries (hotkey may remain disabled). While you are recording a key you can abort pressing Esc. To disable the hotkey for this entry, just press BackSpace.

Names and hotkeys cannot be repeated. On the field Command you don't need to give the complete path (as uses the default environment), and it's possible to pass arguments with it.

Xhotkeys uses a configuration file for each user, which is saved at $HOME/.xhotkeys. If you open it with a text editor, you'll see that it's fair simple to modify manually, let's see an example:

# 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/python2.X/site-packages/Xlib/keysymdef/latin1.py
# /usr/lib/python2.X/site-packages/Xlib/keysymdef/miscellany.py
# Note: remove leading "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@