global-hotkey

global-hotkey is a Rust library from the Tauri project for registering system-wide keyboard shortcuts in desktop applications. It lets you bind key combinations that fire even when your application does not have focus, and delivers press and release events through a simple channel-based receiver.

It supports Windows, macOS, and Linux (X11) through platform-specific backends, exposing a portable HotKey type built on modifiers and key codes. As part of the Tauri ecosystem, it integrates naturally with desktop apps that need media keys, launcher shortcuts, or other global bindings.

What You Get

• A GlobalHotKeyManager for registering and unregistering shortcuts
• A portable HotKey type built from Modifiers and key Codes
• Channel-based GlobalHotKeyEvent delivery for press and release
• Cross-platform backends for Windows, macOS, and Linux X11
• Optional serde and tracing feature integrations

Common Use Cases

• Adding global media or launcher shortcuts to a desktop app
• Triggering actions while the application is in the background
• Building quick-capture or overlay tools bound to a hotkey
• Integrating system-wide shortcuts into a Tauri application

Under The Hood

Architecture - The public API lives in lib.rs and hotkey.rs, exposing GlobalHotKeyManager, HotKey, and the GlobalHotKeyEvent receiver, while platform_impl holds the per-OS implementations selected at compile time. Events are pushed onto a crossbeam-channel that application code drains via GlobalHotKeyEvent::receiver, decoupling OS callbacks from the app’s own loop.

Tech Stack - Rust (2021 edition, rust-version 1.77) with crossbeam-channel for event delivery, keyboard-types for portable key codes, once_cell for the global receiver, and thiserror for errors. macOS uses objc2 and objc2-app-kit bindings; Windows and Linux X11 have their own gated backends. Optional serde and tracing features add serialization and instrumentation.

Code Quality - The crate is maintained under the tauri-apps organization with a CHANGELOG, renovate-managed dependencies, and examples demonstrating registration and event handling. Platform code is cleanly isolated in platform_impl, and errors are modeled explicitly via thiserror, though it relies on manual/example testing rather than a large automated suite.

API Design - The API is concise and ergonomic: build a HotKey from modifiers and a code, register it with the manager, and poll the event receiver. The main constraints are platform requirements documented in the README, notably that the manager must be created on the thread running the event loop (the main thread on macOS).