Go to file
2023-04-15 22:57:23 -03:00
3rdparty more cpuinfo changes 2023-03-13 21:55:04 -03:00
bin GS: Unify constant buffers between renderers 2023-04-15 22:57:23 -03:00
cmake CMake: Fix package mode 2023-03-14 14:55:23 -03:00
common Add files 2023-01-22 07:44:12 +00:00
linux_various Add files 2023-01-22 07:44:12 +00:00
locales Add files 2023-01-22 07:44:12 +00:00
nsis Add files 2023-01-22 07:44:12 +00:00
pcsx2 GS: Unify constant buffers between renderers 2023-04-15 22:57:23 -03:00
tests Add files 2023-01-22 07:44:12 +00:00
tools Add files 2023-01-22 07:44:12 +00:00
.clang-format Add files 2023-01-22 07:44:12 +00:00
.codacy.yaml Add files 2023-01-22 07:44:12 +00:00
.gitattributes Add files 2023-01-22 07:44:12 +00:00
.gitignore Add files 2023-01-22 07:44:12 +00:00
.gitmodules Add files 2023-01-22 07:44:12 +00:00
CMakeLists.txt CMake: Fix package mode 2023-03-14 14:55:23 -03:00
COPYING.GPLv3 Add files 2023-01-22 07:44:12 +00:00
COPYING.LGPLv3 Add files 2023-01-22 07:44:12 +00:00
README.md Adiconado vulkan a TODO list 2023-03-17 15:52:17 -03:00
toolchain.cmake Add files 2023-01-22 07:44:12 +00:00

AetherSX2/AetherPurpleSX2 Source

Since this source was leaked to the public, no one has been interested in correcting it and actually making it happen; well it's here.


  • ⚠️ Note that this is not the full source version of the library, just the LGPL source and modified portions of it. The LGPL does not require full source code to be released, only closed source components may be relinked/combined into LGPL components and build instructions, included as per section 4/5 of the license.

  • ⚠️ Since the source of the App (apk) is not public or leaked yet, a "shell" apk is needed to make the build work.

  • ⚠️ Also note that this source is very old (2021), it's the only one we have to work with, every contribution is welcome.


Things to do:

  • Make source buildable
  • Approximate git history (check 'git-his' branch)
  • New contributors, PRs
  • Update to the latest NDK/SDK
  • Update PCSX2 code
  • Vulkan renderer
  • Add features from the latest AetherSX2
  • App completely decompiled and redone (reverse engineering)
  • several other things

Dependencies and requirements

You will need:

  • Android Studio/Android Studio Dependencies & SDK
  • Cmake (latest or 3.22.1)
  • Linux distro (Personally I recommend 22.04 LTS)
  • NDK Specifically R23c
  • Approximate 60GB free space and 8GB ram machine (minimum)
  • Shell apk HERE

Build Steps

First, I recommend installing Android Studio, and installing the latest ndk and then downloading sdk 31.

Build Dependencies:

sudo apt install build-essential gcc g++ cmake make ninja-build git wget openssl zipalign apksigner zip unzip openjdk-19-jre-headless -y
  • Creating libemucore.so:
  1. Extract NDK to any easily accessible place and rename it to something easy like 'ndk'
  2. Clone source:
git clone https://github.com/MrPurple666/AetherSX2 -b main
  1. Creating necessary folders:
mkdir build-android && cd build-android && mkdir apk
  1. Configure the CMAKE system (Change ndk_folder to your ndk path):
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=/ndk_folder/build/cmake/android.toolchain.cmake -DANDROID_PLATFORM=android-26 -DANDROID_ABI=arm64-v8a ..
  1. Building libemucore library:
make -j8
  1. Doing repack with "apk shell" and the new library:
cd apk
  • Change apk_path to your shell apk file location.
cp /apk_path/purplesx2.apk .
mkdir -p lib/arm64-v8a && cp ../pcsx2/libemucore.so lib/arm64-v8a
zip -0 purplesx2.apk lib/arm64-v8a/libemucore.so
  1. Align and signing apk:
zipalign -p 4 purplesx2.apk purplesx2-aligned.apk
keytool -genkey -v -keystore keyname.keystore -alias keyname -keyalg RSA -keysize 2048 -validity 10000
  • change pass_keystore to the password you created when generating your signature
apksigner sign --ks keyname.keystore --ks-pass "pass:pass_keystore" --ks-key-alias keyname --out purplesx2-signed.apk --verbose purplesx2-aligned.apk

DONE, you will get the app installable and functional.

Full credits to Talreth/Stenzek.


Special thanks:

  • Jonas Angel
  • Mis012 (git history approximation)
  • Gamer64yt
  • GiovanYCringe
  • Hacobotdev
  • All the people who supported me and support emulation projects, my sincere thanks ♥️💜♥️.