Before you begin
먼저 백업하고, 그다음 버전을 확인한 뒤 시작하세요.
이것이 가장 중요합니다. 백업은 복구 경로를 남기고, 버전 확인은 지원되지 않는 기능을 헛되이 시도하지 않게 해 줍니다.
가이드
이 페이지는 실제 사용 순서대로 구성되어 있습니다. PC 준비, 백업, iOS 버전 확인, 기기 연결, Nugget 실행, 필요 시 MobileGestalt 파일 준비, 그리고 첫 tweak 적용까지입니다.
Before you begin
이것이 가장 중요합니다. 백업은 복구 경로를 남기고, 버전 확인은 지원되지 않는 기능을 헛되이 시도하지 않게 해 줍니다.
Windows
Linux
Run from source
Step by step
환경과 연결을 먼저 안정화하면 tweak 단계에서 훨씬 수월합니다.
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.
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.
You can use a desktop release or run from source by creating a virtual environment, installing the dependencies, and starting `python3 main_app.py`.
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.
PosterBoard, status bar customization, and SpringBoard options are good first choices because their results are easy to spot and confirm.
Some changes need a restart or reload of the system interface. Confirm the result before you move on to the next tweak.
Version check
모든 tweak이 모든 빌드에서 동작하지 않습니다. 여기부터 보는 것이 좋습니다.
iOS 17.0 - 26.0+
iOS 17.0 - 26
iOS 18.1 - 26
MobileGestalt
iOS 26 이하의 일부 기능은 기기별 mobilegestalt 파일이 필요할 수 있습니다.
Install the Shortcuts app on the iPhone or iPad.
Download the Save MobileGestalt shortcut.
Run the shortcut and save the generated file.
Transfer the file to your computer.
Place it next to the Python program or point Nugget to the file path.
소스 실행 명령
환경에 따라 `python / pip`를 사용할 수도 있습니다.
First tweaks to try
눈에 보이는 변경이 있어야 정상 작동 여부를 판단하기 쉽습니다.
PosterBoard
Status Bar
SpringBoard options
MobileGestalt
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.