Toggle search
Toggle menu
12.1K
15.1K
1.2K
216.7K
GameBrew
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Pad-macro Switch: Difference between revisions

From GameBrew
More actions
Newer edit →
Created page with "{{Infobox Switch Homebrews |title=pad-macro |image=Switch-logo.png |description=Key Macro Recording and Playback For Nintendo Switch. |author=FitzQ |lastupdated=2025/09/10 |type=Utilities |version=2.0.1 |license=GPL-3.0 |download=https://dlhb.gamebrew.org/switchhomebrews/padmacroSwitch.7z |website=https://github.com/FitzQ/pad-macro |source=https://github.com/FitzQ/pad-macro |donation= }} {{#seo: |title=Switch Homebrew Apps (Utilities) - GameBrew |title_mode=append |image..."
 
No edit summary
Line 2: Line 2:
|title=pad-macro
|title=pad-macro
|image=Switch-logo.png
|image=Switch-logo.png
|description=Key Macro Recording and Playback For Nintendo Switch.
|description=Key macro recording and playback.
|author=FitzQ
|author=FitzQ
|lastupdated=2025/09/10
|lastupdated=2025/09/10
|type=Utilities
|type=Overlays
|version=2.0.1
|version=2.0.1
|license=GPL-3.0
|license=GPL-3.0
Line 19: Line 19:
|image_alt=pad-macro
|image_alt=pad-macro
}}
}}
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.
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==
==Features==
*Record sequences of controller button inputs and save them as binary macro files.
* Record button sequence and save as binary files.
*Map button combinations to specific macro files for quick playback.
* Assign macros to button combinations.
*Overlay interface for configuration and interaction using libtesla.
* Press your mapped buttons to trigger macro playback.
*Background sysmodule handles recording and playback logic.
 
*Configurable macros and settings stored in the SD card filesystem.
==Installation==
Requires [[Tesla_Menu_Switch|Tesla Menu]] installed.


==Setup and Usage==
File locations:
*Requires devkitPro toolchain with devkitA64 and libnx.
* Configuration - sdmc:/config/pad-macro/config.ini
*Build the project with make in the root directory or individually for overlay and sysmodule folders.
* Macro file - sdmc:/config/pad-macro/macros/
*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===
New recordings are saved as latest.bin. Rename them to keep permanently.
<pre>
[pad]
recorder_enable=true
player_enable=true
recorder_btn=0x30
play_latest_btn=0x40


[macros]
config.ini example:
0x30=/config/pad-macro/macros/20250828-123456.bin
[pad]
</pre>
recorder_enable=true
==Notes==
player_enable=true
*Primarily intended for advanced users and developers comfortable with libnx and homebrew development.
recorder_btn=0x30
*Useful for automating repetitive button inputs during gameplay or testing.
play_latest_btn=0x40
*Open for contributions including pull requests, issues, and test cases.
[macros]
0x30=/config/pad-macro/macros/20250828-123456.bin


==Changelog==  
==Changelog==  

Revision as of 13:57, 18 October 2025

pad-macro
General
AuthorFitzQ
TypeOverlays
Version2.0.1
LicenseGPL-3.0
Last Updated2025/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

Retrieved from "https://www.gamebrew.org/index.php?title=Pad-macro_Switch&oldid=202267"

Advertising: