README: Fix some grammar and spelling mistakes

This commit is contained in:
rlaphoenix
2022-11-11 09:38:42 +00:00
parent 86bdc3a42f
commit 431ba57fcb
+18 -18
View File
@@ -6,7 +6,7 @@ A forwarder lets you open a Homebrew NRO file from your SD card through the Nint
of the Homebrew Launcher.
This is more so a script for making NSPs using [mpham]'s original Forwarder ROM [here][ROM].
My script is specifically aimed towards general homebrew NRO forwarding, not Retroarch Game Forwarding.
My script is specifically aimed toward general homebrew NRO forwarding, not Retroarch Game Forwarding.
The goal with my version is to automate as much as can be automated. Especially the annoying icons.
There's still some work to be done to finalize automation as the goal is to only need to provide a
@@ -14,11 +14,11 @@ path to the NRO that's on your switch's microSD card.
## Changes
1. The script was re-wrote almost entirely.
2. NSPs are now spit out to `/output` and are named to be more human-readable.
1. The script was rewritten almost entirely.
2. NSPs now save to `/output` and are named to be more human-readable.
3. `control.nacp` and the `icon_AmericanEnglish.dat` icon file are now automatically extracted from the NRO.
4. The `icon_AmericanEnglish.dat` is now automatically re-formatted as JPEG and re-stripped where necessary.
Even though it's extracted from the NRO, it still does this. Not all NRO icon dat's are up to spec for NSPs.
Even though it's extracted from the NRO, it still does this. Not all NRO icon `dat` files are up to spec for NSPs.
5. You now specify the publisher when calling `build`.
6. The path to the NRO must exist for automation to work. The best way is to insert your Switch's microSD card
and specify the drive letter for it in the call.
@@ -28,7 +28,7 @@ path to the NRO that's on your switch's microSD card.
1. [Download the project](https://github.com/rlaphoenix/nton/releases) and extract it.
2. Install the latest [ImageMagick] release. I recommend via [winget] or [chocolatey].
3. Download the latest [hacBrewPack] and [nstool] binaries and place them within the root of the project folder.
4. Place you're `prod.keys` to the root of the project folder. Make sure it's up to date for the firmware version
4. Place your `prod.keys` at the root of the project folder. Make sure it's up to date for the firmware version
you're switch is on. You can get this file using [Lockpick_RCM].
[ImageMagick]: <https://imagemagick.org/script/download.php>
@@ -47,27 +47,27 @@ path to the NRO that's on your switch's microSD card.
- The Drive Letter must only be the letter, e.g., `D`, not `D:/` or `D:\` or `D:`.
- The `Title ID` argument is entirely optional and a random Title ID will be generated if one is not specified.
For example, to make a forwarder folr the Homebrew Menu that's on your Switch's microSD at `D:\hbmenu.nro`,
For example, to make a forwarder for the Homebrew Menu that's on your Switch's microSD at `D:\hbmenu.nro`,
`build "Homebrew Menu" "switchbrew" "D" "/hbmenu.nro"`
## To-do
- [ ] Combine the Drive letter and Path arguments, and manually split them when they need to be seperate instead.
- [ ] Combine the Drive letter and Path arguments and manually split them when they need to be separate instead.
- [ ] Automate name and publisher by extracting from the extracted `control.nacp`.
- [ ] Force disable savedata allocation. Fixed in [v3.3.5 of Nro2NSP](https://github.com/Root-MtX/Nro2Nsp/releases/tag/3.3.5).
- [ ] Force disable save data allocation. Fixed in [v3.3.5 of Nro2NSP](https://github.com/Root-MtX/Nro2Nsp/releases/tag/3.3.5).
- [ ] Force enabling recording by editing the NROs extracted `control.nacp` at offset 0x3035 from 0 to 2 (forced).
Forced is a lot better than 1 (manual) as it allows the video to be saved. A way to enable screenshots should be done as well.
[SAK](https://github.com/dezem/SAK) has a way to do this.
- [ ] Add support for direct RetroArch Game Forwarding.
- [ ] Rewrite as a Python script to heavily improve the user-experience and code.
- [ ] Maybe a new GUI one day letting you override the icons and such?
- [ ] Rewrite as a Python script to heavily improve the user experience and code.
- [ ] Maybe a new GUI one day, and let you override the icons and such?
## Issues
The following are known issues with the original [forwarder ROM][ROM] and are currently out-of-scope of this project.
- Pressing + or using such actions to exit NROs fail. On my end it reopens the NRO but [some have crashes instead][crashes].
- Pressing + or using such actions to exit NROs fail. On my end, it reopens the NRO but [some have crashes instead][crashes].
[crashes]: <https://gbatemp.net/threads/nsp-forwarder-tool-for-12.587936/post-9465159>
@@ -77,8 +77,8 @@ Before continuing try running the homebrew from the Homebrew Launcher and see if
If it does not work through the Homebrew launcher either, then it was never the forwarder's fault and you should
check on your NRO or application installation.
Please note that using Forwarders other's have created have a good chance to not work on your system.
The location of the NRO on their system may differ to the location on your system, hence the NSP won't be able
Please note that using Forwarders others have created has a good chance of not working on your system.
The location of the NRO on their system may differ from the location on your system, hence the NSP won't be able
to load the homebrew.
### The forwarder does not launch, "The software was closed because an error occurred."
@@ -96,8 +96,8 @@ microSD card, not your PC.
## The forwarder's icon is a '?'
The `icon_AmericanEnglish.dat` is not to spec that Nintendo likes in some way. This is usually caused by the format of the
image not being a JPEG, or it has EXIF data, or an embed color space.
The `icon_AmericanEnglish.dat` is not to the spec that Nintendo likes in some way. This is usually caused by the format of the
image not being a JPEG, or it has EXIF data or an embedded color space.
I recommend stripping all EXIF metadata and saving without an Embed Color Space. You can do this quickly with ImageMagick,
`magick mogrify -format jpg -resize 256x256 -strip "C:\Users\John\Downloads\icon.png"`.
@@ -105,11 +105,11 @@ I recommend stripping all EXIF metadata and saving without an Embed Color Space.
## The forwarder randomly stopped working after a while, I changed nothing!
You most likely updated your Switch's Firmware and need to update your sigpatches. If not, you may have deleted the NRO from
your Switch's microSD card, or moved the NRO somewhere else. It cannot be moved as the built NSP loads the NRO at the specified
your Switch's microSD card or moved the NRO somewhere else. It cannot be moved as the built NSP loads the NRO at the specified
path when you ran `build`.
It's also possible the firmware update has broke the [forwarder ROM][ROM] that is used and needs to be fixed.
Firmware 9.0.0 and 12.0.0 are times the firmware has broke different forwarder ROMs in the past.
It's also possible the firmware update has broken the [forwarder ROM][ROM] that is used and needs to be fixed.
Firmware 9.0.0 and 12.0.0 are times the firmware has broken different forwarder ROMs in the past.
## Credit