Xhotkeys - Hotkeys for the X-Window


Main How to use Download Area
Workspace  Contact

Requeriments

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 tRun xhotkeys --config

Xhotkeys configuration

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 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 selected Hotkey cannot be used by another hotkey. On the field Command you don't need to spicfy the path, and it's possible to pass arguments.


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@