Xhotkeys - Hotkeys for the X-Window


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

Requeriments

- 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)

To open the graphical configurator run xhotkeys --config:

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 it pressing Esc. To disable the hotkey for this entry, just press BackSpace.

The selected hotkey cannot be already used by another hotkey. On the field Command you don't need to give the complete the path, and it's possible to pass arguments with it.

On startup, xhotkeys will try to open the configuration file for the current user at $HOME/.xhotkeys. Here is 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<br>
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@