/hotkeyd

Uber-small hotkey daemon for GNU/Linux. Fork of keyd by Benjamin Bolton

Primary LanguageObjective-CGNU General Public License v3.0GPL-3.0

hotkeyd

Hotkeyd is a tiny daemon which runs in the background and executes commands tied to certain keypresses in the config file.

Based on keyd developed by Benjamin Bolton.

CHANGES

  • no -c/--config flag: su uses /etc/hotkeyd.conf; others use ~/.config/hotkeyd.conf
  • removed the systemd shit
  • logging is now deprecated
  • renamed to hotkeyd

LICENSE

hotkeyd is licensed under the GNU General Public License version 3 (GPLv3) more info

COMPILING

To build simply run

make

To change the compiler use the CC variable

make CC=g++

INSTALLING

To install simply run

sudo make install

To change to root dir for installing (e.g. for building a binary package), use the DESTDIR variable, e.g.

sudo make DESTDIR=pkg/ install

UNINSTALLING

To uninstall simply run

make uninstall

Note: This makes use of the DESTDIR variable

CONFIGURING

The default configuration script is located at "/etc/hotkeyd.conf".

The format of this file is:

<KEYS> <COMMAND>

where is a list of modifiers and a key seperated by a '+', e.g.:

F1          <command when F1 pressed>
LEFTCTRL+F1 <command when Control-F1 pressed>

You can use hotkeyd --test to get a list of key names

RUNNING

the Makefile will install daemon packages for initscripts.

To start the daemon using initscripts run as root:

/etc/rc.d/hotkeyd start

and to stop it run as root:

/etc/rc.d/hotkeyd stop

To enable it to run at startup add hotkeyd to the DAEMONS array of /etc/rc.conf

hotkeyd can also be run indepently of the daemon scripts by running hotkeyd, see hotkeyd --help for information on usage

THANKS

  1. To Benjamin Bolton for sharing the source code of keyd.