This tool performs the following with an iOS keyboard:
- Sends an escape key event when the home key is pressed
- The emoji picker is invoked when Control-Command-Space is pressed
Karabiner is unable to do this, in fact Karabiner-Elements-12.1.0 causes this tool not to function.
The easiest way to install is to use Homebrew:
brew install dnicolson/bluetoothkeyboardenhancer/bluetoothkeyboardenhancer
The following command will run the tool automatically:
brew services start bluetoothkeyboardenhancer
Alternatively, you can run bke (or bke& to run in the background) from the terminal.
macOS Catalina has increased the security of keyboard input, the bke binary must now be added to the following panes under Security & Privacy > Privacy:
- Accessibility
- Input Monitoring
brew services restart bluetoothkeyboardenhancer might need to be run after installation.
The Secure Keyboard Entry menu option must be disabled (it is by default).
By default keyboard input is secure, the following command must run to enable bke (useful for vim):
defaults write com.googlecode.iterm2 "Secure Input" 0
- CGEvents are used to trigger some of the key commands, this means apps such as the Xcode Simulator will not respond to the escape key as they listen to the lower IOHID level.
- It seems that keyboards with the Airoha AB1108 integrated SoC produce incorrect values for Control-Command-Up and Control-Command-Space (#4), this gist documents this in more detail.
The following command will manually compile the binary:
clang -framework IOKit -framework Carbon BluetoothKeyboardEnhancer.c -o bke
MIT License.