leminlimez / Nugget

Unlock the fullest potential of your device
GNU Affero General Public License v3.0
1.42k stars 107 forks source link

Nugget

Unlock your device's full potential!

Sparserestore works on all versions iOS 17.0-17.7 and iOS 18.0-18.1 beta 4. There is partial support for iOS 17.7.1 and iOS 18.1b5-18.2 beta 2.

iOS 18.2 developer beta 3 (public beta 2) and newer is not supported.

This uses the sparserestore exploit to write to files outside of the intended restore location, like mobilegestalt. Read the Getting the File section to learn how to get your mobilegestalt file.

Note: I am not responsible if your device bootloops. Please back up your data before using!

Features

Running the Program

Requirements:

Note: It is highly recommended to use a virtual environment:

python3 -m venv .env # only needed once
# macOS/Linux:  source .env/bin/activate
# Windows:      .env/Scripts/activate.bat
pip3 install -r requirements.txt # only needed once
python3 main_app.py

Note: It may be either python/pip or python3/pip3 depending on your path.

The CLI version can be ran with python3 cli_app.py.

Getting the File

You need to get the mobilegestalt file that is specific to your device. To do that, follow these steps:

  1. Install the Shortcuts app from the iOS app store.
  2. Download this shortcut: https://www.icloud.com/shortcuts/d6f0a136ddda4714a80750512911c53b
  3. Save the file and share it to your computer.
  4. Place it in the same folder as the python file (or specify the path in the program)

Building

To compile mainwindow.ui for Python, run the following command: pyside6-uic qt/mainwindow.ui -o qt/ui_mainwindow.py

To compile the resources file for Python, run the following command: pyside6-rcc qt/resources.qrc -o resources_rc.py

The application itself can be compiled by running compile.py.

Read More

If you would like to read more about the inner workings of the exploit and iOS restore system, I made a write up which you can read here.

Credits