Edit Infobox Switch Homebrews: IPSwitch

Free text:

Pronounced as "I-P-S-witch". Use text to generate .ips patches to use with Atmosphere. '''Note:''' To use .ips patches make sure you have Atmosphere 44e2412a (July 30, 2018) or later loader build. ==User guide== ===How to use=== This program reads <code>.pchtxt</code> (patch text) files and can create <code>.ips</code> patches. <code>.pchtxt</code> is a in-house text file format to represent patches. You can find the specs for <code>.pchtxt</code> below. The program looks for <code>.pchtxt</code> files with the path <code>sdmc:/switch/ipswitch/{patch_description}/{whatever_name}.pchtxt</code>. *The dir {patch_description}/{whatever_name}.pchtxt is used for display purpose and help user to identify the patch. *The {patch_description} folder name is used as the folder name in <code>atmosphere/exefs_patches/{patch_description}</code>. Run the homebrew and it will let you select a <code>.pchtxt</code> file to generate <code>.ips</code> patch with. ===Structure of .pchtxt file=== <code>.pchtxt</code> will be a text file. See the <code>splat310.pchtxt</code> for some simple Splatoon 2 3.1.0 edit provided for example. =====Mandatory Lines===== The first line is mandatory to specify the nso's build id with <code>@nsobid-{a_buncha_hex}</code>. If this is missing, the program will attempt to treat the file as an elf to nso patch, see "Using <code>.elf</code> Files and Generate a Patched NSO" section. ====Patches==== The patches are represented in lines of offset and value pair. The offset is always 4 bytes, while value can be either any amount of bytes or a string. Offset will always be in Big-Endian, and is the absolute offset from uncompressed nso file. However, in most cases, it's easier to use the "offset_shift" flag to match the .text offsets, see "Flags" section for details. The value can be either bytes or a string. When using bytes, each byte must be represented in 2 characters in their hexadecimal representable, and multiple bytes should be arranged in the order they appear in the binary (Little Endian in most cases). When using Strings, each string must open and close with a pair of <code>"</code>. C style string escapes are also supported. So a string value can be something like <code>"New\nLine"</code>. For every patch, it is necessary to specify whether it is enabled or disabled by putting @enabled or @disabled flag on top of it. When encountering this flag, the program will print the last "pure comment line" from the file, in attempt to explain the patch. Thus, it's also necessary to put a comment before each patch about what the patch does. Comments are marked with <code>/</code> character: // This is a comment. Be mindful that IPSwitch uses a 0x1000 sized line buffer when parsing patch text. While this shouldn't be an issue in most cases, having a line over 4096 characters will not work. To sum it up, this is what a patch should look like: <pre> // Some comment to explain the patch @enabled 00123458 1F2003D5DEADBEEF 00123460 "a cool string" ... ... ^ ^ | | Offset Some Value or String </pre> =====Flags===== <code>@flag</code> can be used to add flags in the patch text, examaples: * <code>@flag {flag_name}</code> - This is what the line should look like. * <code>@flag {flag_name} {flag_value}</code> - Or for flags with an value. For now, the supported flags are: * <code>offset_shift</code>: ** Allows you to add or substract a certain amount to all patch text offsets that comes after this flag. ** For example, if you want to use .text addresses, you can do: ** <code>@flag offset_shift 0x100</code> ** Which will automatically add 0x100 to all offsets, since the raw offset from IDA doesn't include the 0x100 nso header. * <code>print_values</code>: ** To enable printing applied values of all patches. Example: ** <code>@flag print_values</code> See splat310.pchtxt to find out how you can use the flag in it. =====Ending the patch text early===== <code>@stop</code> can be used in the end of desired patches, telling the program to stop reading any patches that might come after this flag, in case you want to leave in any not in use patches without having to write all of them as disabled. =====Symbol===== Lines starting with # will always be printed when the program parses the text file, so it can be used to provide extra information, like: #01003BC0000A0000 Splatoon™ 2 3.0.1 USA ===Using .elf files and generate a patched NSO=== IPSwitch has a legacy support for elf to nso patching that dates back to before Atmosphere loader's <code>.ips</code> patch support. Since there has been previous reports of Atmosphere loader skipping <code>.ips</code> patches when custom nso is present, this feature can be used when there's need for a completely different nso. In fact, IPSwitch will attempt to treat any patch text without a specified <code>@nsobid-</code> as an elf to nso patch. However, generating the right path for custom nso files requires in addition: 1. the title id, and 2. the nso name. For generating patched nso from elf, place your elf file in <code>sdmc:/switch/ipswitch/{titleid-title_description}/{nso_name}.elf</code>. {nso_name} mush match the file name of the nso inside exefs. The <code>.pchtxt</code> should be <code>sdmc:/switch/ipswitch/{titleid-title_description}/{nso_name}.pchtxt</code>. Be careful when using the "offset_shift" flag when using this, as the converted elf file has different offset shifts in different segments. See main.pchtxt as an example. ===Editing the text file=== Please don't use Windows Notepad, because chances are that you'll end up with some bad encoding that may cause unwanted behavior when parsing. Use a real text editor like Sublime, Atom, or Notepad++. You can even use a hex editor, if you will, to make sure no extra bytes are there to break things. ==Changelog== '''v9.0.0 2020/02/25''' *Build with newer libnx: 9.0.0+ HID works again. *Increased line buffer used in pchtxt parsing to 4096 bytes. *Added a more comprehensive message when build id is not found in pchtxt. *Added a check for Atmosphere directory. *General software stability improvements to enhance the user's experience. *ipswitch.nro SHA256: 8b97b74e21e40a39959c9163eb99c07f92e8f4ba2cb054bae5390eecdae7cce5 '''v0.2.1 2018/11/11''' *NOTICE: This release no longer works. See issue [https://github.com/3096/ipswitch/issues/3 #3] and use the build there for now. *Build with newer libnx: GPU accelerated console. *Fixed an issue related to string patch parsing. *General software stability improvements to enhance the user's experience. *SHA256: b2d554934116488df7d5f6a45ba55ee8c58fd6017fe441c4df6ee8f13d7033a4 '''v0.2.0 2018/09/29''' *ipswitch-0.2.0.zip SHA256: af1a7666565f0aa514b36364f9a9994c67fbd0b6996f31cb6c97926429850ff6 *For support on using IPSwitch, please join our [https://discord.gg/v8Rueaf Discord server]. ==Credit== *plutoo for making elf2nso, used in compressing patched elf to nso (ISC License). *[https://www.deviantart.com/violetinkling Violet] Inkling for the app icon art (with permission). *OatmealDome for help in testings and feature suggestions. *All of my preview testers on SPH/SMH. == External links == * Github - https://github.com/3096/ipswitch * ForTheUsers - https://apps.fortheusers.org/switch/ipswitch