Skip to main content

FreeKey - Allows limited keyboard use on a locked desktop

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

Metadata

Release files for freekey 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for freekey 0.1.3
File Size Uploaded Provenance
freekey-0.1.3.tar.gz 9.9 kB Without provenance Details

Release files / freekey-0.1.3.tar.gz

Download URL freekey-0.1.3.tar.gz
Size 9.9 kB
Tags Source
SHA-256 checksum
How to use checksums
cbf5ba4723c3bfe2f37926856efdbbde049a808605f336c6c45fa870674b9a74
BLAKE2b-256 checksum
How to use checksums
52d1b0c4354ca8ab63ae10eaf4d4932d2350e2f2a4320484be51045bff4a799a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for freekey 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.3 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page