Enum Action 

pub enum Action {
    None,
    LeftClick,
    RightClick,
    MiddleClick,
    Copy,
    Paste,
    Cut,
    Undo,
    Redo,
    SelectAll,
    Find,
    Save,
    BrowserBack,
    BrowserForward,
    NewTab,
    CloseTab,
    ReopenTab,
    NextTab,
    PrevTab,
    ReloadPage,
    MissionControl,
    AppExpose,
    PreviousDesktop,
    NextDesktop,
    ShowDesktop,
    LaunchpadShow,
    LockScreen,
    Screenshot,
    PlayPause,
    NextTrack,
    PrevTrack,
    VolumeUp,
    VolumeDown,
    MuteVolume,
    CycleDpiPresets,
    SetDpiPreset(u8),
    ToggleSmartShift,
    ScrollUp,
    ScrollDown,
    HorizontalScrollLeft,
    HorizontalScrollRight,
    CustomShortcut(KeyCombo),
}

What pressing a ButtonId should do.

Serialization uses serde’s default external tagging: unit variants serialize as a bare string ("BrowserBack") and the tuple variant serializes as a single-key table ({ CustomShortcut = "my chord" }).

Stability contract: existing variant names are frozen — they form the on-disk config.toml schema. New variants may be appended freely; removing or renaming a variant requires a schema_version bump and a migration.

Action::execute synthesizes the OS-level event for each variant. On macOS it posts the event via CGEventPost(kCGHIDEventTap, …). On other platforms it logs a warning and returns immediately — the binary compiles on all targets.

Manual verification

execute is intentionally excluded from the automated test suite because it would need to intercept the OS event queue. Smoke-test it manually: bind a button to any action in the GUI and confirm the expected system event fires when the button is pressed.

Variants

None

Suppress the input entirely — the button or wheel direction is captured but no OS event is synthesised, so the physical input does nothing.

LeftClick

Primary mouse button.

RightClick

Secondary mouse button.

MiddleClick

Middle mouse button (wheel click).

Copy

Copy the current selection (⌘C / Ctrl+C).

Paste

Paste from the clipboard (⌘V / Ctrl+V).

Cut

Cut the current selection (⌘X / Ctrl+X).

Undo

Undo the last action (⌘Z / Ctrl+Z).

Redo

Redo the last undone action (⌘⇧Z on macOS / Ctrl+Shift+Z on Linux).

Note: Ctrl+Y is the dominant redo shortcut in LibreOffice and many GTK apps. Ctrl+Shift+Z is used here because it mirrors the macOS convention and works in GNOME text fields, browsers, and Electron apps. If Ctrl+Y coverage is needed, a CustomShortcut binding is the escape hatch.

SelectAll

Select all content (⌘A / Ctrl+A).

Find

Open the find / search bar (⌘F / Ctrl+F).

Save

Save the current document (⌘S / Ctrl+S).

BrowserBack

Navigate backward in browser history.

BrowserForward

Navigate forward in browser history.

NewTab

Open a new tab (⌘T / Ctrl+T).

CloseTab

Close the current tab (⌘W / Ctrl+W).

ReopenTab

Reopen the last closed tab (⌘⇧T / Ctrl+Shift+T).

NextTab

Switch to the next tab (⌃⇥ / Ctrl+Tab).

PrevTab

Switch to the previous tab (⌃⇧⇥ / Ctrl+Shift+Tab).

ReloadPage

Reload the current page (⌘R / Ctrl+R).

MissionControl

macOS Mission Control (⌃↑).

AppExpose

macOS App Exposé — all windows for the current app (⌃↓).

PreviousDesktop

Switch to the previous desktop / Space.

NextDesktop

Switch to the next desktop / Space.

ShowDesktop

Show the desktop (hide all windows).

LaunchpadShow

Open Launchpad.

LockScreen

Lock the screen (⌘⌃Q on macOS).

On Linux, calls org.freedesktop.login1.Manager.LockSession($XDG_SESSION_ID) on the system bus (current session only). Falls back to Super+L when $XDG_SESSION_ID is unset or on non-systemd systems.

Screenshot

Capture a screenshot.

PlayPause

Toggle media play/pause.

NextTrack

Skip to the next track.

PrevTrack

Go back to the previous track.

VolumeUp

Increase system volume.

VolumeDown

Decrease system volume.

MuteVolume

Toggle system mute.

CycleDpiPresets

Step through the configured DPI preset list (P1.7).

SetDpiPreset(u8)

Jump to a specific zero-based preset in the device’s DPI preset list. Out-of-range indices clamp to the list length at fire time (P1.7).

ToggleSmartShift

Toggle the HID++ SmartShift ratchet/free-spin wheel mode (P1.1).

ScrollUp

Synthesise a vertical scroll-up tick.

ScrollDown

Synthesise a vertical scroll-down tick.

HorizontalScrollLeft

Synthesise a horizontal scroll-left tick.

HorizontalScrollRight

Synthesise a horizontal scroll-right tick.

CustomShortcut(KeyCombo)

Replay an arbitrary recorded key chord (P1.3).

Holds the structured chord data so execute can post the real keystroke (macOS: CGEventPost with the encoded modifier flags). The display field is used by Action::label so the popover shows the user-friendly chord name.

Implementations

impl Action

pub fn label(&self) -> String

Display label for the popover row.

Returns String rather than &str so parameterized variants (e.g. SetDpiPreset(i), CustomShortcut(s)) can build a label that includes their payload.

pub fn category(&self) -> Category

Which Category this action belongs to, used for popover grouping.

pub fn catalog() -> Vec<Action>

All pickable actions in a deterministic order.

Action::CustomShortcut is intentionally excluded — it is opened via “Record shortcut…” (P1.3), not selected from the catalog.

pub fn execute(&self)

Synthesise the OS-level event for this action.

On macOS, key events are posted via CGEventPost(kCGHIDEventTap, …) using virtual key codes from the standard US keyboard layout, and the LeftClick/RightClick/MiddleClick variants synthesise a mouse click at the current cursor location. The WindowServer actions (MissionControl, AppExpose, ShowDesktop, LaunchpadShow) are posted straight to the Dock via CoreDockSendNotification. Device-side actions (CycleDpiPresets, SetDpiPreset, ToggleSmartShift) have no CGEvent equivalent and are handled at the hook/HID layer, logging a trace here.

On Linux, key and scroll events are injected via a lazily-created uinput virtual device. Mouse clicks inject BTN_* events. macOS-only window manager actions (MissionControl, AppExpose, ShowDesktop, LaunchpadShow) have no universal Linux equivalent and are silently skipped (debug-logged). CustomShortcut maps macOS kVK_* codes to Linux key codes; macOS Cmd maps to Ctrl.

On other platforms a warning is logged and the function returns immediately — the binary compiles clean on all targets.

Trait Implementations

impl Clone for Action

fn clone(&self) -> Action

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Action

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Action

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Action

impl Hash for Action

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Action

fn eq(&self, other: &Action) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Action

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Action