GestaltX README

项目的 README,来自 github.com/huamidev/GestaltX。合并为一个 markdown 文件:README.md。

GestaltX

GestaltX

Version Platform SwiftUI License

English · 简体中文 · 日本語 · 한국어 · Türkçe

A MobileGestalt editor for iPhone and iPad. Developed by huamidev.

Features

Category Presets and tools
Display Dynamic Island capability and layout, Always-On Display, AOD Vibrancy, high-luminance AOD, AOD flipbook, HDR photo display, wallpaper parallax, Liquid Glass low-power rendering, experimental PWM and DisplayPort flags
Device Model name, boot/shutdown chime, charge limit, tap to wake, Camera Control settings, Action Button settings, Collision SOS, Audio Mix, Spatial FaceTime audio
iPad Apple Pencil settings, Stage Manager capability, iPad app compatibility
Intelligence Independent region-code options, Apple Intelligence capability flag, on-device Siri, Audio Intelligence, Personal Translator, Photos Clean Up, Handwriting Synthesis, always-listening Hey Siri, and sales-region options for activation attempts on China-mainland devices
Advanced Apple internal feature flags, the system-wide InternalBuild flag with explicit enable confirmation, internal settings bundle, Security Research Device flag
Field editor Read, search, add, edit, and remove CacheExtra fields; local plist import/export; String, Integer, Real, Boolean, Data, Date, Array, and Dictionary values
Changes Automatic reading and manual re-read, staged before/after review, verified writes, per-preset restore
Backups Automatic initial backup before device editing, backup before every write, original-value records; open, export, restore, and delete
Logs & respring Actual exploit-stage logs and manual NeoSpring respring

Usually, changing the region code is enough to try enabling AI; there is no need to change Sales Region. Selecting United States for Region Code sets RegionCode to LL and keeps the sales-region suffix. You can also choose China (Mainland), Hong Kong, Taiwan, Japan or the United Kingdom. Sales Region and Region Code can be applied together: the sales suffix follows Sales Region, while the code follows Region Code.

If you previously changed Sales Region, restore your device’s original sales region and apply it first.

Disabling a preset or using its Revert button restores the recorded original values and types. Keys that were originally absent are removed. If an older change has no original record, use Remove Added Fields only when you know those fields were added.

Presets modify capability flags; actual effects depend on the device and OS. China-mainland devices can use the Apple Intelligence and region options to attempt activation; availability also depends on the model, OS version, and Apple services.

Apple Intelligence, Face ID and dictation

The YumEdit 1.2.1 approach avoids spoofing the product, board and CPU. In Intelligence, Apple Intelligence Capability sets the generative-model flag to 1, while the separate Siri AI Mode preset sets SiriMode to 2. Neither changes hardware identity nor the device-specific On-Device Siri capability. These are experimental flags, not a guarantee of resource downloads or working Apple Intelligence. YumEdit later replaced this activation approach with an experimental two-stage workflow; GestaltX does not implement temporary hardware spoofing.

If a previous hardware spoof broke Face ID or dictation, choose an original device backup in Backups → Restore Hardware Identity. Alternatively, import a verified original plist and use Intelligence → Restore Hardware Identity. Save or discard pending changes first. Recovery requires a verified same-device backup with the same CacheData, CacheUUID and cache version, whose product and board match the kernel-reported hardware. It restores only product, board, CPU and the original regulatory model number, preserving current AI, Siri, region and unrelated settings. Unlike YumEdit's region activation, recovery does not substitute a US regulatory model. Missing, incompatible or already-spoofed backups are rejected; original hardware values are never guessed.

Recovery currently recognizes iPhone 11 through iPhone 15/15 Plus (including the second- and third-generation SE), checking the original CPU against the known chip for the physical product. Other products are rejected rather than guessing their chip. A backup is created before writing and the complete result is verified. Fully restart the device, then test Face ID, dictation and Apple Intelligence. This recovery addresses hardware-spoofing damage, not every possible Face ID fault; device-level behavior still requires testing on affected hardware.

Compatibility

Supports iOS / iPadOS 27.x. iOS / iPadOS 26.x is not supported for on-device MobileGestalt access. Powered by worse_query. SystemGroup access requires iOS 27; available features depend on the device and OS. Local plist editing is also supported.

