Latest 0.1.0
Homepage https://github.com/soffes/HotKey
License MIT
Platforms osx 10.9
Frameworks Appkit, Carbon
Authors

Version
Build Status
Swift Version
Carthage compatible
CocoaPods compatible

Simple global shortcuts in macOS. HotKey wraps the Carbon APIs for dealing with global hot keys to make it easy to use in Swift.

HotKey, along with Color, were created for use in Contrast, a macOS app for checking designs for accessible color combinations.

Installation

Carthage

For installation with Carthage, simply add the following to your Cartfile:

github "soffes/HotKey"

Swift Package Manager

For installation with Swift Package Manager, simply add the following to your Package.swift:

.package(url: "https://github.com/soffes/HotKey", from: "0.1.0")

CocoaPods

For installation with CocoaPods, simply add the following to your Podfile:

pod 'HotKey'

Usage

Simply initlaize a HotKey with a key and modifiers:

// Setup hot key for ⌥⌘R
let hotKey = HotKey(key: .r, modifiers: [.command, .option])

This is a convenice initializer that creates a KeyCombo for you. You can also initialize with a Carbon key code and Carbon modifier flags if you’re feeling old school.

Now you can set the keyDownHandler and get callbacks for when your hot key is pressed:

hotKey.keyDownHandler = {
  print("Pressed at (Date())")
}

You can also implement hotKey.keyUpHandler if you’d like.

You don’t need to think about when handlers are registered and unregistered. This all happens automatically based on the HotKey object’s lifecycle.

Thanks

HotKey was heavily inspired by PTHotKey.

Latest podspec

{
    "name": "HotKey",
    "version": "0.1.0",
    "authors": {
        "Sam Soffes": "[email protected]"
    },
    "homepage": "https://github.com/soffes/HotKey",
    "summary": "Simple global shortcuts in macOS.",
    "source": {
        "git": "https://github.com/soffes/HotKey.git",
        "tag": "v0.1.0"
    },
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "platforms": {
        "osx": "10.9"
    },
    "frameworks": [
        "Appkit",
        "Carbon"
    ],
    "source_files": "Sources/HotKey/**/*.{h,m,swift}",
    "pushed_with_swift_version": "4.0"
}

Pin It on Pinterest

Share This