Skip to content

Commit

Permalink
Preparing for 1.7 release
Browse files Browse the repository at this point in the history
  • Loading branch information
Trixarian committed Nov 20, 2023
1 parent 426efc0 commit 55224e0
Show file tree
Hide file tree
Showing 5 changed files with 73 additions and 84 deletions.
35 changes: 12 additions & 23 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,47 +1,35 @@
# NetherSX2-patch
These are Unofficial companion scripts for NetherSX2 to expand on the amazing work already done by Anon and EZOnTheEyes

![NetherSX2-Patch in Action](http://trixarian.net/nethersx2-in-action2.jpg)

They aim to do the following:
* Remove the unnecessary ad services bloat left in the apk
* Fix the RetroAchievements Notifications
* Expose more Global settings in the App Settings to the user
* Update the GameDB, Controller Support, and the Widescreen and No-Interlace Patches
* Add additional AetherSX2/NetherSX2 spesific fixes to the GameDB
* Resign the APK to Remove the Play Protect Warning

The Update Script can also be used to reupdate the GameDB, Controller Support, and Widescreen and No-Interlace Patches at a later date

Note: This **ONLY** works with NetherSX2. They will break AetherSX2 if used with it
The Script can also be used to reupdate the GameDB, Controller Support, and Widescreen and No-Interlace Patches at a later date

## Prerequisites
Windows:
* Windows Vista or higher
* [The Java(TM) SE Development Kit](https://www.oracle.com/java/technologies/downloads/#jdk20-windows)
* [The Java(TM) SE Development Kit](https://www.oracle.com/java/technologies/downloads/#jdk21-windows)

Linux:
* The xdelta3 package
* The OpenJDK package (this name my vary depending on your Linux Distro)
* Optional: The aapt and apksigner packages (the Linux version uses it's own binaries if these packages aren't installed)

All:
* A copy of the NetherSX2 APK (see below on how to build it)
* A copy of the NetherSX2 APK

The rest comes prepackaged for your convenience

## Getting a copy of the NetherSX2 APK
The best method is to use EZOnTheEyes' guide to build it yourself:

[![NetherSX2 Installation and Usage Guide](http://img.youtube.com/vi/2y3uRlYq4SY/0.jpg)](http://www.youtube.com/watch?v=2y3uRlYq4SY)

Alternatively, NetherSX2-builder and xdelta patch in the Downloads section can be used to create a copy of NetherSX2 with these changes pre-applied

## Using these scripts
Once you have a copy of the NetherSX2 APK named 15210-v1.5-4248-noads.apk, drop it in the same folder as patch-apk.bat
1. Run patch-apk.bat to patch your NetherSX2 APK to the latest version. This will reduce the APK size by about 400KB
2. Copy the now modified version of 15210-v1.5-4248-noads.apk back to your phone and install it using your File Manager
1. Run patch-apk.bat to patch your self-provided copy of the AetherSX2 4248 apk or to download a copy for you
2. Allow it to finish patching, building and signing your copy of NetherSX2
3. Copy the 15210-v1.5-4248-noads[patched].apk file to your phone and install it using your File Manager

You can now use update-files.bat with the above APK to update the GameDB, Controller Support, and the Widescreen and No-Interlace Patches at a later date without needing to repatch it each time
You can now rerun patch-apk.bat with the above APK to update the GameDB, Controller Support, and the Widescreen and No-Interlace Patches at a later date without needing to repatch it each time

**Linux version:**

Expand All @@ -58,9 +46,9 @@ Credit: [TheKingFireS](https://github.com/TheKingFireS)
And there you go, you should now have an updated and bug fixed copy of NetherSX2 on your phone!

## Downloads
* [NetherSX2-builder.zip](https://github.com/Trixarian/NetherSX2-patch/releases/download/1.6/NetherSX2-builder.zip) - Alternate way to build the NetherSX2 APK for yourself with these fixes already pre-applied. It can be used with these scripts to update it's contents
* [NetherSX2-patch.zip](https://github.com/Trixarian/NetherSX2-patch/releases/download/1.6/NetherSX2-patch.zip) - Copy of these scripts. They're meant to be used with a NetherSX2's APK. See above on how to generate it
* [nethersx2.xdelta](https://github.com/Trixarian/NetherSX2-patch/releases/download/1.6/nethersx2.xdelta) - The xdelta patch that can be applied to the AetherSX2 4248 apk with any patching program that supports the format and comes with all the changes pre-applied. This allows the creation of NetherSX2 on systems other than Windows, including Android when using the UniPatcher application
* [NetherSX2-builder.zip](https://github.com/Trixarian/NetherSX2-patch/releases/download/1.7/NetherSX2-builder.zip) - Alternate way to build the NetherSX2 APK for yourself with these fixes already pre-applied. It can be used with this script to update it's contents
* [NetherSX2-patch.zip](https://github.com/Trixarian/NetherSX2-patch/releases/download/1.7/NetherSX2-patch.zip) - Copy of this script
* [nethersx2.xdelta](https://github.com/Trixarian/NetherSX2-patch/releases/download/1.7/nethersx2.xdelta) - The xdelta patch that can be applied to the AetherSX2 4248 apk with any patching program that supports the format and comes with all the changes pre-applied. This allows the creation of NetherSX2 on systems other than Windows, including Android when using the UniPatcher application


NOTE: No APKs are provided due to licensing issues. You have to build it yourselves using the above methods
Expand All @@ -69,6 +57,7 @@ NOTE: No APKs are provided due to licensing issues. You have to build it yoursel
* PCSX2: <https://github.com/PCSX2/pcsx2>
* AetherSX2: <https://www.aethersx2.com/archive/>
* EZOnTheEyes: <https://www.youtube.com/@EZOnTheEyes>
* Xdelta-GPL: <https://github.com/jmacd/xdelta-gpl>
* cmdcolor: <https://github.com/alecmev/cmdcolor>
* md5sums: http://www.pc-tools.net/win32/md5sums
* Android Keystore: <https://github.com/jorfao/pkStore>
Expand Down
Loading

0 comments on commit 55224e0

Please sign in to comment.