m (Text replacement - "| licence" to "| license") |
No edit summary |
||
| Line 7: | Line 7: | ||
| author = gnmmarechal | | author = gnmmarechal | ||
| website = https://github.com/gnmmarechal/payloadswitch | | website = https://github.com/gnmmarechal/payloadswitch | ||
| download = https://dlhb.gamebrew.org/ | | download = https://dlhb.gamebrew.org/3dshomebrews/Quick-Payload-Switcher.rar | ||
| source = https://github.com/gnmmarechal/payloadswitch | | source = https://github.com/gnmmarechal/payloadswitch | ||
}} | }} | ||
This tool, a Lua script that runs on LPP-3DS by Rinnegatamante, is used to quickly switch between A9LH payloads, for those who like using multiple CFWs. It is also capable of renaming the current payload to toggle screeninit/noscreeninit behaviour on a compatible A9LH installation. | Quick Payload Switcher for A9LH and B9S. It can switch between payloads (to switch between CFWs), and it can rename arm9loaderhax.bin to arm9loaderhax_si.bin and vice-versa. | ||
This tool, a Lua script that runs on [[Lua Player Plus 3DS|LPP-3DS]] by Rinnegatamante, is used to quickly switch between A9LH payloads, for those who like using multiple CFWs. It is also capable of renaming the current payload to toggle screeninit/noscreeninit behaviour on a compatible A9LH installation. | |||
==Usage (Payload Switcher)== | ==Usage (Payload Switcher)== | ||
First, install the CIA using FBI/NASA/DevMenu/whatever. | First, install the CIA using FBI/NASA/DevMenu/whatever. | ||
If | If original payload is named "/arm9loaderhax.bin", "/arm9loaderhax_si.bin" or "boot.firm": | ||
* Name your secondary payload (the one you want to quickswitch) "/arm9loaderhax_switch.bin". | |||
* Run the app whenever you want to switch, and reboot the console. | |||
If original payload is named something else (e.g. /banana.bin): | |||
* Name your secondary payload (the one you want to quickswitch) "/arm9loaderhax_switch.bin". | |||
* Create a file named "/payloadswitch-in.cfg" and write the path there (e.g. /banana.bin). | |||
* Run the app whenever you want to switch, and reboot the console. | |||
If you want to switch with more payloads | If you want to switch with more payloads: | ||
* Name your other payloads "/arm9loaderhax_switch_up.bin", "/arm9loaderhax_switch_down.bin", "/arm9loaderhax_switch_left.bin" and/or "/arm9loaderhax_switch_right.bin". | |||
* This applies even if the user has B9S and not A9LH, name the other payloads like this. | |||
* To switch to them, just hold the correct DPAD button while starting the application. This will make the app replace your main payload (e.g. /arm9loaderhax.bin) with that payload (e.g. /arm9loadrhax_switch_up.bin). | |||
If the secondary payload is named something else (e.g. /somepayload.bin): | |||
* Create a file named "/payloadswitch-out.cfg" and write the path there (e.g. /somepayload.bin). | |||
* Use the app. | |||
For information about renaming the payloads for screeninit/noscreeninit behaviour, see Mode 1/2/3. | |||
==User guide== | |||
===Mode 1 Normal=== | |||
== | |||
===Mode 1 | |||
To use this mode (which by default only switches between payloads to boot), simply delete any file named /payloadswitch-mode.cfg , or make sure that file has "normal" written, without the quotes. | To use this mode (which by default only switches between payloads to boot), simply delete any file named /payloadswitch-mode.cfg , or make sure that file has "normal" written, without the quotes. | ||
While in normal mode, if you want to toggle between noscreeninit/screeninit mode (on an A9LH installation that supports it, like Aurora Wright's latest A9LH, which screeninit/noscreeninit merged and relies on filenames to run in one mode or the other), hold R and X while starting this app. R and X will, just for that one time, use Alternate mode. | While in normal mode, if you want to toggle between noscreeninit/screeninit mode (on an A9LH installation that supports it, like Aurora Wright's latest A9LH, which screeninit/noscreeninit merged and relies on filenames to run in one mode or the other), hold R and X while starting this app. R and X will, just for that one time, use Alternate mode. | ||
If you wish to rename the payload | If you wish to rename the payload and switch payloads, hold Y and X instead to use "Mixed" mode. | ||
===Mode 2 | ===Mode 2 Alternate=== | ||
To use this mode (which by default only renames the payload as arm9loaderhax.bin<>arm9loaderhax_si.bin), create a file named /payloadswitch-mode.cfg , and write "alternate" in it, without the quotes. | To use this mode (which by default only renames the payload as arm9loaderhax.bin<>arm9loaderhax_si.bin), create a file named /payloadswitch-mode.cfg , and write "alternate" in it, without the quotes. | ||
While in alternate mode, if you want to use Normal mode once (to switch between CFWs), hold R and X while starting the app. If you want to use "Mixed" behaviour, which will switch and rename the payload, hold Y and X instead. | While in alternate mode, if you want to use Normal mode once (to switch between CFWs), hold R and X while starting the app. If you want to use "Mixed" behaviour, which will switch and rename the payload, hold Y and X instead. | ||
===Mode 3 | ===Mode 3 Mixed=== | ||
Mixed mode is both Normal and Alternate. It will always rename | Mixed mode is both Normal and Alternate. It will always rename and switch the payload to boot. | ||
To use it, create a file named /payloadswitch-mode.cfg and write "mixed" in it, without the quotes. | |||
While in mixed mode, if you wish to use Normal mode, hold R and X while starting the app. | While in mixed mode, if you wish to use Normal mode, hold R and X while starting the app. | ||
== | ==Controls== | ||
R+X (while starting the app) - Switch from Normal to Alternate (once), Switch from Alternate to Normal (once), Switch from Mixed to Normal | |||
Y+X (while starting the app) - Switch from Alternate to Mixed | |||
Hold L (while running) - Stop the console from rebooting (v1.1 or later) | |||
Now supports up to 5 alternate payloads. | ==Changelog== | ||
'''v1.3''' | |||
* Now supports up to 5 alternate payloads. | |||
Minor release, to change the unique ID to 0xA541. | '''v1.2.1''' | ||
* Minor release, to change the unique ID to 0xA541. | |||
'''v1.2''' | |||
* Third release. Now supports 3 modes of operation (Normal, Alternate and Mixed). | |||
'''v1.1''' | |||
* Second release. Console reboots automatically unless ""L"" is pressed. | |||
'''v1''' | |||
* Initial release, seems stable. | |||
==External links== | |||
* GitHub - https://github.com/gnmmarechal/payloadswitch | |||
* GBAtemp - https://gbatemp.net/threads/release-quick-payload-switcher.432358 | |||
[[Category:3DS homebrew applications]] | |||
[[Category:Homebrew utility applications on 3DS]] | |||
Revision as of 03:21, 29 October 2021
| Quick Payload Switcher | |
|---|---|
| General | |
| Author | gnmmarechal |
| Type | Utilities |
| Version | v1.3 |
| License | Mixed |
| Last Updated | 2016/07/09 |
| Links | |
| Download | |
| Website | |
| Source | |
Quick Payload Switcher for A9LH and B9S. It can switch between payloads (to switch between CFWs), and it can rename arm9loaderhax.bin to arm9loaderhax_si.bin and vice-versa.
This tool, a Lua script that runs on LPP-3DS by Rinnegatamante, is used to quickly switch between A9LH payloads, for those who like using multiple CFWs. It is also capable of renaming the current payload to toggle screeninit/noscreeninit behaviour on a compatible A9LH installation.
Usage (Payload Switcher)
First, install the CIA using FBI/NASA/DevMenu/whatever.
If original payload is named "/arm9loaderhax.bin", "/arm9loaderhax_si.bin" or "boot.firm":
- Name your secondary payload (the one you want to quickswitch) "/arm9loaderhax_switch.bin".
- Run the app whenever you want to switch, and reboot the console.
If original payload is named something else (e.g. /banana.bin):
- Name your secondary payload (the one you want to quickswitch) "/arm9loaderhax_switch.bin".
- Create a file named "/payloadswitch-in.cfg" and write the path there (e.g. /banana.bin).
- Run the app whenever you want to switch, and reboot the console.
If you want to switch with more payloads:
- Name your other payloads "/arm9loaderhax_switch_up.bin", "/arm9loaderhax_switch_down.bin", "/arm9loaderhax_switch_left.bin" and/or "/arm9loaderhax_switch_right.bin".
- This applies even if the user has B9S and not A9LH, name the other payloads like this.
- To switch to them, just hold the correct DPAD button while starting the application. This will make the app replace your main payload (e.g. /arm9loaderhax.bin) with that payload (e.g. /arm9loadrhax_switch_up.bin).
If the secondary payload is named something else (e.g. /somepayload.bin):
- Create a file named "/payloadswitch-out.cfg" and write the path there (e.g. /somepayload.bin).
- Use the app.
For information about renaming the payloads for screeninit/noscreeninit behaviour, see Mode 1/2/3.
User guide
Mode 1 Normal
To use this mode (which by default only switches between payloads to boot), simply delete any file named /payloadswitch-mode.cfg , or make sure that file has "normal" written, without the quotes.
While in normal mode, if you want to toggle between noscreeninit/screeninit mode (on an A9LH installation that supports it, like Aurora Wright's latest A9LH, which screeninit/noscreeninit merged and relies on filenames to run in one mode or the other), hold R and X while starting this app. R and X will, just for that one time, use Alternate mode.
If you wish to rename the payload and switch payloads, hold Y and X instead to use "Mixed" mode.
Mode 2 Alternate
To use this mode (which by default only renames the payload as arm9loaderhax.bin<>arm9loaderhax_si.bin), create a file named /payloadswitch-mode.cfg , and write "alternate" in it, without the quotes.
While in alternate mode, if you want to use Normal mode once (to switch between CFWs), hold R and X while starting the app. If you want to use "Mixed" behaviour, which will switch and rename the payload, hold Y and X instead.
Mode 3 Mixed
Mixed mode is both Normal and Alternate. It will always rename and switch the payload to boot.
To use it, create a file named /payloadswitch-mode.cfg and write "mixed" in it, without the quotes.
While in mixed mode, if you wish to use Normal mode, hold R and X while starting the app.
Controls
R+X (while starting the app) - Switch from Normal to Alternate (once), Switch from Alternate to Normal (once), Switch from Mixed to Normal
Y+X (while starting the app) - Switch from Alternate to Mixed
Hold L (while running) - Stop the console from rebooting (v1.1 or later)
Changelog
v1.3
- Now supports up to 5 alternate payloads.
v1.2.1
- Minor release, to change the unique ID to 0xA541.
v1.2
- Third release. Now supports 3 modes of operation (Normal, Alternate and Mixed).
v1.1
- Second release. Console reboots automatically unless ""L"" is pressed.
v1
- Initial release, seems stable.