GoldenNugget

Unlock your device's full potential, with iOS 27 support!

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.

Note

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

Warning

This fork implements a three-phase backup→tweak→restore workflow to prevent data loss on iOS 27. Apple has patched the partial restore method that Nugget uses. This fork preserves your data by backing it up first, then restoring it after the tweak is applied. this fork is stable, but still do backup and I AM NOT RESPONSIBLE FOR ANY DATA LOSS/BOOTLOOP CAUSED BY GOLDENNUGGET.

Discord server

Wanted support? join our Discord Server.

Features

iOS 26.2 - 27.0+

• PosterBoard: Animated wallpapers and descriptors. (Does not support Apple's system descriptor, such as iOS 16 wallpaper)
  • Community wallpapers can be found here or here
  • 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
• psysbackup: backup system plist
  • Required to make "reset tweaks" function work without damaging system.
• Status Bar (disabled on iOS 27+, no write permissions for the Speakeasy feature flag)
  • 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
  • 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+)
  • Force Solarium Fallback (iOS 26.0+, doesn't work on iOS 27 anymore)
• 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

Contributors

Thanks everyone who contributes to project! 🎉

Want to see your name here? Open Pull Request!

Star History

We think you can star this repo if you think this is a good project.

Note

Mobilegestalt

Don't even ask me for it. It will be NEVER implemented again.

Requirements:

Windows

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

Linux

• usbmuxd
• libimobiledevice

For Running Python

• pymobiledevice3
• PySide6 (PySide6-Essentials on non-Linux, selected automatically)
• ffmpeg-python (video wallpapers)
• opencv-python (video wallpapers)
• Python 3.10 or newer

All pinned deps are in requirements.txt (incl. PyInstaller for building).

CLI Commands

The bundled binary (and nugget_cli.py) exposes a small CLI:

Nugget                                # launch the GUI
Nugget apply-wallpaper [TENDIE] [--udid UDID] [--list]   # apply a .tendies wallpaper
Nugget restore-cache [--udid] [--password] [--cache-root] [--timeout MIN]
                    [--no-skip-setup] [--no-reboot]      # recover from a failed apply (Phase 5)
Nugget restore [same options]         # alias for restore-cache
Nugget skip-setup [--udid UDID]       # mark iOS setup panes as done

Each subcommand supports --help.

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.

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 main_app.py src/gui/main_window.py src/gui/pages/page.py src/gui/pages/pages_list.py src/gui/pages/main/*.py src/gui/pages/tools/*.py src/gui/dialogs/*.py src/gui/ios/*.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/tweaks/status_bar/*.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.

Contributing and forking.

See CONTRIBUTING.md, want fork instead? Then see FORKING.md

Credits

• Translations crowdsourced using gNugget-i18n repository
• [LEGACY] Old translations was crowdsourced using Nugget POEditor. Thank you everyone who assisted in the translation effort!
• LeminLimez for creating Nugget.
• Wind0ws11Aero for helping with development a lot.
• 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
• pymobiledevice3 for restoring and device algorithms.
• PySide6 for the GUI library.