Sauce

Sauce

Mapping various keyboard layout sources and key codes in macOS. (e.g.: QWERTY, Dvorak)

Motivation

Only the ANSI-standard US keyboard is defined for the key code defined in Carbon.framework. Therefore, we can obtain only the key code of the QWERTY keyboard layout. (e.g.: kVK_ANSI_V)
In layout other than QWERTY, (e.g. Dvorak) the virtual key code is different.

Keyboard Layout	Key	Key Code
QWERTY	v	9
Dvorak	v	47

This library is created with the purpose of mapping the key code of the input sources and making it possible to obtain the correct key code in various keyboard layouts.

Example

Key codes

Get the key code of the current input source.

let keyCode = Sauce.shared.keyCode(for: .v)

Key

Get the Key of the current input source.

let key = Sauce.shared.key(for: keyCode)

Character

Get the character of the current input source.

let character = Sauce.shared.character(for: keyCode, modifiers: .carbon(shiftKey))
let character = Sauce.shared.character(for: keyCode, modifiers: .cocoa([.shift]))

Notification

NSNotification.Name.SauceEnabledKeyboardInputSourcesChanged

SauceEnabledKeyboardInputSourcesChanged is the same as kTISNotifyEnabledKeyboardInputSourcesChanged in Carbon.framework

NSNotification.Name.SauceSelectedKeyboardInputSourceChanged

SauceSelectedKeyboardInputSourceChanged is different from kTISNotifySelectedKeyboardInputSourceChanged and is notified only when the input source id has changed.
Since it is filtered and notified, please do not use it for the same purpose as normal kTISNotifySelectedKeyboardInputSourceChanged.

NSNotification.Name.SauceSelectedKeyboardKeyCodesChanged

By using this Notification, can detect when the setting changes with the same keyboard layout, when the input source changes from QWERTY to Dvorak, and so on.