Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 

MediaKeyTap

MediaKeyTap provides an API for accessing the Mac's media keys (play/pause, next and previous) in your Swift application. MediaKeyTap will only capture key events when it is the most recently activated media application, matching the behaviour of existing applications, such as those using SPMediaKeyTap.

MediaKeyTap builds its whitelist by combining the static whitelist from SPMediaKeyTap with a dynamic whitelist built at runtime using NSDistributedNotificationCenter. If you create a new application using this library, you should not need to add your bundle identifier to the whitelist.

Usage

Create a MediaKeyTap:

@NSApplicationMain
class AppDelegate: NSObject, NSApplicationDelegate {
    

    var mediaKeyTap: MediaKeyTap?

    func applicationDidFinishLaunching(aNotification: Notification) {
        mediaKeyTap = MediaKeyTap(delegate: self)
        mediaKeyTap?.start()
    }

    
}

and implement MediaKeyTapDelegate's 1 method:

func handle(mediaKey: MediaKey, event: KeyEvent) {
    switch mediaKey {
    case .playPause:
        print("Play/pause pressed")
    case .previous, .rewind:
        print("Previous pressed")
    case .next, .fastForward:
        print("Next pressed")
    }
}

You can also access the KeyEvent to access the event's underlying keycode, keyFlags and keyRepeat values.

The MediaKeyTap initialiser allows the keypress behaviour to be specified:

    MediaKeyTap(delegate: self, on: .keyDown) // Default
    MediaKeyTap(delegate: self, on: .keyUp)
    MediaKeyTap(delegate: self, on: .keyDownAndUp)

Requirements

  • In order to capture key events globally, your application cannot be sandboxed or you will not receive any events.

Installation

CocoaPods

Add pod 'MediaKeyTap' to your Podfile and run pod install.

Then import MediaKeyTap.

Carthage

Add github "nhurden/MediaKeyTap" to your Cartfile and run carthage update.