Namespace keycodes

Access information about the current keyboard layout and input sources, and respond to changes.

Reading the current layout

console.log("Layout: " + hs.keycodes.currentLayout())
console.log("Source ID: " + hs.keycodes.currentSourceID())
Copy

Key code mapping

// Look up a keycode by name
const code = hs.keycodes.map["a"]    // e.g. 0 on ANSI US
// Look up a name by keycode
const name = hs.keycodes.map["0"]   // e.g. "a"
Copy

Switching layouts

hs.keycodes.setLayout("British")
Copy

Watching for input source changes

hs.keycodes.addWatcher(() => {
   console.log("Switched to: " + hs.keycodes.currentLayout())
})
Copy