padmate v1.1.0

下载

• 国内也能下载：https://padmate.download/ （打开即下载最新安装程序）
• 校验：padmate-v1.1.0-windows-amd64-setup.exe 的 SHA-256 是 f1e5cc2a309b7018c80d1877b5c088bebbf14b2266bf7cabba2c081674c86121

变化

• 支持 Switch 2 的 Joy-Con（Joy-Con 2）：padmate 自己通过蓝牙连接，不用在 Windows 里配对。在“设置”或托盘菜单里选“连接新的 Joy-Con 2”，按住 Joy-Con 2 侧面的 SYNC 键即可连上。连过的会被记住，以后按住 SYNC 就自动连接；“设置”里可以关掉“自动连接记住的 Joy-Con 2”，也可以忘记某一只。映射页用 Switch 2 Joy-Con 的模型，右手那只的 C 键可以映射。推荐 Windows 11，Windows 10 上也能用，但延迟更大。
• 一只左、一只右的 Joy-Con 同时连着时，自动合成一个完整手柄；其中一只断开，另一只马上单独可用。初代 Joy-Con 和 Joy-Con 2 不会混在一起合成。
• 单只 Joy-Con 一律按竖握使用：左手那只有方向键、摇杆、L、ZL、−、截图键、SL、SR；右手那只有 A、B、X、Y、摇杆、R、ZR、+、SL、SR（Joy-Con 2 还有 C 键）。
• 手柄图按手柄实际有的键显示标签：PS4、PS3 手柄用 DualShock 4 的外形，Joy-Con 用 Joy-Con 的外形。PlayStation、Switch Pro 和 Joy-Con 的附加键（截图键、静音键、C 键、背键等）可以映射。
• Joy-Con 的手柄图重新排布：引线改成折线，互不交叉；一对时不显示两只合在一起按不到的 SL、SR。
• 功能键、反馈（震动、灯光、暂停提示、低电提醒）和紧急暂停改成按手柄分别设置，在“设置”的“手柄设置”里。各类手柄的功能键：
  • Xbox、PlayStation、Switch Pro 等默认 Menu，可选 View。
  • 一对 Joy-Con 默认 −，可选 +。
  • 单只左手 Joy-Con 默认 ZL，可选 L；单只右手默认 ZR，可选 R。
• 单只 Joy-Con 的紧急暂停默认是同时按住 SL 和 SR，一对是 − 和 +。
• 修复：配置文件正被别的程序读着时，保存偶尔提示“保存失败”。

注意

• 单只 Joy-Con 以前按横握读，现在只有竖握，按键和以前不同。以前给单只 Joy-Con 设的映射对不上了，要重新设置；脚本里按横握写的单只 Joy-Con 按键也要改。
• Joy-Con 的功能键不再沿用旧的全局设置：单只默认 ZL 或 ZR，一对默认 −。
• 功能键、反馈开关和紧急暂停改成按手柄设置后，旧的全局设置升级后照常生效：
  • 功能键只对 Xbox、PlayStation、Switch Pro 这类标准布局的手柄生效。
  • 反馈开关对所有手柄生效。
  • 紧急组合按手柄类型生效。
• 第一次在“手柄设置”里做改动时，旧的全局设置会转存到每只手柄自己的设置里，再从全局设置中去掉，各手柄的行为不变。只有升级后连接过的手柄会转存，所以请先把常用的手柄都连一次再改；之后才第一次连接的手柄，用它这一类的默认值。
• 配置文件里给单只 Joy-Con 存的功能键（如背键、Menu、View）、含手柄没有的键的紧急组合，以及旧的 Joy-Con 竖握紧急组合项，读入时会忽略并给出警告，改用默认值；配置文件其余部分照常生效。
• Joy-Con 2 不能震动，灯也只显示编号，所以“震动”“灯光”和键的“触感”对它没有效果。“手柄映射向导”和“重新映射…”也不支持 Joy-Con 2。
• 不要在 Windows 的蓝牙设置里添加 Joy-Con 2，已经添加的请删掉。Joy-Con 2 和 Switch 2 之间的配对不受影响：要在主机上用，按一下 SYNC 键断开电脑即可。

padmate v1.0.4

下载

• 国内也能下载：https://padmate.download/ （打开即下载最新安装程序）
• 校验：padmate-v1.0.4-windows-amd64-setup.exe 的 SHA-256 是 3a37504a4a238f11251e4f7f0ef1f6276f14cd74013627a196004afa9b9954a5

变化

• 安装程序先让你选界面语言（简体中文或 English），选的就是装好后的默认语言；在“设置”里自己选过语言的，覆盖安装不会改掉。静默安装可以加 --language=zh-CN 或 --language=en。
• 安装程序多了一个“在桌面创建快捷方式”的勾选框，默认勾上；静默安装加 --no-desktop-shortcut 不建。
• 自带一套 CLIP STUDIO PAINT 的配置“CSP”。全新安装后第一次启动时加入配置库，并加上打开 CSP 时自动切换到它的规则。库里已有同名配置、或已有 CSP 的规则时不加；删掉以后不会再加回来。
• 不再使用 Xbox 键（PS 键、Home 键）：它会被手柄固件（长按关机、组合键重置）、Steam 和 Xbox Game Bar 抢走。功能键只能选 Menu 或 View，Xbox 键也不能映射，脚本和紧急组合里也不能用它。
• 按键的“功能”名称跟着映射走：删掉映射时名称一起删，没有映射的键不能起名；摇杆的“旋转”格不再用“方向键”“旋钮”“鼠标”当默认名称。
• 去掉了“重命名按键”，键名一律按手柄上印的字显示。
• 文档公开到仓库：使用指南、设计文档和决策记录，英文为主，另有中文版。

注意

• 设置里把功能键选成 Xbox 键的，升级后按 Menu 处理，下次保存设置时改写；Menu 原来的映射在它当功能键时不生效。
• 配置文件里给 Xbox 键写的映射不再执行，校验时给警告，界面下次保存这个配置时去掉。
• 只有名称、没有动作的键，映射页会显示警告。配置文件里的“重命名按键”（controlNames）不再显示，界面保存时去掉。
• 脚本里用 Xbox 键（pad.on('guide', …) 等）会报错，pad.isDown('guide') 总是 false。
• 紧急组合里含 Xbox 键的，改用内置的紧急组合，并给出警告。

padmate v1.0.3

下载

• 国内也能下载：https://padmate.download/ （打开即下载最新安装程序）
• 校验：padmate-v1.0.3-windows-amd64-setup.exe 的 SHA-256 是 a36e20da4df33c7f9a235dc5c1fbe38607e4fa20b611216f13b32090188cee09

变化

• 更新和下载改走 padmate.download，国内不用访问 GitHub。从这一版起，padmate 的“检查更新”读下载站。
• 按键图标换成通用的图标：面键、十字键、肩键、扳机、中间几个键和摇杆都按你连的手柄（Xbox、PlayStation、任天堂）显示。图标取自 Kenney Input Prompts（CC0）和 PromptFont（SIL OFL 1.1），许可在“设置 → 关于与许可”。
• 摇杆的标签分成上下两格：上格“旋转”管推动，可以起名字；下格“点按”管按下摇杆，和别的键一样设置。
• 摇杆的方向模式只留“四方向”“旋钮”“鼠标”；旋钮的顺时针、逆时针一格只录一个快捷键。
• 十字键的上下左右就是四个独立的键，抽屉里不再有十字键设置。
• “添加映射”改叫“添加其他动作”，“添加下一步”改叫“增加动作序列”；配置卡片的编辑和复制改成图标按钮。

注意

• 给摇杆起了名字的配置，用 1.0.3 之前的版本打开会报错。
• 配置文件里给摇杆写了 8 方向、只有斜向，或给十字键写了 4 方向、8 方向的，照常生效，只是界面里不能再改。

padmate v1.0.2

padmate 把游戏手柄变成键盘快捷键控制台：画画时左手握手柄，按键就是你常用的快捷键。只支持 Windows 10/11 x64。

