Quick Payload Switcher 3DS: Difference between revisions

Quick Payload Switcher
Quick Payload Switcher
General
Author	gnmmarechal
Type	System Tools
Version	1.3
License	Mixed
Last Updated	2016/07/09
Links
	Download
	Website
	Source
	Support Author

Latest revision as of 01:01, 14 August 2023

Quick Payload Switcher for A9LH and B9S. It can switch between payloads (to switch between CFWs), 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 (supports up to 5 alternate payloads).

Installation

First, install the CIA using FBI/NASA/DevMenu.

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.

External links

GitHub - https://github.com/gnmmarechal/payloadswitch
GBAtemp - https://gbatemp.net/threads/release-quick-payload-switcher.432358

@@ Line 1: / Line 1: @@
-{{Infobox 3DS homebrew
+{{Infobox 3DS Homebrews
-| title = Quick Payload Switcher
+|title=Quick Payload Switcher
-| type = Utilities
+|image=Quickpayloadswitcher2.png
-| version = v1.3
+|description=Switches two A9LH payloads (by renaming them).
-| licence = Mixed
+|author=gnmmarechal
-| author = gnmmarechal
+|lastupdated=2016/07/09
-| website = https://github.com/gnmmarechal/payloadswitch
+|type=System Tools
-| download = https://dlhb.gamebrew.org/3dshomebrew/Quick-Payload-Switcher.rar
+|version=1.3
-| source = https://dlhb.gamebrew.org/3dshomebrew/Quick-Payload-Switcher.rar
+|license=Mixed
+|download=https://dlhb.gamebrew.org/3dshomebrews/quickpayloadswitcher.7z
+|website=https://github.com/gnmmarechal/payloadswitch
+|source=https://github.com/gnmmarechal/payloadswitch
+|donation=https://www.paypal.me/gnmpolicemata
 }}
+Quick Payload Switcher for A9LH and B9S. It can switch between payloads (to switch between CFWs), rename arm9loaderhax.bin to arm9loaderhax_si.bin and vice-versa.
-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. Please Read the documentation below.
+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 (supports up to 5 alternate payloads).
-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.
+==Installation==
+First, install the CIA using FBI/NASA/DevMenu.
-==Usage (Payload Switcher)==
+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.
-First, install the CIA using FBI/NASA/DevMenu/whatever.
+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 your original payload is named "/arm9loaderhax.bin", "/arm9loaderhax_si.bin" or "boot.firm"
+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).
-)Name your secondary payload (the one you want to quickswitch) "/arm9loaderhax_switch.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.
-)Run the app whenever you want to switch, and reboot the console.
+For information about renaming the payloads for screeninit/noscreeninit behaviour, see Mode 1/2/3.
-If your original payload is named something else (ex. "/banana.bin")
+==User guide==
+===Mode 1 - Normal===
-)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 (ex. "/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 (ex. /arm9loaderhax.bin) with that payload (ex. /arm9loadrhax_switch_up.bin").
-If your secondary payload is named something else (ex. "/somepayload.bin")
-)Create a file named "/payloadswitch-out.cfg" and write the path there (ex. "/somepayload.bin")
-)Use the app.
-To stop the console from rebooting when using this (on v1.1 or later)
-Just hold the L button while running it.
-For information about renaming the payloads for screeninit/noscreeninit behaviour, read "Modes"
-==Modes==
-===Mode 1: Normal (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.
+If you wish to rename the payload and switch payloads, hold Y and X instead to use "Mixed" mode.
-===Mode 2: Alternate (alternate)===
+===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 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.
+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.
-==Changelog:==
+==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
-☆v1.3
+Hold L (while running) - Stop the console from rebooting (v1.1 or later)
-Now supports up to 5 alternate payloads. Check the README at GitHub for details.
+==Changelog==
-☆v1.2.1
+'''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
+'''v1.2'''
+* Third release. Now supports 3 modes of operation (Normal, Alternate and Mixed).
-Third release. Now supports 3 modes of operation (Normal, Alternate and Mixed). Check the README at GitHub for details.
+'''v1.1'''
-☆v1.1
+* Second release. Console reboots automatically unless ""L"" is pressed.
-Second release. Console reboots automatically unless ""L"" is pressed. Check the README at GitHub.
+'''v1'''
+* Initial release, seems stable.
-☆v1
+==External links==
+* GitHub - https://github.com/gnmmarechal/payloadswitch
+* GBAtemp - https://gbatemp.net/threads/release-quick-payload-switcher.432358
-Initial release, seems stable. Check the README at GitHub.
+[[Category:3DS homebrew applications]]
+[[Category:Homebrew utility applications on 3DS]]
+[[Category:Support the author]]