Before you begin
最初にバックアップ、その次にバージョン確認です。
これが最重要です。バックアップがあれば戻せます。バージョンを先に見れば、非対応機能を追いかけずに済みます。
ガイド
Nugget ガイド：環境準備、接続、そして最初の tweak まで。
このページは実際の順番で整理しています。PC の準備、バックアップ、iOS バージョン確認、デバイス接続、Nugget 起動、必要なら MobileGestalt ファイルの準備、そして最初の tweak です。
Windows
- Install Apple Devices or iTunes
- If detection fails, check the cable, port, and trust prompt first
Linux
- Install usbmuxd
- Install libimobiledevice
Run from source
- Python 3.9+
- pymobiledevice3
- PySide6
Step by step
初回はこの順番で進めるのが一番安全です。
先に環境と接続を整えてから tweak に入るほうが安定します。
01
Back up the device first
Create a full backup before you change anything. That gives you the safest recovery path if a tweak does not behave the way you expected.
02
Prepare the computer
Install Apple Devices or iTunes on Windows, or usbmuxd and libimobiledevice on Linux. If you run from source, add Python 3.9+, pymobiledevice3, and PySide6.
03
Launch Nugget
You can use a desktop release or run from source by creating a virtual environment, installing the dependencies, and starting `python3 main_app.py`.
04
Connect and trust the device
Connect with a reliable cable and approve the trust prompt on the iPhone or iPad. Do not unplug the device in the middle of an apply or restore action.
05
Start with one simple feature group
PosterBoard, status bar customization, and SpringBoard options are good first choices because their results are easy to spot and confirm.
06
Reboot if needed and verify
Some changes need a restart or reload of the system interface. Confirm the result before you move on to the next tweak.
Version check
どのバージョン帯にいるかを最初に確認してください。
対応状況はビルドごとに違います。ここを先に見るだけで失敗がかなり減ります。
iOS 17.0 - 26.0+
- PosterBoard animated wallpapers and community wallpapers
- Status bar tweaks, SpringBoard details, and internal options
- Liquid Glass disable option on supported 26.0+ builds
- Selected daemon control and a few risky hidden options
iOS 17.0 - 26
- MobileGestalt features such as Dynamic Island on unsupported devices, boot chime, charge limit, and more
- Hidden settings pages, regional restriction changes, and feature flags
- EU Enabler on iOS 17.6 and below
iOS 18.1 - 26
- AI Enabler
- Device spoofing
- MobileGestalt and AI Enabler are not supported on iOS 26.2+
MobileGestalt
MobileGestalt 関連機能を使うなら、先に必要ファイルを用意してください。
iOS 26 以下の一部機能では、端末固有の mobilegestalt ファイルが必要になる場合があります。
- 1
Install the Shortcuts app on the iPhone or iPad.
- 2
Download the Save MobileGestalt shortcut.
- 3
Run the shortcut and save the generated file.
- 4
Transfer the file to your computer.
- 5
Place it next to the Python program or point Nugget to the file path.
ソース実行コマンド
python3 -m venv .env
source .env/bin/activate
pip3 install -r requirements.txt
python3 main_app.py
環境によっては `python3 / pip3` ではなく `python / pip` を使うことがあります。
First tweaks to try
最初は結果が見えやすいモジュールから始めるのがおすすめです。
見た目がすぐ変わる機能のほうが、正常に動いているか判断しやすくなります。
PosterBoard
- Set animated wallpapers, browse community wallpapers, or convert video to wallpaper.
Status Bar
- Adjust carrier text, battery display detail, signal bars, time text, and icon visibility.
SpringBoard options
- Try lock screen footnotes, Dynamic Island screenshots, charging behavior, or lock screen text.
MobileGestalt
- On supported builds, explore Dynamic Island, charge limit, Tap to Wake, AOD, and Stage Manager.
Practical tips
問題が起きたら、接続、バージョン、手順順序から確認してください。
初心者の問題の多くは tweak 自体より前提条件にあります。
If the device is not detected, confirm trust first, then try another cable or port.
Do not enable too many changes at once. Apply one, verify one.
If version support is unclear, confirm the iOS version before you continue.
If the desktop app is blocked, check system security prompts and permissions.