KeyX Switch
From GameBrew
More actions
| KeyX | |
|---|---|
 | |
| General | |
| Author | TOM-BadEN |
| Type | Overlays |
| Version | 1.2.7 |
| License | Mixed |
| Last Updated | 2025/11/19 |
| Links | |
| Download | |
| Website | |
| Source | |
KeyX (formerly AutoKeyLoop) is a button assistant homebrew with turbo and key remapping support. Features global or per-game configuration with auto-start memory. Consists of Tesla overlay and system module.
Features
- General:
- Modern and beautiful Tesla overlay.
- Dynamically modify turbo and mapping settings.
- Optional modern UI notification popups.
- Key Mapping:
- Remap 16 buttons (A/B/X/Y/L/R/ZL/ZR/D-pad/SELECT/START/L3/R3).
- Works together with turbo without conflicts.
- Perfectly avoids system warning popups about button changes.
- Global and per-game configuration.
- Auto-remembers on/off state.
- Turbo:
- Turbo for 12 buttons (A/B/X/Y/L/R/ZL/ZR/D-pad).
- Multiple buttons can turbo simultaneously.
- Non-turbo buttons work normally during turbo.
- Customizable press and release duration.
- Global and per-game configuration.
- Auto-remembers on/off state.
- Memory Usage:
- System module: only 297 KB.
- Notification popup: extra 688 KB.
- Popup only uses memory when triggered.
Installation
The CN and EN versions differ only in the Tesla overlay title; everything else is identical.
Copy files to SD card root:
- /atmosphere/contents/4100000002025924/
- /atmosphere/contents/0100000000251020
- /switch/.overlays/ovl-KeyX.ovl
Supported languages:
- en.json (English)
- zh-cn.json (No need to add, already hardcoded)
- zh-tw.json (Traditional Chinese)
- ja.json (Japanese)
- ko.json (Korean)
- fr.json (French)
- de.json (German)
- it.json (Italian)
- es.json (Spanish)
- pt.json (Portuguese)
- ru.json (Russian)
- nl.json (Dutch)
User guide
Both Key Mapping and Turbo work on all Switch models.
Turbo on JoyCon models may feel less smooth, but all functions are usable.
- Current function performance:
- Turbo - Pressing only the turbo button works fine, but inputting other buttons or using the joystick during turbo performs poorly (to be fixed).
- Key Mapping - Perfect.
- Macro - After macro ends, stick may fail to reset, touch the stick to restore.
- Combined functions:
- Turbo + Key Mapping - Same as Turbo.
- Turbo + Macro - Turbo function temporarily disabled during macro playback.
- Key Mapping + Macro - If the keys being played have been remapped, incorrect input may occur.
LITE models have perfect turbo performance.
- Current function performance:
- Turbo - Perfect.
- Key Mapping - Perfect.
- Macro - Perfect.
- Combined functions:
- Turbo + Key Mapping - Perfect.
- Turbo + Macro - Turbo function temporarily disabled during macro playback.
- Key Mapping + Macro - If the keys being played have been remapped, incorrect input may occur.
Screenshots
Changelog
v1.2.7
- Fixed a bug where requesting the pdmqry service could cause the system service session count to overflow, leading to a crash.
- Currently, this bug has only been observed in the game Taiko no Tatsujin Rhythm Festival (01002460135A4000), causing it to crash.
- Thanks to @masagrator for providing the solution.
v1.2.6
- Added key macro functionality.
- The red badge on the home page indicates that the key has a macro bound.
- Macros can be recorded directly using the Tesla plugin, and the recording guide is complete and visually refined.
- Added keyboard input module, allowing file renaming through Tesla.
- Both stick and button states will be recorded.
- Maximum recording duration is 30 seconds.
- Recording frame rate is 60 FPS.
- Pressing the corresponding shortcut key plays once.
- Holding the corresponding shortcut key loops playback.
- Pressing the shortcut key again during playback cancels playback.
- Fixes:
- Fixed a bug where an IPC call could cause Tesla to freeze.
- Fixed an issue where using turbo and remapping simultaneously could cause key confusion.
- Fixed some bugs that I already forgot what they were.
- Others:
- Compiled with the latest libnx, it now supports HOS21.
- Refactored the refresh mechanism of the ovl plugin.
- Completely refactored the automatic key (turbo and macro) module in the system module.
- Memory usage increased from 297 KB to 343 KB.
v1.1.6
- Added turbo activation delay detection to prevent accidental triggering of the turbo function.
- The turbo function now supports all models.
- Optimized the smoothness of the turbo function on LITE models.
- Note: Due to underlying system limitations, multi-button turbo on JC controllers performs only moderately. I’ve tried my best. It works perfectly on LITE models.
- Fixes
- Fixed a BUG where a buffer overflow could cause a crash.
- Fixed a BUG where, in some cases, Tesla plugin IPC calls could cause a freeze.
v1.1.5
- Fixed a bug where the mapping feature could not work properly on non-LITE models in some cases.
- Changed the plugin’s configuration file path from /config/AutoKeyLoop to /config/KeyX.
- If you have been using this plugin before, you can manually update the configuration path to avoid losing your settings.
- Note
- Remapping function works on all models
- Turbo function still only works on LITE models
- The CN and EN versions differ only in the Tesla overlay title; everything else is identical.
v1.1.4
- Tesla Ovl
- Fixed a bug, where IPC communication failed when switching configurations, if both mapping and Turbo functions were disabled.
- Note
- Remapping function works on all models
- Turbo function still only works on LITE models
- The CN and EN versions differ only in the Tesla overlay title; everything else is identical.
v1.1.3
- Added Button Remapping Feature
- Supports remapping between 16 buttons (A/B/X/Y/L/R/ZL/ZR/D-Pad/SELECT/START/L3/R3)
- Can be enabled simultaneously with turbo function without conflicts
- Perfectly bypasses system warning popups about button modifications
- Global configuration and per-game configuration
- Automatically remembers on/off state
- Optimizations
- Turbo threads merged from 2 into 1
- Significant code optimization throughout the entire project
- System module now only uses 297 KB of RAM
- Turbo and remapping functions pause when game is switched to background
- Tesla Overlay
- Tesla overlay has been significantly redesigned to accommodate the new remapping feature
- Added reset function to turbo button settings
- Note
- Remapping function works on all models
- Turbo function still only works on LITE models
- The CN and EN versions differ only in the Tesla overlay title; everything else is identical
v1.0.3
- Added multi-language support (currently only EN)
- Users who require other languages can provide their own translations
- See the README for how to add them
- Please note that only Switch Lite is currently supported
- The CN and EN versions are completely identical, except for the plugin title
v1.0.2
- First Release
Credits
- libnx - Switch development library
- libultrahand - Tesla Overlay framework
- minIni-nx - INI config parser library