Crate openlogi_hook 

OS-level mouse-event hook for OpenLogi.

Platform	Implementation
macOS	CGEventTap (same primitive used by Logi Options+)
Linux	evdev grab + uinput re-injection
Windows	WH_MOUSE_LL low-level mouse hook

Usage

use openlogi_hook::{Hook, MouseEvent, EventDisposition};

if !Hook::has_accessibility() {
    eprintln!("grant Accessibility access first");
    return;
}

let hook = Hook::start(|event| {
    println!("{event:?}");
    EventDisposition::PassThrough
}).unwrap();

// … later, on shutdown:
hook.stop();

Structs

EventDevice

Best-effort identity for the physical device that produced an OS event.

EventTapInfo

A live event tap installed somewhere in the system, as reported by Hook::list_event_taps. Read-only diagnostic snapshot — enumerating taps needs no Accessibility grant and any process in the session sees them all.

Hook

A running OS-level mouse hook. Call Hook::stop to tear down.

Enums

ButtonId

One of the user-rebindable hotspots on a Logi mouse. The order matches the physical layout from front to side; ButtonId::ALL is consumed by the default-binding generator and the popover trigger list.

EventDisposition

What the hook callback wants the OS to do with the captured event.

HookError

Errors that Hook::start and related functions can produce.

MouseEvent

An event captured at the OS layer.

TapLocation

Where in the event stream a tap is inserted (macOS CGEventTapLocation).

Functions

frontmost_bundle_id

Return an opaque string identifying the currently frontmost application.