Pad-macro Switch

pad-macro
General
Author	FitzQ
Type	Utilities
Version	2.0.1
License	GPL-3.0
Last Updated	2025/09/10
Links
Download
Website
Source

pad-macro is a homebrew tool for the Nintendo Switch that enables recording and playback of controller button macros. It consists of two main components: an overlay UI based on libtesla for configuration and interaction, and a sysmodule that runs in the background to handle macro recording and playback. This allows users to save sequences of controller inputs into binary macro files and map button combinations to automatically replay those macros.

Features

• Record sequences of controller button inputs and save them as binary macro files.
• Map button combinations to specific macro files for quick playback.
• Overlay interface for configuration and interaction using libtesla.
• Background sysmodule handles recording and playback logic.
• Configurable macros and settings stored in the SD card filesystem.

Setup and Usage

• Requires devkitPro toolchain with devkitA64 and libnx.
• Build the project with make in the root directory or individually for overlay and sysmodule folders.
• Configure macros and options through sdmc:/config/pad-macro/config.ini.
• Recorded macros are saved under sdmc:/config/pad-macro/macros/.
• Example config snippet for key mappings and macro activation is provided in the repository.
• Debug logs can be enabled and accessed via network socket for development.

Configuration Example

[pad]
recorder_enable=true
player_enable=true
recorder_btn=0x30
play_latest_btn=0x40

[macros]
0x30=/config/pad-macro/macros/20250828-123456.bin

Notes

• Primarily intended for advanced users and developers comfortable with libnx and homebrew development.
• Useful for automating repetitive button inputs during gameplay or testing.
• Open for contributions including pull requests, issues, and test cases.

Changelog

v2.0.1

• change the storage dir from /switch/pad-macro/macros to /config/pad-macro/macros, you should move your macro files by yourself
• enable custom set combos
• enable edit macro file

v2.0.0

• Support macro file editing
• Support macro store download
• Incompatible with old version macro files
• Welcome to share macro keys here: Macro Store

v1.0.1

• Added key combination options
• Support selection of recording and playback frequency
• Support preview of macro key content (key press and frame number)

v1.0

• First Release.

External links

• Github - https://github.com/FitzQ/pad-macro
• HB-app - https://hb-app.store/switch/padmacro