Struct HotkeyManager 

pub struct HotkeyManager { /* private fields */ }

The main entry point — manages the engine thread and hotkey registration. Public manager API.

Implementations

impl HotkeyManager

pub fn new() -> Result<Self, Error>

Create a manager with backend auto-detection.

Errors

Returns an error if the backend cannot be initialized or input devices are not accessible.

pub fn builder() -> HotkeyManagerBuilder

Configure manager startup options.

pub const fn active_backend(&self) -> Backend

Returns the backend this manager is using.

pub fn register<F>( &self, hotkey: impl Into<Hotkey>, callback: F, ) -> Result<BindingGuard, Error>

where F: Fn() + Send + Sync + 'static,

Register a simple hotkey callback.

Errors

Returns Error::AlreadyRegistered if the hotkey is already bound, or Error::ManagerStopped if the engine has shut down.

pub fn register_with_options( &self, hotkey: impl Into<Hotkey>, action: impl Into<Action>, options: BindingOptions, ) -> Result<BindingGuard, Error>

Register a hotkey with an explicit action and binding options.

Use when you need metadata (description, overlay visibility) or behavioral options beyond what register() provides.

Errors

Returns Error::AlreadyRegistered if the hotkey is already bound, or Error::ManagerStopped if the engine has shut down.

pub fn is_registered(&self, hotkey: impl Into<Hotkey>) -> Result<bool, Error>

Query whether a hotkey is currently registered.

Errors

Returns Error::ManagerStopped if the engine has shut down.

pub fn is_key_pressed(&self, key: Key) -> Result<bool, Error>

Query whether a specific key is currently pressed on any device.

Errors

Returns Error::ManagerStopped if the engine has shut down.

pub fn active_modifiers(&self) -> Result<Vec<Modifier>, Error>

Query the set of modifiers currently held, derived from key state.

Left/right variants are canonicalized: if either LeftCtrl or RightCtrl is held, Modifier::Ctrl is in the returned set.

Errors

Returns Error::ManagerStopped if the engine has shut down.

pub fn define_layer(&self, layer: Layer) -> Result<(), Error>

Define a named layer.

Sends the layer definition to the engine for storage. The layer is not active until explicitly pushed via push_layer().

Errors

Returns Error::LayerAlreadyDefined if a layer with the same name has already been defined, or Error::ManagerStopped if the engine has shut down.

pub fn shutdown(self) -> Result<(), Error>

Stop the manager and join the engine thread.

All registered bindings are dropped. This is also called automatically when the manager is dropped.

Errors

Returns Error::EngineError if the engine thread panicked.

pub fn push_layer(&self, name: impl Into<LayerName>) -> Result<(), Error>

Push a named layer onto the layer stack.

The layer must have been previously defined via define_layer. The pushed layer becomes the highest-priority layer for matching.

Errors

Returns Error::LayerNotDefined if no layer with the given name exists, or Error::ManagerStopped if the engine has shut down.

pub fn pop_layer(&self) -> Result<LayerName, Error>

Pop the topmost layer from the layer stack.

Returns the name of the popped layer.

Errors

Returns Error::EmptyLayerStack if no layers are active, or Error::ManagerStopped if the engine has shut down.

pub fn toggle_layer(&self, name: impl Into<LayerName>) -> Result<(), Error>

Toggle a named layer on or off.

If the layer is currently in the stack, it is removed. If the layer is not in the stack, it is pushed.

Errors

Returns Error::LayerNotDefined if no layer with the given name exists, or Error::ManagerStopped if the engine has shut down.

pub fn list_bindings(&self) -> Result<Vec<BindingInfo>, Error>

List all registered bindings with current shadowed status.

Returns global bindings and all layer bindings (active or not). Each entry includes whether the binding is currently reachable or shadowed by a higher-priority layer.

Errors

Returns Error::ManagerStopped if the engine has shut down.

pub fn bindings_for_key( &self, hotkey: impl Into<Hotkey>, ) -> Result<Option<BindingInfo>, Error>

Query what would fire if the given hotkey were pressed now.

Considers the current layer stack. Returns None if no binding matches the hotkey.

Errors

Returns Error::ManagerStopped if the engine has shut down.

pub fn active_layers(&self) -> Result<Vec<ActiveLayerInfo>, Error>

Query the current layer stack.

Returns layers in stack order (bottom to top).

Errors

Returns Error::ManagerStopped if the engine has shut down.

pub fn conflicts(&self) -> Result<Vec<ConflictInfo>, Error>

Find bindings that are shadowed by higher-priority layers.

Returns conflict pairs: each entry shows the shadowed binding and the binding that shadows it.

Errors

Returns Error::ManagerStopped if the engine has shut down.

Trait Implementations

impl Debug for HotkeyManager

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for HotkeyManager

fn drop(&mut self)

Executes the destructor for this type.