mirror of
https://github.com/Threnklyn/nton.git
synced 2026-05-18 21:03:28 +02:00
README: Fix some grammar and spelling mistakes
This commit is contained in:
rlaphoenix
@@ -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 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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user