
Nugget
Unlock the full potential of iOS 17.0 - 26.0 devices!
Sparserestore is available for all versions of iOS 17.0-18.2 Developer Beta 2. For iOS 18.2 Developer Beta 3 and later, partial support is available.
Mobilegestalt and AI Enabler tweaks are not supported on iOS 18.2+. They will not be supported in the future either, so please don't ask questions about when they will be supported.
If you are using Windows or Linux, make sure the requirements are installed.
This tool uses the sparserestore vulnerability to write files to an area other than the intended recovery location, such as mobilegestalt. read the Getting the mobilegestalt file section of this article to learn how to get the mobilegestalt file.
Note: Nugget developers and sharers are not responsible if a boot loop occurs on your device. Please backup your data before use!
functionality
- status line
- Change of carrier name
- Change Alternate Operator Name
- Enable/disable primary or secondary carrier
- Changing the number of WiFi/cell phone signal frames
- Changing Battery Capacity
- Replacement Battery Display Details
- Change time text
- Changing the date text (iPad only)
- Changing the breadcrumb navigation text
- Displays WiFi/cellular network signal strength (in numeric form)
- Hide or show multiple icons in the status bar
- Desktop Options
- Setting the lock screen footer
- Setting the lock screen idle auto-lock time
- Disable locking after reboot
- Disable screen dimming while charging
- Turn off low battery alerts
- Hide AC power in the lock screen interface
- Display Regulatory Text on Lock Screen
- Displaying dynamic islands in screenshots
- Enable AirPlay support for Stage Manager
- Show red/green authentication line on lock screen interface
- Disable floating tab bar on iPad
- Internal Options
- Disable Liquid Glass (iOS 26.0+)
- Ignore Liquid Glass app build checks (iOS 26.0+)
- Enable Key Slide on iPhone (iPad-style keyboard) (iOS 26.0 and later)
- Version information in the status bar
- Forced right to left
- Show hidden icons on the home screen
- Forced Metal HUD Debugging
- iMessage Diagnostics
- Diagnosis of IDS
- VC Diagnostics
- App Store Debugging Gestures
- Memo Application Debug Mode
- Display touch with debug information
- Hide the reboot icon
- Play sound on paste
- Show system paste notification
- Disable the daemon:
- OTAd
- Usage Tracking Agent
- Game Center
- Screen Time Agent
- Logs, dump files and crash reports
- wake up
- Tipsd
- VPN
- Chinese wireless LAN service
- Health Toolkit
- AirPrint
- Auxiliary touch
- iCloud
- Network sharing (aka personal hotspot)
- (bank) deposit book
- spotlights
- voice control
- Risk (hidden) option:
- Disable temperature monitoring
- PosterBoard: dynamic wallpapers and descriptors.
- Wallpapers can be found here
- Convert video to wallpaper
- Customize community-made wallpapers with batter files
- View the structure of the tendies file in Documentation.md
(computer) file
Tendies files (PosterBoard wallpapers)
The Tendies file stores the structure of the files to be restored to PosterBoard.
These files are available in two formats:
1. Container format: A folder named "container".
This format reverts directly to the application container located within /var/mobile/Containers/Applications/PosterBoard.app and maintains that file structure.
When using this format, the descriptor UUID and wallpaper ID are not randomized.
2. Descriptor format: A folder named "descriptor" or "descriptors".
The format reverts to the descriptor inside the container. Currently, it reverts to the 61 folder, but may be handled in future releases, if needed, depending on the iOS version. Future versions of Nugget may automatically handle this if the structure changes.
The descriptors UUID and Wallpaper ID are randomized to prevent duplication.
This format is recommended if you are restoring descriptors to a collection because it will be more future compatible. randomization of IDs is also more secure.
- Risk (hidden) option:
- Disable thermalmonitord
- OTA Killer
- Customized Resolution
- Enable dynamic islands on any device
- Enabling iPhone X gestures on iPhone SE
- Change the device model name (i.e. the name displayed in the Settings application)
- Enable startup ringtone
- Enable Charge Limit
- Enable "Wake on Tap" on unsupported devices (e.g. iPhone SE)
- Enable Crash SOS
- Enable Stage Manager
- Disable wallpaper parallax
- Disable area restrictions (e.g. shutter sound)
- Note: This does not include enabling EU sideloading outside of the EU. This will be rolled out at a later date.
- Show Apple Pencil options in the Settings app
- Showing the Action Button option in the Settings application
- Display internal storage information (may cause problems on some devices at your own risk)
- EU Launcher (iOS 17.6-)
- Feature Flag (iOS 18.1b4-):
- Enable lock screen clock animation, lock screen page copy button, etc!
- Disable the new iOS 18 photo UI (iOS 18.0 beta only, unknown which version patched it)
- Enabling the iPhone 16 Camera Button Page in the Settings App
- Enabling AOD and AOD Vibrancy on Any Device
- Enabling AI
- device spoofing
Request:
- Turn off Find My iPhone when in use
- Windows:
- Must be installed iTunes(From Apple's website)
- Linux:
- Must be installed usbmuxd respond in singing libimobiledevice
- Required to run Python:
- pymobiledevice3
- PySide6
- Python 3.8 or higher
Running a Python Program
Note: The use of a virtual environment is highly recommended:
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: Depending on your path, you may need to use python/pip or python3/pip3.
The CLI version can be started by running python3 cli_app.py.
Get mobilegestalt file
You need to get the mobilegestalt file specific to your device. The steps are as follows:
- Install the Shortcuts app from the iOS App Store.
- Download this shortcut:Click to download
- Save the file and share it to your computer.
- Place the files in the same folder as the Python files (or specify the path in the program).
construct (sth abstract)
To compile for Python mainwindow.ui, please run the following command:
pyside6-uic qt/mainwindow.ui -o qt/ui_mainwindow.py
To compile a resource file for Python, run the following command:
pyside6-rcc qt/resources.qrc -o resources_rc.py
This can be done by running the compile.py to compile the application itself.
update a record
v7.0.2 (latest)
- Practically fixed an issue where applying adjustments from other non-BookRestore classes failed.
- The "Enable iPadOS Mode" option is now only available when you turn the "Show Risky Options." It will not be shown until after.
- When developer mode is not enabled on the system, Nugget now shows the entry to enable developer mode in Settings (instead of trying to force it on).
New features since v7.0
✦ Function
- MobileGestalt-related tweaks are now supported! iOS 18.2 - iOS 26.1 (+ iOS 26.2 beta 1)and through BookRestore Make an application.
Attention:- Creating a tunnel to a device requires administrator privileges (a limitation of pymobiledevice3).
- Needs to be turned on iOS Developer Mode (Developer Mode)The
- Added for iOS 26 iPhone Air Dynamic island subtype (dynamic island subtype)The
- Add to iPhone iPadOS Mode(Not recommended).
- SpringBoard and Internal Options changed to radio buttons to force enable/disable.
- Added several new internal adjustments related to Liquid Glass:
- Disable Liquid Glass on Lock Screen Clock
- Disable Liquid Glass for Dock
- Renamed "Disable Liquid Glass" to "Force Solarium Fallback", a new feature in the iOS 26.1+ On the effective.
- New in SpringBoard Options: Disable AirDrop's "Everyone" time limit.
- add a pair of MercuryPoster tendies respond in singing ordered video descriptors of support.
✦ Bug Fixes
- Refactoring the backend logic to improve future scalability.
- Fix application failure due to file merge issue in some templates.
- Improve some error messages.
v7.0.1 (unstable, Pre-release)
- The resolution is adjusted at iOS 18 and below It should be applied normally through routine recovery methods.
- When developer mode is not enabled, Nugget tries to enable developer mode automatically if it tries to apply configuration (not verified).
- Added a new acknowledgement to Duy on the home page when using the BookRestore exploit.
v7.0 (unstable, Pre-release)
The following is essentially the same as v7.0.2, and only the original official instructions for this version are listed.
functionality
(ditto: MobileGestalt support, iPhone Air dynamic island types, iPadOS mode, Liquid Glass tweaks, AirDrop time limits, etc.)
Bug Fixes
- Backend rewrite to improve scalability.
- Fix the error caused by merging template files.
- Improved error alerts.
herald
- BookRestore still unstable, which will continue to be fixed subsequently.
- Linux may not be working properly at this time.
suggestion
If you're having trouble with adjustments other than BookRestore.Temporarily fall back to v6.2.3 It will be more stable.
v6.2.3
- Added the ability to disable liquid glass
- Added ability to ignore Liquid Glass app build checks
- Disable/hide unsupported tweaks in new releases:
- Disabling metal HUD and resolution changer hidden in iOS 26.0
- Swipe button option hidden in iOS 26.1
- Fixed an issue where supervision did not work properly when there was no organization in place.
v6.2.2
- For compiled applications:
pymobiledevice3The executable has been updated with other libraries.- Hopefully this will improve the security of the app.
- Nugget Now Uses Existing Cloud Configuration Preferences
- If you are already regulated by an organization, Nugget will no longer override the existing organization name.
- Added key package details for organization name when regulation is enabled (internal change)
- Fixed the issue where fool mode could not be disabled without restarting the app.
- Fixed a bug caused by missing ownership values for some adjustments (e.g. the "Clear ScreenTimeAgent.plist file" adjustment).
- The macOS Intel version has been compiled using GitHub Actions instead of Rosetta. Please let us know if it still doesn't start.
v6.2.1
- Fixed an issue where the application would not start
- Fixed a bug where the application would randomly error out under certain circumstances
v6.2
hallmark
- Added ability to remove individual page adjustments
- Multiple new springboards and internal options
- Enable key swipe on iPhone (iPad-style keyboard)
- Hidden AC Power
- There's still time until the lock screen automatically locks
- Force icon visibility
- Displaying dynamic islands in screenshots
- Show red/green authentication line on lock screen
- Disabling the NanoTimeKit Daemon
- Disable the system diagnostic daemon
- Show accessory developer settings
- Forced left-to-right layout
- Disable floating tab bar (iPad only)
- Added video calculation mode selection (linear vs. discrete)
- Change "Export video as descriptors" to "Export as .tendies"
- Added the ability to disable the system diagnostic daemon
- More crash reporting daemons are now disabled
bug fix
- Plist files are now merged when applying templates, so you can now have multiple templates modifying the same file.
- Fixed issues related to .globalPreferences.plist template not being applied
- Additional security improvements added to the application process
v6.1.1
- Changed the way hashes are written to Pocket Poster (requires Pocket Poster v2.0.2 or later)
- For earlier versions of Pocket Poster, use Nugget v6.1 or earlier.
- Multiple languages have been added:
- Abkhazia, region in Georgia
- Chinese (Simplified)
- Germany (Australia)
- French (Belgium)
- Irish
- Indonesia
- Italian (language)
- Portuguese (language)
- Updated some existing languages
- Fixed status bar application issue on Windows systems
- Fixed an issue where macOS Intel would not start.
v6.1
hallmark
- Translations in 20 new languages have been added!
- Available languages: Spanish, Spanish (Mexico), French, French (Canada), German, Russian, Japanese, Chinese (Taiwan), Vietnamese, Thai, Korean, Polish, Turkish, Hungarian, Dutch, Czech, Bulgarian, Arabic, Arabic (Saudi Arabia), Arabic (Egypt)
- Thank you to all the talented translators who helped make this project more accessible to the general public! Without you, none of this would have been possible!
- Added the ability to change the date in the iPad status bar
- Added warning/disclaimer for iOS 26 beta users
- In addition, the Risky Plugins page has been removed from iOS 26 as many plugins no longer work as expected.
- Added ability to get CarPlay app hashes to Pocket Poster Assistant (initial support for Pocket Poster v3.0)
bug fix
- Fixed macOS Intel not opening
- Fixed Windows settings not being saved
- Fixed the issue that the scroll bar would not reset when returning to the page
v6.0
hallmark
- Add new template! Restore customized files and domains
- New adjustments to the status bar: you can change the name of the operator, etc!
- Lock screen footer restored
- Reorganized some tweaks into other options to make the sidebar look cleaner.
hiddendotAdded support for battery files like Cowabunga Lite.- Usage examples:
Container/mobile/hiddendotGlobalPreferences.plist
- Usage examples:
- Updated skip settings for iOS 26
- Added option to toggle TrustStore recovery
- Safety Improvements to Restore Operations
- Support for Ubuntu 20 and higher
bug fix
- Optimized the entire tweak backend for faster loading/application and a smoother app experience.
- Fixed a bug where iOS 18.2 and later devices could not be selected.
- Fixed Windows path error for bundle paths (e.g. TrustStore)
- Fixed device link error when using PosterBoard/templates on Windows systems
- Fixed preview image height
- Fixed issue where sometimes error messages were not displayed/threw other errors
- Fixed folder recovery issue with same path but different domain names
v5.2.3
- Added Pocket Poster help button for getting application hashes
- The "Remove all tweaks" button now removes applied daemons.
- Removed lock screen footer tweak to investigate cause of startup loop on iOS 18.5 (will return in a future update)
- Fixed issue where Sparserestore adjustments and domain adjustments could not be applied at the same time
v5.2.2
Fix battery file that crashes when using the toggle settings option
Fixed an issue with parsing battery values that would cause an error when applied
Designed for macOS Intel
v5.2.1
Embedding ffmpeg into a Windows application so that the conversion works properly
Fixed a bug where Windows could not convert other formats to mov
Fixed issues related to battery file setting options
v5.2
new feature
PosterBoard:
- Added PosterBoard template (
.batter(Documentation)! - Designers can let you customize certain aspects of the wallpaper in an easy-to-use menu
- Added live photo wallpaper for iPhone (not looped)
- Support for larger video files
- Videos can now be exported as descriptors (for tendies files, just compress and rename them to
.tendies(extension) - PosterBoard no longer requires you to click the "Modify" button to apply changes.
- New drop-down menu for selecting PosterBoard options to reset/clear
- Added risk option to ignore PosterBoard video frame limitations
- New ordered descriptor option:
- Put them in a file named
ordered-descriptorsYou can sort the files in the order of their names in the folder of - Recovery progress is now displayed when applying
- Added for importing
.tendiesrespond in singing.batterStartup parameters for the file
Other updates:
- Nugget is now code signed for macOS arm and Windows!
- The macOS arm version is now packaged as
.dmgspecification
bug fix
- Refresh Device button no longer causes apps to freeze
- Improved error messages related to connection errors
- Small improvements in connection stability during application
- Fully optimized and refactored GUI backend (Nugget should be faster now)
- Identifiers are now randomized only for the descriptor itself, not for subidentifiers
- Fixed visual issue where pages were not initially hidden
- Python now has a Nugget icon!
- Various other minor bug fixes
v5.1.2
- Fixed file permission issues related to TrustStore
New since v5.1.1:
new feature
- new pair
.mkvVideo support - Increase frame rate limit to 400 fps
- Added PosterRestore team name to acknowledgements
bug fix
- Fixed TrustStore causing corrupt configuration descriptors after recovery (thanks @Lucas04-nhr)
- Fixed bug where an error message would appear if the mobilegestalt file was not selected
- Fixed an issue that prompted not to unplug the cable even when the device was connected via Wi-Fi
- Optimized the search for devices in the
PasswordRequiredErrordraw attention to sth. - Fixed several bugs when applied on Windows
v5.1
new feature
- Added the ability to import videos as wallpapers (support)
.mp4maybe.mov(Format) - Option to reverse the video on loop and choose whether to have the video cover the clock area or not
- Automatically scales to fit your device's resolution
- Note: The video frame rate is limited to 300 frames
- Added additional crash reporting and WiFi WAPIC daemon disabling options
- Improved prompts on some labels to make them easier to understand
bug fix
- Apply button no longer causes the program to freeze
- fixed
.tendiesCrashes caused by files containing files outside the container in the file - Fixed the Nugget popup that kept popping up when importing more than 10 tendies
- Fixed an issue where mobilegestalt could not be applied when applying Daemons or PosterBoard modifications
- Optimized the application flow of PosterBoard changes
v5.0.3
- Move the PosterBoard tab to the top, as this is the most popular feature
- Fixed an error triggered when trying to delete a temporary file after the app is finished
- Windows: Fixed FileNotFoundError caused by applying long path tendies file when path length is set to 256 characters.
- Note: Windows Defender may generate false positives due to the nature of the compiled Python program.
I'm filing a complaint with Microsoft, but for now you may need to allow the file to run in your settings.
v5.0.2
- Added iOS 16 support for PosterBoard
- Note: Currently only works for descriptors, not for containers
- Not all wallpapers work
- Removed Windows path repair option
- If you encounter problems, disable the Windows path length restriction:Links to related notes
- Fixed issue where skipping settings would cause recovery to fail
- Fixed an issue where the PasswordRequiredError prompt was not displayed
- This release has been compiled and tested on real Windows hardware to ensure security and functionality. If there are still antivirus false positives, I will try other programs.
v5.0.1 Latest Version
- Added option to disable Windows Path Repair
- Resetting the collection now also resets the mercuryposter.
- Fixed issue where skip settings did not take effect when adjusting with Posterboard
- Recompiled the bootloader on Windows.
v5.0
This version is outdated, the latest version can be found here.
- PosterBoard is here! Apply dynamic wallpapers using .tendies files
- Community wallpapers can be found here
- Documentation for the tendies file can be viewed in documentation.md
- This feature supports iOS 17.0+, including non-sparserestore versions (iOS 18.2 - iOS 18.4 beta+)
- The device selector now shows whether the device is connected via USB or WiFi
- Backend change: app domains are now supported in the backup API (automatically handled when a bundle ID is provided)
- Fixed Windows-specific glitches
- Minor improvements to error handling during application
- Mobilegestalt tweaks will never be supported on iOS 18.2+
v4.2.3
- Added option to restore patched versions of rdar fixes in the settings page
- Check that thermalmonitord now automatically enables daemon modification switching
- Fixed daemon not being applied in v4.2.2
- Fixed issue with custom gestalt keys not being applied
- I manually compiled the Windows bootloader again, let me know if it is still detected as a virus.
- NOTE: Mobilegestalt tweaks will never be supported on iOS 18.2+, please do not ask questions about this.
v4.2.2
This version is outdated, the latest version can be found here.
- Added 7 new daemon disabling options:
- HealthKit
- AirPrint
- Assistive Touch
- iCloud
- Internet sharing (i.e., personal hotspots)
- PassBook
- Spotlight
- Voice Control
- Fixed issue when Sparserestore tweaks failed to apply daemon
- Fixed issue with displaying Mobilegestalt tags on unsupported versions
v4.2.1
This version is outdated, the latest version can be found here.
- Fixed Mobilegestalt adjustments not being applied
- Fixed issue where skip settings were applied in the Sparserestore version even though they weren't needed
- Added warning about applying adjustments when Mobilegestalt file is not selected
- Minor optimization of the adjusted back-end
- NOTE: Mobilegestalt tweaks will never be supported on iOS 18.2+, please do not ask questions about this.
- For a list of changes in v4.2, see the update log for the previous version.
v4.2
This version is outdated, the latest version can be found here.
functionality
- Added daemon disabling feature
- Should work on all versions, including iOS 18.2+
- Requires a regular domain name on the Sparserestore version
- The daemon includes:
- OTAd
- UsageTrackingAgent
- Game Center
- Screen Time Agent
- Logs, dumps and crash reports
- ATWAKEUP
- Tipsd
- VPN
- thermalmonitord (in the risk tab)
- China WLAN Services
- HealthKit
- AOD brightness restored (seems to fix AOD issues on some devices)
- Added tooltips to most tweaks explaining what they do (i.e. hover over options)
- Added option to show all spoofable device models
- Disabled "Old Photo UI" and Feature Flag AI option on unsupported versions (excludes 18.0 RC, may hide this option later)
- Reduced executable file size by removing unnecessary libraries
- Added error message if there may be a problem with the cable
- The update dialog box is displayed when an update is available
- Added warning that skip settings are enabled on the application page
bug fix
- Fixed minor issues in the vulnerability code of the Sparserestore version
- Fixed skip settings causing an error when applying iOS 18.2db3+
- Fixed an issue where when selecting a Mobilegestalt file for a new device, it incorrectly replaced the old file and clicked cancel
- Fixed a crash that could be caused when selecting a Mobilegestalt file
v4.1
functionality
- Added new risk adjustment options
- These options must first be enabled in the settings
- Options include:
- OTA Disabler
- Customized Resolution Setter
- Disclaimer: I am not responsible for what you do to your device. If you set a bad resolution and brick the device, the responsibility is yours.
- Added supervisory features (need to skip settings)
- Added more cheatable iPad models
- Changed how container domains are handled in the patched version (iOS 18.2 Developer Beta 3+)
- These versions are still not and will never be fully supported
- Added more appropriate error messages
- Optimized builds for compilation
bug fix
- iOS 18.2 Developer Beta 3 (Public Beta 2) now shows "unsupported" and hides unsupported tweaks
- Fixed an issue where spoofed devices were not really canceled when they were set to "None".
- Correctly fixed the X gesture on the iPhone SE (it should now be 16:9, not stretched)
- Removed experimental switching
- Hide eligibility switching on unsupported versions
- Fixed disabling battery warning and disabling dimmer toggle
- iPhone model spoofing will now be hidden on iPads (and vice versa)
- Fixed issues caused by X gestures on newer iPhones (this has been a natural choice)
- Removed the mini icon fix in the status bar
- Removed accessory developer options (seems very insecure on iOS 17.0+)
v4.0.1
functionality
- AI Spoofing Now Spoofs CPU and Hardware Models
- Improved method of skipping settings
- Resolved configuration file reset issue
- Added more models that can be cheated
- Added a warning that the Mobilegestalt file has not yet been added
bug fix
- Improved error messages/handling when applying
- Fixed crash when the "Apply via WiFi" toggle was turned off when no USB devices were detected but there were WiFi devices
- Fixed AI spoofing not working on newer versions of iOS 18.1
- Fixed wrong model label name for cheating
- Fixed rdar fix that would not restore
v4.0
functionality
- Supports iOS 18.1 beta 5+ and iOS 17.7.1 with Cowabunga Lite's Skip Settings
- Added customized Mobilegestalt keys! Do this at your own risk, it can be very dangerous.
- You can now select the device model you want to spoof for use in AI Enabler
- Added button to reset device pairing (use if you have problems when applying)
- Added the ability to disable automatic reboot
- The device build number is now displayed
- Hidden feature flags and EU Enabler on unsupported versions
bug fix
- Now save device models to better restore spoofing
- Improved error messages/handling
- Fixed crash caused by missing dependencies at startup (Windows and Linux)
- Fixed issue with setting options not being saved
- Other minor fixes in equipment management
v3.0
- Synchronization with Nugget (mobile)
- Added Springboard option
- Added internal options
- Added AI Enabler for unsupported devices (in the Eligibility tab)
- Added rdar/status bar fix
- Added a "Find My Friends" toggle.
- Removed sleep apnea adjustment (added as a joke only, not actually valid)
- iOS 18.1 beta 5 now shows "unsupported" text
- Refactored vulnerability code
- Updated license to GPLv3
v2.2
- Added Wake on Tap to iPhone SE
- Added sleep apnea (real function)
- Added iPhone 16 Pro/Max dynamic island subtype
- AOD Brightness removed (invalid)
- Fixed CLI (broken in v2.1.1)
- Improved stability of Mobilegestalt tweaks on iOS 18.0 RC
- Read README.md to learn how to get the Mobilegestalt file.
v1.2
- Enable AOD
- Enable Action Buttons
- Enabling the Apple Pencil
- Switching internal storage information
- Please use these new settings with caution
v1.1
- Added option to remove region restriction/remove camera shutter sound
v1.0.1
- Fixed issues with python versions below 3.11
v1.0
- initial version