这一版来自 1.0 的验收：按键设置做了减法，打开、关闭和选键都更顺手。

这次的改动

• 双击托盘图标打开窗口；安装时在桌面建快捷方式。
• 只有一个功能键：默认是 Menu，在“设置 → 通用 → 功能键”里可以换成 View 或 Xbox 键。选 Xbox 键时，按对话框的提示在 Windows 里关掉 Game Bar 对这个键的响应。映射页上方是“平时 / 按住功能键”。
• 按键设置更简单：每个键只有点按、长按、双击三种映射，动作是快捷键或脚本；序列只有快捷键和等待。“发送方式”“连发”“输入文字”这些选项去掉了，配置文件里已经写了的照常生效。
• 录入快捷键：点输入框或“录入快捷键”就开始，按到键就结束，不用再点确认；鼠标键和滚轮也能录；按住 Esc 1 秒取消。
• 配置：“新建配置”只填名字，建一个空白配置；每张卡片上有“复制”。起始模板和“基于另一个配置”去掉了，文件里写了 extends 的照常有效。
• 映射向导开着时，不论 padmate 的窗口在不在前台，映射都暂停。
• 关掉窗口后，界面留在后台，再打开时立即显示，手柄模型不用重新加载。托盘里的“退出 padmate”才全部退出。
• Menu、View、Xbox 这些键显示键上印的符号。
• “更多”菜单的“按键名称显示”只有“动作名称”和“快捷键”两项。

下载和安装

1. 下载 padmate-v1.0.2-windows-amd64-setup.exe，双击安装。按用户安装，不需要管理员权限。
2. 这个版本没有代码签名。第一次运行安装包时，Windows 会提示“Windows 已保护你的电脑”。点“更多信息”，再点“仍要运行”。
3. 核对文件：在 PowerShell 里运行 Get-FileHash padmate-v1.0.2-windows-amd64-setup.exe，和 .sha256 文件里的值比较（不分大小写）。

从旧版本升级：直接运行新的安装包，配置和设置都会保留。装着 1.0.1 的电脑也可以在“设置”里点“检查更新”。

已知限制

• 没有代码签名，见上面的安装步骤。
• 关掉窗口后界面留在后台，会一直占着一些内存，直到退出 padmate。
• 更多见安装目录里的 resources\docs\known-limitations.md。

---

English

padmate turns a game controller into a keyboard shortcut console for painting. Windows 10/11 x64 only.

This release comes from the 1.0 acceptance: key settings are simpler, and opening, closing and choosing keys are smoother.

