Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Allows limited keyboard use on a locked desktop

Project description

Overview

Monitors key presses system-wide and runs custom commands in response to certain key presses.

This script was initially designed to allow the multimedia keys to still function despite the desktop being locked, since the default behavior in some Gnome configurations disable all special function keys when locked.

Installation

sudo apt-get install python-xlib
sudo pip install https://github.com/chrisspen/freekey/zipball/master
sudo freekey install

Usage

Modify /etc/freekey.conf to associate events with shell commands.

Each line is of the form <event> <command>, where <event> is either a key name or scan code, and <command> is an arbitrary shell command.

To find a key’s name or code, run freekey echo and press the key.

To purge it from your system run:

sudo freekey uninstall
sudo pip uninstall freekey

Project details


Release history Release notifications

This version
History Node

0.1.3

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
freekey-0.1.3.tar.gz (9.9 kB) Copy SHA256 hash SHA256 Source None Oct 3, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page