![Artboard][NuggetLogo] # GoldenNugget [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](LICENSE) [Download](https://github.com/GoldensHQ/GoldenNugget/releases/latest) · [Wiki](https://github.com/GoldensHQ/GoldenNugget/wiki) · [Report a bug](https://github.com/GoldensHQ/GoldenNugget/issues/new/choose) · [Discussions](https://github.com/GoldensHQ/GoldenNugget/discussions) > [!WARNING] > **Back up your device before applying tweaks.** GoldenNugget can cause data loss, boot loops, or other unexpected device problems. Use this project at your own risk; the authors are not responsible for damage to your device or data. See the [full disclaimer](docs/DISCLAIMER.md). Unlock your device's full potential, with experimental iOS 27 support! Customize your device with animated wallpapers, disable pesky daemons, and more! Make sure you have installed the [requirements](#requirements) if you are on Windows or Linux. ## Quick Start For a packaged app, download the archive for your platform from the [latest release](https://github.com/GoldensHQ/GoldenNugget/releases/latest). See the [installation guide](https://github.com/GoldensHQ/GoldenNugget/wiki/Installation-and-first-launch) for setup help. ## Running from source Requirements Python 3.10+ Qt 6.12.0+ Rust (Mobile companion) 1. Install the device connection tools listed in [Requirements](#requirements). 2. Create and activate a virtual environment: ```bash python -m venv .venv # Windows PowerShell .\.venv\Scripts\Activate.ps1 # macOS/Linux source .venv/bin/activate ``` 3. Install the pinned dependencies and start GoldenNugget: ```bash python -m pip install -r requirements.txt python main_app.py ``` Make a full device backup before applying tweaks. Use `python main_app.py --test-mode` to open the interface with mock devices and no iPhone connected. ## Compatibility | Component | Supported | Notes | | --- | --- | --- | | iOS | 26.2–27.x | Older versions are blocked by the app. | | Windows | Apple Devices or iTunes | Install one before connecting an iPhone. | | Linux | `usbmuxd` and `libimobiledevice` | Both are required for USB access. | | Linux (release) | glibc 2.34+ (x86_64) | The frozen build runs where PySide6 itself runs. Debian 12, Ubuntu 22.04, RHEL 9, Mint 21+. Source runs on Python 3.10+ on any distro (release builds use 3.15). | | Python | 3.10+ | Use the pinned packages in `requirements.txt`. | ## FAQ
Why does GoldenNugget make its own backup if I already have one? On iOS 27, GoldenNugget restores your data from the protective backup it makes right before applying, not from your own backup, so don't skip this step. If there isn't enough disk space for that backup, the apply stops before the phone is changed. The phone is usually not wiped, but in rare cases it reboots into a recovery mode that erases its data, and then that backup is the only way back. iOS 26 never wipes, and it does not make this backup. Keep your own backup as well, in case something goes wrong. Make sure the computer has enough free space, and never delete the protective backup or cache while an apply or recovery is in progress. You can move it in **Settings → Backup → Backup/Cache Location**.
How do I install the macOS app? Download `GoldenNugget-macOS-Universal2.dmg` from the [latest release](https://github.com/GoldensHQ/GoldenNugget/releases/latest), open it and copy GoldenNugget to Applications. It needs macOS 14.4 or newer. The app isn't notarized, so on first launch go to **System Settings → Privacy & Security** and choose **Open Anyway**.
Apply is stuck. What should I do? Keep the phone connected and unlocked, and don't close GoldenNugget. While the phone reboots, the app waits up to 20 minutes for it to come back and then offers **Abort** or **Resume**. Choose **Resume** if the phone is still restarting. If nothing moves, recover your data with **Settings → Backup → Restore Data From Backup**, then report the bug with **Settings → Support → App Log → Export Diagnostics** attached. The same export is available from **Open application log** on the apply result card.
## Discord server Need support? Join our [Discord Server][server]. ## On-device mobile version [GoldenNugget Mobile][mobile] runs on your device without a computer. ## Make your own templates [Batter Builder](https://github.com/GoldensHQ/GoldenNugget-TemplateBuilder/releases/latest) is a visual editor for `.batter` templates with community tweaks: switches, sliders, text boxes and choice lists, no JSON by hand. It checks the template with GoldenNugget's rules, previews it on a virtual iPhone and submits it to the [community catalog](https://github.com/GoldensHQ/GoldenNugget-Presets). ## Features
iOS 26.2 - 27.0+ - PosterBoard: Animated wallpapers and descriptors. - Community wallpapers can be found [here][WallpapersWebsite] or [here][caplayground] - Customizing community-made wallpapers via batter files - Device-Specific wallpapers in MercuryPoster can be installed - See documentation on the structure of tendies and batter files in [documentation.md](documentation.md) - Templates: Custom Operations and file editing - Make your own with [Batter Builder](https://github.com/GoldensHQ/GoldenNugget-TemplateBuilder/releases/latest), a visual editor for templates with community tweaks - See documentation on the structure of batter files in [documentation.md](documentation.md) - Status Bar - Live preview of the Lock Screen and Home Screen status bar before applying - iOS 26 and below: full override set - 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 - iOS 27 and above: cellular entry only (the rest of the overrides have no equivalent in the new status bar format and are hidden on that page) - Change primary and secondary carrier name - Change primary and secondary service badge - Change primary and secondary signal bars - 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](https://github.com/leminlimez/Nugget/issues/656) for what it looks like) - Disable Floating Tab Bar on iPads - Disable AirDrop Time Limit for Everyone Option - Disable Breadcrumbs - Disable Dynamic Island - Disable Icon Parallax - Hide Search Button on Home Screen - Allow pairing with any watchOS version (iPad only) - Internal Options - Build Version in Status Bar - Force Right to Left / Left to Right - Show Hidden Icons on Home Screen - iMessage, Continuity and FaceTime Debugging - Show Accessory Developer Settings - Disable Clock Icon Seconds Hand - Disable Spotlight Searching in Websites - Show Hardware Button Hints in Screenshots - Vibrate on Raise-to-Wake - 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 - Liquid Glass (iOS 26.0+): 98 options, searchable in the app - Disable or tone down Liquid Glass: Solarium fallback (iOS 26 only), linked-on, hardware and opt-out checks - Turn off specular highlights, refraction, HDR and shadows for the Dock, folders, widgets and Lock Screen clock - Flat icons everywhere - iOS 27: experimental glass flags (Calistoga, floating and stacked-image effects, debug overlays) - Disable Daemons (with a one-tap Recommended set): - System services: thermalmonitord, OTA updates, UsageTrackingAgent, Game Center, Screen Time Agent, ATWAKEUP, Tips, VPN icon, Chinese WLAN service, HealthKit, AirPrint, Assistive Touch, iCloud, Internet Tethering (Personal Hotspot), Passbook, Spotlight, Voice Control, NanoTimeKit, Apple Ads, News, Family Sharing, Video Subscriptions, Web Bookmarks, Apple Watch (Nano) services, Siri backend services, Wi-Fi logging, Maps (geod), Safari Suggestions, Reminders, AirPlay, GameKit, Sidecar, Speech Recognition, Translate, Mock Location, DeviceCheck - Analytics & diagnostics: crash reporting, Wi-Fi, system, audio, ecosystem, call and media analytics, CoreDuet, Insight, Metrics, symptom, statistical and wireless diagnostics, Duet heuristics, decisiond, triald, sociald - Icon Themes: custom Home Screen icons and labels as WebClips, plus downloadable icon packs - Passcode Themes: custom passcode keypads from `.passthm` packages, written over USB/Wi-Fi with [AirLift] (no reboot) - Presets: save, switch, export and import whole tweak setups (`.gnpreset`); see [Portable presets](docs/PORTABLE_AND_DIAGNOSTICS.md) - Share a preset as a QR code or a one-line code, and import someone else's setup from a screenshot or pasted text - Preset catalog: browse community presets reviewed by the team, check their risk, preview and import them, or submit your own - Risk check before every apply: a Low / Medium / High verdict with reasons, and an explicit confirmation for high-risk setups - Preview on iPhone: see the Lock Screen and Home Screen with your tweaks, drawn for your model, before applying (also for presets and shared codes) - Command line: everything above is scriptable through `python nugget_cli.py --help`, with `--json` output and `--dry-run` applies
## Screenshots
Open the English interface screenshots
Home Tweaks PosterBoard
Daemons Settings Status Bar
Apply SpringBoard Internal
Liquid Glass Icon Themes Passcode Themes
## Contributors
**Thanks to everyone who contributes to the project!** 🎉 Contributors Want to see your name here? Open a [Pull Request](https://github.com/GoldensHQ/GoldenNugget/pulls)!
## Star History Star History Chart
If you find this project useful, consider starring the repo.
> [!NOTE] > ## Mobilegestalt > Don't even ask me for it. It will NEVER be implemented again. ## Requirements
Windows - Either the [Apple Devices (from Microsoft Store)][AppleDevices] App or [iTunes (from Apple website)][iTunes]
Linux - [usbmuxd][usbmuxdGitHub] - [libimobiledevice][libimobiledeviceGitHub] If they are missing, GoldenNugget offers to install them (Arch, Debian/Ubuntu, Fedora, openSUSE, Alpine and Void families); the system asks for your administrator password through polkit, so the app never sees it.
For Running Python - [pymobiledevice3][pymobiledevice3GitHub] - [PySide6][PySide6Doc] (PySide6-Essentials on non-Linux, selected automatically) - [ffmpeg-python](https://pypi.org/project/ffmpeg-python/) (video wallpapers) - [opencv-python](https://pypi.org/project/opencv-python/) (video wallpapers) - Python 3.10 or newer
> All pinned deps are in `requirements.txt` (incl. PyInstaller for building). ## Documentation - [Wiki](https://github.com/GoldensHQ/GoldenNugget/wiki): installation, tweaks, presets, wallpapers and troubleshooting. - [Portable presets and diagnostics](docs/PORTABLE_AND_DIAGNOSTICS.md): `.gnpreset` files, diagnostic archives, JSON CLI output and offline wallpaper checks. - [Architecture](docs/ARCHITECTURE.md): device connections, background operations and backup/restore internals. - [Contributing](CONTRIBUTING.md): contribution guidelines and offline checks. ## Building Follow [Quick Start](#quick-start) to install the dependencies first. The generated `src/qt/mainwindow_ui.py` is committed; no Designer UI generation step is required for the current interface. When changing Qt resources, regenerate the resource module: ```py pyside6-rcc --compress-algo zlib src/qt/resources.qrc -o src/qt/resources_rc.py ``` Translations live in the [gNugget-i18n repository][i18n] and are synced into `src/qt/translations/` automatically, so do not edit the `Nugget_*.ts` files here. See [I18N_SETUP.md](I18N_SETUP.md) for the sync, the local Russian catalog and the pitfalls of regenerating catalogs with `pyside6-lupdate`. Build the application for your current platform: ```bash python compile.py ``` Build output is written to `dist/`. The macOS CI build downloads Qt/PySide6 6.12.0 Universal2 wheels for Python 3.15 from [QTBuildMacOS](https://github.com/GoldensHQ/QTBuildMacOS). Qt compilation, wheel normalization, and shared releases are maintained there; this repository builds the application using the published wheels. The current runtime requires macOS 14.4 or newer. See the shared repository for local Qt build instructions and reuse in other GoldensHQ projects. ## Contributing and forking See [CONTRIBUTING.md](CONTRIBUTING.md) for contributions and [FORKING.md](FORKING.md) for forks. ## Credits - [awesomenull] Lead developer - [Wind0ws11Aero] Co-developer - [kik4311] Co-developer - [mekabrine][mekabrineDiscord] for icons artwork in new ui. - [oma][EazvyGitHub] for interface improvements. - [Lucide contributors][LucideGitHub] for some of the interface icons. - [Rasmus Andersson][rsmsGitHub] for the Inter font. - Translations crowdsourced using [gNugget-i18n repository][i18n] - [Prognosticate-X] for [Status Bar research][sbr] on iOS 27 - [LeminLimez] for creating Nugget. - [0xjohnnydev] for [AirLift] - [LEGACY] Old translations were crowdsourced using [Nugget POEditor][POEditorJoin]. Thank you everyone who assisted in the translation effort! - [PosterRestore][PosterRestoreDiscord] for their help with PosterBoard - Special thanks to [dootskyre][dootskyreX], [Middo][MiddoX], [dulark][dularkGitHub], forcequitOS, and pingubow for their work on nugget. It would not have been possible without them! - Thanks to [Snoolie][SnoolieGitHub] for aar handling! - [SerStars][SerStarsGitHub] for the wallpaper website. - [iTechExpert][iTechExpertTwitter] for various Springboard/Internal Options - [Mikasa-san][Mikasa-sanGitHub] for [Quiet Daemon][QuietDaemonGitHub] - [MiniVoidyy][MiniVoidyyGitHub] for the additional system and analytics daemon lists. - [doronz88][doronz88GitHub] for pymobiledevice3's restoring and device algorithms. - [Qt Company][QtGitHub] for the PySide6 GUI library. - [FFmpeg contributors][FFmpegGitHub] and [Karl Kroening][kkroeningGitHub] for video processing and the ffmpeg-python bindings. - [OpenCV contributors][OpenCVGitHub] for image and video decoding. - [pillow-heif contributors][pillowHeifGitHub] for HEIF image decoding on Linux. - [mattisklein][mattiskleinGitHub] for the Siri AI eligibility archives from Project Linwood. [Prognosticate-X]: https://github.com/Prognosticate-X/ [sbr]: https://github.com/Prognosticate-X/ios27-carrier-lockscreen-research [caplayground]: https://caplayground.vercel.app/wallpapers [i18n]: https://github.com/awesomenull-dev/gNugget-i18n [NuggetLogo]: https://github.com/GoldensHQ/GoldenNugget/blob/main/src/qt/credits/small_nugget.png [LeminLimez]: https://github.com/leminlimez [CowabungaLite]: https://github.com/leminlimez/CowabungaLite [WallpapersWebsite]: https://cowabun.ga/wallpapers [AppleDevices]: https://apps.microsoft.com/detail/9np83lwlpz9k [iTunes]: https://support.apple.com/en-us/106372 [usbmuxdGitHub]: https://github.com/libimobiledevice/usbmuxd [libimobiledeviceGitHub]: https://github.com/libimobiledevice/libimobiledevice [ShortcutsApp]: https://apps.apple.com/us/app/shortcuts/id915249334 [MobilegestaltShortcut]: https://www.icloud.com/shortcuts/66bd3c822a0145b98d46cd1c9077e6e5 [ReadMoreGist]: https://gist.github.com/leminlimez/c602c067349140fe979410ef69d39c28 [Wind0ws11Aero]: https://github.com/Wind0ws11Aero [POEditorJoin]: https://poeditor.com/join/project/UTqpVSE2UD [PosterRestoreDiscord]: https://discord.gg/gWtzTVhMvh [dootskyreX]: https://x.com/dootskyre [MiddoX]: https://x.com/MWRevamped [dularkGitHub]: https://github.com/dularkian [SerStarsX]: https://x.com/SerStars_lol [Mikasa-sanGitHub]: https://github.com/Mikasa-san [QuietDaemonGitHub]: https://github.com/Mikasa-san/QuietDaemon [MiniVoidyyGitHub]: https://github.com/MiniVoidyy [doronz88GitHub]: https://github.com/doronz88 [QtGitHub]: https://github.com/qt [mekabrineDiscord]: https://discord.com/users/1196529222617923660 [EazvyGitHub]: https://github.com/Eazvy [LucideGitHub]: https://github.com/lucide-icons [rsmsGitHub]: https://github.com/rsms [SerStarsGitHub]: https://github.com/SerStars [FFmpegGitHub]: https://github.com/FFmpeg [kkroeningGitHub]: https://github.com/kkroening [OpenCVGitHub]: https://github.com/opencv [pillowHeifGitHub]: https://github.com/bigcat88 [SnoolieGitHub]: https://github.com/0xilis [lrdsnowGitHub]: https://github.com/Lrdsnow [EUEnablerGitHub]: https://github.com/Lrdsnow/EUEnabler [pymobiledevice3GitHub]: https://github.com/doronz88/pymobiledevice3 [PySide6Doc]: https://doc.qt.io/qtforpython-6/ [python-aar-stuffGitHub]: https://github.com/0xilis/python-aar-stuff [mattiskleinGitHub]: https://github.com/mattisklein [bl_sbxGitHub]: https://github.com/khanhduytran0/bl_sbx/tree/main [DuyGitHub]: https://github.com/khanhduytran0 [HuyTwitter]: https://x.com/Little_34306 [iTechExpertTwitter]: https://twitter.com/iTechExpert21 [server]: https://discord.gg/Rm6r4zeE3y [0xjohnnydev]: https://github.com/0xjohnnydev [awesomenull]: https://github.com/awesomenull-dev [kik4311]: https://github.com/kik4311 [AirLift]: https://github.com/0xjohnnydev/airlift [mobile]: https://github.com/GoldensHQ/GoldenNugget-mobile