What changed. Double-click the tray icon to open the window, and the installer adds a desktop shortcut. There is one function key, Menu by default, which you can change to View or the Xbox button in Settings → General → Function key (for the Xbox button, turn off the Game Bar's response to it in Windows as the dialog says); the mapping page switches between “Normal” and “Hold function key”. Each key has three mappings, tap, hold and double tap, and an action is a shortcut or a script; a sequence has shortcuts and waits. The send mode, repeat and typed-text options are gone from the app, and what profile files already contain still works. Recording a shortcut starts when you click the field or “Capture shortcut” and ends with the first key, mouse button or wheel notch; hold Esc for 1 s to cancel. “New profile” asks only for a name and makes a blank profile, and each profile card has “Copy”; the starting templates and “based on another profile” are gone (extends in a file still works). While the mapping wizard is open, mapping stays paused whether or not padmate is in front. Closing the window keeps the app in the background, so it opens again at once without loading the controller model; “退出 padmate” in the tray quits everything. Menu, View, the Xbox button and the like show the symbol printed on them. The “Key labels” section of the “More” menu has two choices, action names and shortcuts.

Install. Download padmate-v1.0.2-windows-amd64-setup.exe and run it. It installs per user and needs no administrator rights. This build is not code-signed, so Windows shows “Windows protected your PC” the first time: click “More info”, then “Run anyway”. To check the file, run Get-FileHash padmate-v1.0.2-windows-amd64-setup.exe in PowerShell and compare it with the .sha256 file (case does not matter). To upgrade, run the new installer; profiles and settings are kept. With 1.0.1 installed, you can also click “Check for updates” in “Settings”.

Known limitations. Not code-signed. After the window is closed, the app stays in the background and keeps some memory until you quit padmate. See resources\docs\known-limitations.en.md in the install folder.

padmate v1.0.1

padmate 把游戏手柄变成键盘快捷键控制台：画画时左手握手柄，按键就是你常用的快捷键。只支持 Windows 10/11 x64。

这是 padmate 1.0 的第一个公开发布。和 1.0.0 相比，功能没有变化；安装包只带给用户看的文档（使用指南、快速上手、已知限制、手柄排障），文档里的链接也改成指向安装目录里有的文件。

下载和安装

1. 下载 padmate-v1.0.1-windows-amd64-setup.exe，双击安装。按用户安装，不需要管理员权限。
2. 这个版本没有代码签名。第一次运行安装包时，Windows 会提示“Windows 已保护你的电脑”。点“更多信息”，再点“仍要运行”。
3. 核对文件：在 PowerShell 里运行 Get-FileHash padmate-v1.0.1-windows-amd64-setup.exe，和 .sha256 文件里的值比较（不分大小写）。

从旧版本升级：直接运行新的安装包，配置和设置都会保留。装着 1.0.0 的电脑也可以在“设置”里点“检查更新”。

1.0 里有什么

• 手柄图上点一个键，设它的快捷键；按下、点按、长按、双击到四击各设各的。
• 按软件自动切换配置；配置可以“基于”另一个配置。
• 按住 View 或 Menu 时换一套按键（功能键）。
• 连发、连点、按顺序发送的序列、输入文字、媒体和音量键。
• 摇杆和扳机：方向键、旋钮、鼠标、两段扳机，可调死区和曲线。
• 脚本（宏）：用 TypeScript 写更复杂的动作。
• 浮层提示、低电量提醒、紧急暂停（View 和 Menu 一起按住 2 秒）。
• 诊断页：每次按键发了什么；没反应时写明原因；延迟统计。
• 导入 AntiMicroX 的配置（.amgp）。
• 映射向导：SDL 不认识的手柄也能用。
• 无障碍：高对比度主题、键盘操作、读屏。
• 中英文的使用指南，在安装目录的 resources\docs\guide。

已知限制

• 没有代码签名，见上面的安装步骤。
• 更多见安装目录里的 resources\docs\known-limitations.md。

---

English

padmate turns a game controller into a keyboard shortcut console for painting. Windows 10/11 x64 only.

This is the first public release of padmate 1.0. Nothing changed in what it does since 1.0.0. The installer now carries only the documents for users (the user guide, the quick start, the known limitations and the controller troubleshooting), and their links point to files in the install folder.

Install. Download padmate-v1.0.1-windows-amd64-setup.exe and run it. It installs per user and needs no administrator rights. This build is not code-signed, so Windows shows "Windows protected your PC" the first time: click "More info", then "Run anyway". To check the file, run Get-FileHash padmate-v1.0.1-windows-amd64-setup.exe in PowerShell and compare it with the .sha256 file (case does not matter). To upgrade, run the new installer; profiles and settings are kept. With 1.0.0 installed, you can also click "Check for updates" in "Settings".

What is in 1.0. Shortcuts per key and gesture (press, tap, hold, double to quadruple tap); profiles that switch with the app in front and can be based on another; function keys (hold View or Menu for another set); repeat, turbo, sequences, typed text, media and volume keys; sticks and triggers as directions, knobs, mouse or two-stage triggers; TypeScript scripts (macros); an overlay, low-battery alerts and an emergency pause (hold View and Menu for 2 s); a Diagnostics page that says what each press did or why it did nothing, with latency figures; AntiMicroX .amgp import; a mapping wizard for controllers SDL does not know; high contrast, keyboard and screen reader support; a user guide in English and Chinese in resources\docs\guide.

Known limitations. Not code-signed. See resources\docs\known-limitations.en.md in the install folder.