hammerspoon2-docs
    Preparing search index...

    Class HSHotkey

    Object representing a system-wide hotkey. You should not create these objects directly, but rather, use the methods in hs.hotkey to instantiate these.

    Index

    Constructors

    Properties

    callbackPressed: (() => void) | null

    The callback function to be called when the hotkey is pressed, or null to remove it

    callbackReleased: (() => void) | null

    The callback function to be called when the hotkey is released, or null to remove it

    callbackRepeat: (() => void) | null

    The callback function to be called repeatedly while the hotkey is held down, or null to remove it. Repeats at the system keyboard-repeat delay/interval, matching how held-down keys repeat elsewhere in macOS.

    key: string

    The key this hotkey was bound with, as originally passed to bind()/create()

    message: string | null

    An optional description of what this hotkey does, or null if none was set. When set, it is shown as an on-screen toast via hs.ui.alert() (duration controlled by hs.hotkey.alertDuration) just before the hotkey's callback runs: before the pressed callback if one exists, otherwise before the released callback if one exists.

    mods: string[]

    The modifier keys this hotkey was bound with, as originally passed to bind()/create()

    Methods

    • Disable and permanently remove this hotkey, releasing all associated resources

      Returns void

    • Disable the hotkey

      Returns void

    • Enable the hotkey

      Returns boolean

      True if the hotkey was enabled, otherwise False

    • Check if the hotkey is currently enabled

      Returns boolean

      True if the hotkey is enabled, otherwise False