Pad-macro Switch

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

This project lets you record and play back controller button sequences on Nintendo Switch. (Switch / libnx Example Project)

It consists of two main modules:

• overlay/ - User interface built with libtesla.
• sysmodule/ - A background service.

Features

• Record button sequence and save as binary files.
• Assign macros to button combinations.
• Press your mapped buttons to trigger macro playback.

Installation

Requires Tesla Menu installed.

File locations:

• Configuration - sdmc:/config/pad-macro/config.ini
• Macro file - sdmc:/config/pad-macro/macros/

New recordings are saved as latest.bin. Rename them to keep permanently.

config.ini example:

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

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

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
• Homebrew App Store - https://hb-app.store/switch/padmacro