Skip to main content

osxmmkeys is a simple Python library for handling media keys on OS X. Key presses can be observed with no side effects, or have their default behaviours overridden entirely.

Installation

To install osxmmkeys with pip, use:

$ pip install osxmmkeys

Usage

Simple example:

import osxmmkeys

def handler():
    print("Play/pause key was pressed")

tap = osxmmkeys.Tap()
tap.on('play_pause', handler)
tap.run()

Threaded example:

import osxmmkeys, time

def handler():
    print("Play/pause key was pressed")

tap = osxmmkeys.Tap()
tap.on('play_pause', handler)
tap.start()

try:
    while True:
        time.sleep(1)
except (KeyboardInterrupt, SystemExit):
    tap.stop()

Supported key names:

  • play_pause

  • next_track

  • prev_track

  • mute

  • volume_down

  • volume_up

  • backlight_down

  • backlight_up

  • kb_backlight_down

  • kb_backlight_up

Metadata

Release files for osxmmkeys 1.0.1

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

Source distribution (sdist)

Source distribution for osxmmkeys 1.0.1
File Size Uploaded
osxmmkeys-1.0.1.tar.gz 3.7 kB Details

Release files / osxmmkeys-1.0.1.tar.gz

Download URL osxmmkeys-1.0.1.tar.gz
Size 3.7 kB
Tags Source
SHA-256 checksum
How to use checksums
bf2ee690ad85ab6a2c646a464ebcae3ab61bfd1a820021e373b2e98651f9daf5
BLAKE2b-256 checksum
How to use checksums
a55659d27e33b4164dd8eb09089112b7c692b9351454dfed4b88c00b6c340c42
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.22.0 requests-toolbelt/0.9.1 tqdm/4.62.1 CPython/3.8.10

Release history Release notifications | RSS feed

This release

1.0.1 This release

1 release file

1.0.0

1 release file

0.0.4

1 release file

0.0.3

1 release file

0.0.2

1 release file

0.0.1

1 release file

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