Nugget

Unlock your device's full potential!

Customize your device with animated wallpapers, disable pesky daemons, and more!

Make sure you have installed the requirements if you are on Windows or Linux.

[!WARNING] DO NOT USE THIS ON iOS 27! It will most likely result in data loss. Apple has patched the partial restore method that Nugget uses.

[!NOTE] Please back up your data before using this Project! Nugget may cause unforeseen problems, so it is better to be safe than sorry. We are not responsible for any damage done to your device.

Features

iOS 17.0 - 26.0+

• PosterBoard: Animated wallpapers and descriptors.
  • Community wallpapers can be found here
  • Converting videos to wallpapers
  • Customizing community-made wallpapers via batter files
  • See documentation on the structure of tendies and batter files in documentation.md
• Templates: Custom Operations and file editing
  • See documentation on the structure of batter files in documentation.md
• Status Bar
  • Change carrier name
  • Change secondary carrier name
  • Enable/Disable the primary or secondary carriers
  • Change the number of WiFi/Cellular bars
  • Change the battery capacity
  • Change battery display detail
  • Change time text
  • Change date text (iPad only)
  • Change breadcrumb text
  • Show numeric WiFi/Cellular strength
  • Hide or show many icons in the status bar
• Springboard Options
  • Set Lock Screen Footnote
  • Set Lock Screen Idle Auto-Lock Time
  • Disable Lock After Respring
  • Disable Screen Dimming While Charging
  • Disable Low Battery Alerts
  • Hide AC Power on Lock Screen
  • Show Supervision Text on Lock Screen
  • Show Dynamic Island in Screenshots
  • Enable AirPlay support for Stage Manager
  • Show Red/Green Authentication Line on Lock Screen (See this issue for what it looks like)
  • Disable Floating Tab Bar on iPads
• Internal Options
  • Enabling Key Flick (iPad-style keyboard) on iPhones (iOS 26.0-)
  • Build Version in Status Bar
  • Force Right to Left
  • Show Hidden Icons on Home Screen
  • Force Metal HUD Debug
  • iMessage Diagnostics
  • IDS Diagnostics
  • VC Diagnostics
  • App Store Debug Gesture
  • Notes App Debug Mode
  • Show Touches With Debug Info
  • Hide Respring Icon
  • Play Sound on Paste
  • Show Notifications for System Pastes
• Disable Liquid Glass (iOS 26.0+):
  • Ignore Liquid Glass App Build Check (iOS 26.0+)
• Disable Daemons:
  • OTAd
  • UsageTrackingAgent
  • Game Center
  • Screen Time Agent
  • Logs, Dumps, and Crash Reports
  • ATWAKEUP
  • Tipsd
  • VPN
  • Chinese WLAN service
  • HealthKit
  • AirPrint
  • Assistive Touch
  • iCloud
  • Internet Tethering (aka Personal Hotspot)
  • PassBook
  • Spotlight
  • Voice Control
• Risky (Hidden) Options:
  • Disable thermalmonitord

iOS 17.0 - 26.1

• Mobile Gestalt:
  • Enable Dynamic Island on any device
  • Enable iPadOS on iPhones (use at your own risk)
  • Enable iPhone X gestures on iPhone SEs
  • Change Device Model Name (ie what shows in the Settings app)
  • Enable Boot Chime
  • Enable Charge Limit
  • Enable Tap to Wake on unsupported devices (ie iPhone SEs)
  • Enable Collision SOS
  • Enable Stage Manager
  • Disable the Wallpaper Parallax
  • Disable Region Restrictions (ie. Shutter Sound)
    • Note: This does not include enabling EU sideloading outside the EU.
  • Show the Apple Pencil options in Settings app
  • Show the Action Button options in Settings app
  • Show Internal Storage info (Might cause problems on some devices, use at your own risk)
  • Enable iPhone 16 camera button page in the Settings app (iOS 18.0+)
  • Enable AOD on any device (Warning: this may cause burn in)
• EU Enabler (iOS 17.6-)
• Feature Flags:
  • Enable Kiosk Mode
  • Disable Liquid Glass/Solarium (iOS 26.0 - 26.1)
  • Enable lock screen clock animation, lock screen page duplication button, and more!
  • Disable the new iOS 18 Photos UI (iOS 18.0 betas only, unknown which patched it)

iOS 18.1 - 26.1

• AI Enabler
• Device Spoofing

Requirements:

Windows

• Either the Apple Devices (from Microsoft Store) App or iTunes (from Apple website)

Linux

• usbmuxd
• libimobiledevice

For Running Python

• pymobiledevice3
• PySide6
• Python 3.9 or newer

Running the Python Program

[!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

Install Packages:

pip3 install -r requirements.txt # only needed once
python3 main_app.py

[!NOTE] Depending on your system configuration, use either python/pip or python3/pip3.

Getting the File

On iOS 26.1 and below, you may 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: Save MobileGestalt
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 --from-imports src/qt/mainwindow.ui -o src/qt/mainwindow_ui.py

To compile the resources file for Python, run the following command:

pyside6-rcc src/qt/resources.qrc -o src/qt/resources_rc.py

To create and compile languages, you can use the following commands:

pyside6-lupdate src/gui/main_window.py src/gui/pages/page.py src/gui/pages/reset_dialog.py src/gui/pages/main/*.py src/gui/pages/tools/*.py src/gui/dialogs.py src/qt/mainwindow.ui src/devicemanagement/device_manager.py src/exceptions/*.py src/tweaks/*.py src/tweaks/posterboard/*.py src/tweaks/posterboard/template_options/*.py src/controllers/*.py -ts src/qt/translations/Nugget_{language code}.ts # generate/update the language file
pyside6-lrelease src/qt/translations/Nugget_{language code}.ts -qm src/qt/translations/Nugget_{language code}.qm # compile to binary

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

Sparserestore/BookRestore Info

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.

Sparserestore works on all versions iOS 17.0-18.1.1.

BookRestore works on all versions iOS 18.2-26.1.

[!NOTE] Mobilegestalt and AI Enabler tweaks are not supported on iOS 26.2+. It will never be supported, do not make issues asking for when it is supported.

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.

Arbitrary Star Graph

Credits

• Translations crowdsourced using POEditor. Thank you everyone who assisted in the translation effort!
• JJTech for Sparserestore/TrollRestore
• Duy Tran and Huy Nguyen for BookRestore/bl_sbx
• PosterRestore for their help with PosterBoard
  • Special thanks to dootskyre, Middo, dulark, forcequitOS, and pingubow for their work on this. It would not have been possible without them!
  • Thanks to Snoolie for aar handling!
  • Thanks to SerStars for creating the website!
• disfordottie for some global flag features
• iTechExpert for various Springboard/Internal Options
• Mikasa-san for Quiet Daemon
• sneakyf1shy for AI Eligibility (iOS 18.1 beta 4 and below)
• lrdsnow for EU Enabler
• pymobiledevice3 for restoring and device algorithms.
• PySide6 for the GUI library.