<div align="center">
<img width="150" height="150" src="godis/Media.xcassets/app%20icon.imageset/godis-icon.png" alt="godis icon">
</div>

<div align="center">
  <h1><b>godis</b></h1>
  <p><i>MobileGestalt customization and PosterBoard collections for iOS</i></p>
  <p>
    Built and maintained by <a href="https://github.com/nxtcoreee3"><b>nxtcoreee3</b></a>
    · Bad Poster support
    · PartyUI interface components
  </p>
</div>

> [!WARNING]
> godis writes to system-managed data and can change device behavior. Some tweaks are experimental and may cause instability, a respring loop, or require a restore. **Use at your own risk.**

## What’s in godis

godis is a customization utility for MobileGestalt tweaks and PosterBoard collections. It combines the original godis tweak workflow with the `.tendies` handling and PosterBoard support from Bad Poster, while keeping the two workflows separated in the Tools tab.

- **MobileGestalt tweaks** — Stage supported tweaks, review the changes, and apply them from the MobileGestalt workflow.
- **Device detection** — Detect the current iPhone model and display the device artwork, operating-system status, and compatibility information.
- **Unsupported-version access** — The app can still be opened on an unsupported version. It shows a “Continue at Own Risk” warning and keeps unavailable controls visible while preventing unsafe interaction where required.
- **Tweak Profiles** — Save all currently staged toggles and related settings as a reusable profile. Profiles remain available after relaunch and can be applied again later.
- **Quick Profiles** — Switch profiles directly below the device status card. Selecting a profile applies it immediately; selecting **Choose Profile** clears the staged profile settings.
- **`.godis` profile files** — Export one or more profiles as shareable files named like `MyProfile.godis`, then import them through the iOS Files picker.
- **Bad Poster mode** — Import multiple `.tendies` collections, display their original filenames, apply them to PosterBoard, reset collections, and trigger the required respring flow.
- **Diagnostics** — View in-app OSLog-style diagnostics, inspect errors, and use the manual respring action from Settings.
- **Backups and restore** — Create, rename, review, and restore MobileGestalt backups before making changes.
- **PartyUI styling** — Uses components and visual ideas from [PartyUI](https://github.com/jailbreakdotparty/PartyUI) while keeping the godis layout and navigation.

## Tools

The Tools tab contains a segmented switch between **MobileGestalt** and **Bad Poster**.

### MobileGestalt

Select the tweaks you want to stage, review the device information card, and apply the changes. Depending on the tweak, godis may alter settings such as display behavior, Dynamic Island configuration, model-name presentation, iPadOS mode, or Siri AI region behavior.

Tweak availability depends on the device’s MobileGestalt data and the operating-system build. A tweak can be visible in the interface without being enabled on a device that does not provide the required underlying keys.

### Bad Poster

Select one or more `.tendies` files from Files. godis keeps an internal copy for access to the security-scoped file while showing the original collection name in the list.

Select **Apply All to PosterBoard** to run the Bad Poster workflow. The app reads the original tendies layout, prepares the PosterBoard descriptors, writes them through the supported exploit path where available, cleans up temporary files, and opens the respring flow.

**Reset Collections** removes the custom PosterBoard descriptors through the same support path and then resprings when supported.

## Tweak Profiles

Profiles are stored locally on the device and are intended for keeping a known configuration for later or sending a setup to another person.

A profile includes the selected tweak identifiers, Dynamic Island setting, model-name setting and value, and Siri AI region setting. The profile list is available in Settings, where profiles can be saved, renamed, deleted, applied, exported, and imported.

Exported files use the following format:

```text
YOURPROFILENAME.godis
```

The file contents are JSON for portability, but the `.godis` extension makes the file recognizable as a godis profile. Imports accept both single-profile files and files containing multiple profiles.

## Backups and Fields

The **Fields** tab provides direct editing for MobileGestalt values, including strings, integers, floats, booleans, data, arrays, and dictionaries. godis validates the plist structure, keeps a backup before writes, verifies the result, and resprings when the operation succeeds.

The **Restore** tab manages local MobileGestalt backups. Backups can be created, imported, renamed, exported, restored, and deleted. Restoring first preserves the current state so it can be recovered if needed.

## Supported Devices and Versions

- iOS 27 beta 1 through beta 4 are the primary supported MobileGestalt targets.
- Bad Poster support targets the PosterBoard layouts supported by Bad Poster on iOS 26 through iOS 27.0 beta 4.
- Xcode and a signing method capable of installing an app on the target device are required.
- Developer Mode must be enabled when required by the installation method.
- The project bundle identifier is `me.ssus.godis`.

On an unsupported version, godis shows a warning rather than hiding the app completely. Continuing is optional and experimental; controls that cannot safely run on that version remain disabled.

## Building from Source

```bash
git clone https://github.com/nxtcoreee3/godis.git
cd godis
open godis.xcodeproj
```

Select the **godis** scheme in Xcode and build for a connected device or simulator. The project uses SwiftUI, UIKit-backed document pickers, and these package dependencies:

- [PartyUI](https://github.com/jailbreakdotparty/PartyUI)
- [ZIPFoundation](https://github.com/weichsel/ZIPFoundation)

A simulator build can validate the interface and compile the project. MobileGestalt writes, `bad_query` access, PosterBoard descriptor writes, and respring behavior need to be tested on a compatible physical device.

For an unsigned validation build:

```bash
xcodebuild \
  -project godis.xcodeproj \
  -scheme godis \
  -sdk iphoneos \
  -destination 'generic/platform=iOS' \
  CODE_SIGNING_ALLOWED=NO \
  CODE_SIGNING_REQUIRED=NO \
  build
```

## Installation and Usage

1. Install godis using a compatible signing or sideloading method.
2. Open the app and read the device compatibility warning.
3. Create a backup before applying MobileGestalt changes.
4. Select **MobileGestalt** or **Bad Poster** in Tools.
5. Stage and apply tweaks, or import `.tendies` collections and apply them to PosterBoard.
6. Let godis respring when the selected workflow requires it.

## Credits

- [nxtcoreee3](https://github.com/nxtcoreee3) — godis development, customization workflow, profile system, diagnostics, UI, documentation, and maintenance
- [SUSS](https://github.com/frs0n) — original Fields and Restore work, contributor support, and project assets
- [forcequitOS](https://github.com/forcequitOS) — creator of the [`bad_query`](https://github.com/forcequitOS/bad_query) exploit used for the PosterBoard and container-access workflow
- [Jailbreak.party](https://github.com/jailbreakdotparty/PartyUI) — PartyUI components and design resources
- [Bad Poster](https://github.com/nxtcoreee3/Bad-Poster) — `.tendies` collection and PosterBoard workflow integrated into godis
- [Nugget](https://github.com/leminlimez/Nugget) — MobileGestalt preset and `CacheData` research used by the project
- [neospring](https://github.com/rooootdev/neospring) — WebKit respring implementation

## License

godis is licensed under the **GNU General Public License v3.0**. See [LICENSE](LICENSE) for the complete license text.

The project includes GPL-licensed Bad Poster functionality and PartyUI components distributed under their respective licenses. Additional license files are included under `ThirdPartyLicenses/` where applicable.

## Project Status

godis is an experimental customization utility under active development. iOS betas, device-specific MobileGestalt keys, PosterBoard internals, exploit availability, and respring behavior can change without notice. Back up your device before testing, keep recovery options available, and do not apply changes you are not prepared to undo.
