Add support for physical keyboard to the virtual keyboard overlay, to utilize built-in IME, Emoji panel, etc. It can also hides full keyboard in virtual keyboard for easier use for physical keyboard users.
给虚拟键盘添加物理键盘支持，便于使用内置的IME、Emoji面板等。还增加了紧凑模式，隐藏了虚拟键盘中的全键盘，便于使用物理键盘。
Currently only tested with US English keyboard layout and Chinese (Simplified) IME, more testing is needed.
目前仅测试了英文键盘和简体中文输入法，还需要更多测试。
Make sure you have installed Decky Loader first.
请先确保已安装 Decky Loader 。
Download the latest release from Releases and unzip to ~/homebrew/plugins.
从 Releases 下载最新版本，并解压到 ~/homebrew/plugins 。
-
You can click the Space virtual key to leave compact mode temporarily.
-
You can use Space and number keys to accept IME candidates.
-
You can short press LeftShift key to switch between input methods.
-
You can press Escape key to leave the virtual keyboard.
-
可以通过点击 空格 键临时退出紧凑模式。
-
可以通过 空格 和数字键接受输入法候选项。
-
可以通过按住 左 Shift 键切换输入法。
-
可以通过按 Esc 键退出虚拟键盘。
Config can be found in ~/homebrew/plugins/BetterKeyboard/config.json.
配置可以在 ~/homebrew/plugins/BetterKeyboard/config.json 中找到。
{
"blacklist": [...]
}-
blacklist: A list of devices that should not be recognized as physical keyboard (able: name, path, phys or uniq). -
blacklist: 不应当被识别为物理键盘的设备黑名单（可以使用名称、路径、物理路径或唯一标识符）。
This plugin uses the step below to work:
- Hijack the virtual keyboard triggers.
- Modify the keyboard layout.
- Use
evdevto block and receive keyboard events. - Send keyboard events to Steam.
- Map keys to correct actions.
Copyright (c) 2025 Chenx Dust. This project is licensed under the BSD 3-Clause license.
This plugin is using a modified version of gvalkov/python-evdev. I've removed all the CPython part and make it work out-of-the-box.