Signing requires a certificate and provisioning profile with at least one usable App Group. Sign the app and its embedded share extension with at least one common App Group, and keep the extension when re-signing. Both processes detect their actual signed App Groups at runtime. Distributed IPAs carry ad-hoc signatures with these entitlements embedded so SideStore and AltStore can detect them when re-signing; they are not signed with a developer certificate.

Download

Download the IPA from Releases. Some users report incomplete downloads with Safari on iOS 27. If the file is reported as damaged or cannot be extracted, download it again; several attempts may be needed. Try another browser if it persists. The cause has not been confirmed.

Import a plist

In Files or another app, select a MobileGestalt plist, tap Share, and choose GestaltX. The share extension reads the supplied file and hands it to the app through the shared App Group. Return to GestaltX if it does not open automatically. The app checks a device-bound proof from a GestaltX export, or at least two unique identifiers obtained from this device, then asks you to confirm the import. Files that cannot be verified are rejected. Previously imported files are never used as the reference for device identity.

Some original plists contain no unique device identifiers. Export a copy from GestaltX on this device first: its verification key stays in the device-only Keychain and is never included in the file.

Shared files are checked at launch and on return to the foreground. Pending edits are preserved until you save or discard them. Confirmed imports open as local documents. MG Control supports adding, editing, renaming and deleting typed keys and values. Use Restore Imported Plist to restore a verified file to this device; restoration requires a matching system cache layout and an additional confirmation, backs up the current file, and verifies the write. Restart the device afterward.

Language support

GestaltX follows your iOS language settings, with English as the default and fallback. Persian includes right-to-left layout support.

Language Locale
English en
简体中文 — Simplified Chinese zh-Hans
繁體中文(台灣)— Traditional Chinese (Taiwan) zh-Hant-TW
繁體中文(香港)— Traditional Chinese (Hong Kong) zh-Hant-HK
Tiếng Việt — Vietnamese vi
Русский — Russian ru
فارسی — Persian fa
한국어 — Korean ko
Español — Spanish es
日本語 — Japanese ja
Türkçe — Turkish tr

Credits

Disclaimer

For security research and educational purposes only. Use only on devices you own or are authorized to manage.

Back up your data before making changes. Modifying MobileGestalt may cause system instability or require a device restore. You are responsible for the changes you apply and the resulting risks.

License

GNU GPL v3 · Copyright © 2026 huamidev.

Star History

GestaltX Star History

GestaltX (huamidev/GestaltX)

正在搜索数据库…

这是什么?这是 MobileGestalt 的编辑器。MobileGestalt 是 iOS 中保存设备功能标志的文件。它可以在 iOS 27.x 上修改地区代码、灵动岛、全天候显示屏(Always-On Display)和相机控制(Camera Control)等设置。
这是桌面工具,还是装在手机上的应用?它是直接安装在 iPhone 或 iPad 上的应用。要导入 plist,请在“文件”中选中它,点按“共享”,然后通过共享扩展选择 GestaltX。
我该怎么让它运行起来?README 里没有现成的下载,所以需要自己编译并签名。签名需要证书和一个描述文件,且描述文件中至少要有一个可用的 App Group;应用及其内嵌的共享扩展必须共用同一个 App Group。
我需要哪个 iOS 版本?iOS 或 iPadOS 27.x。在 26.x 上不支持直接访问设备端的 MobileGestalt,而且部分功能需要 iOS 27,并且还取决于设备。
应用预设一经应用就一定生效吗?不一定。预设只会修改功能标志,实际效果取决于设备和系统版本。中国大陆设备上的 Apple Intelligence 也取决于机型、系统版本和 Apple 服务,因此通常只要修改地区代码,就可以试试看。
它也能在 iPad 上用吗?可以。它同时支持 iPhone 和 iPad,并包含 iPad 专属选项,例如 Apple Pencil 和台前调度的功能设置。
这个工具具体能修改什么?显示选项,如灵动岛、全天候显示屏和液态玻璃(Liquid Glass)渲染;设备选项,如开机提示音和操作按钮;iPad 设置,如 Apple Pencil;以及用于 CacheExtra 键的原始字段编辑器。
改错了还能撤销吗?可以。关闭某个预设,或点按其“Revert”按钮,即可恢复记录下来的原始值和类型;原本不存在的键会被删除。
导出校验密钥存放在哪里?它保存在仅限本机的钥匙串(Keychain)中,且从不包含在导出的文件里,因此仅凭该文件无法在其他设备上通过校验。
作者
huamidev
大小
2 MB
星标
8.1K
时长
9天
提交 · 90 天