bbhunter / supersu-patcher

SuperSU Patcher

SuperSU patcher, also known as SuperNU, is a utility that patches the SuperSU binaries to evade common root detection techniques. This is done by simply patching the su binaries and associated references to nu.

SuperSU Patcher was tested on a OnePlus 5t using SR5-SuperSU-v2.82-SR5-20171001224502, steps to root can be found here. A full write-up of this utlity can be found here.

Basic Usage

Run the run.py python3 file and pass the SuperSU archive as a parameter as seen below:

python3 run.py -i <path_to_supersu_archive>

Further Usage

For further usage instructions please refer to the help dialogue.

➜ python3 run.py --help

usage: run.py [-h] [-q] [-p] [-o DIRECTORY] -i SUPERSU ZIP

supersu patcher

optional arguments:
  -h, --help            show this help message and exit
  -q, --quiet           don't print status messages to stdout
  -p, --purge           purge output directory before running
  -o DIRECTORY, --ouput DIRECTORY
                        output directory for final artifacts

required arguments:
  -i SUPERSU ZIP, --input SUPERSU ZIP
                        input super su file to patch

System Dependencies

This project requires radare2 to be installed on the system.

Python3 Dependencies

All the python3 dependencies are documented in the requirements.txt file, to install the dependencies run:

python3 -m pip install -r requirements.txt

References / Inspiration

• Common Root Detection Methods
• Google SafetyNet
• Magisk
• Magisk Hide
• SuperSu
• Root Cloak