unfairplay

module
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 25, 2026 License: MIT

README

UnfairPlay

UnfairPlay recovers a FairPlay model from an enrolled Mac and uses it to decrypt personalized iOS IPAs. It is a standalone Go program.

It does not log in to Apple, buy apps, or download IPAs. You can use ipatool or another downloader for that part.

Build

go build -o unfairplay ./cmd/unfairplay

Usage

First, sign in to the native Mac App Store. Install an iPhone or iPad app and open it once. Download an encrypted IPA with the same Apple Account.

Collect the Mac state and matching IPA:

sudo ./unfairplay collect \
  --app /Applications/App.app \
  --ipa App.ipa \
  --output App.capture

Recover the model and validate it:

./unfairplay recover \
  --capture App.capture \
  --output App.recovery

Decrypt another IPA from the same enrollment:

./unfairplay decrypt \
  --input AnotherApp.ipa \
  --model App.recovery/fairplay-enrollment.bin

Test a model without keeping the decrypted IPA:

./unfairplay verify \
  --input AnotherApp.ipa \
  --model App.recovery/fairplay-enrollment.bin

Use unfairplay doctor to check a capture, IPA, or model. Use unfairplay profile to inspect a fairplayd binary.

Support

Verified profiles: 25G83, 26A428/26A434, and 26B118 compatibility mode. Unknown arm64e builds are accepted only if model recovery and full IPA validation succeed.

macOS arm64 and Linux amd64/arm64 are supported. Windows is compile-tested but cannot yet enforce the required private-file permissions.

The IPA, installed app, Mac state, hardware identity, and model must belong to the same enrollment. Account or selector mismatches are rejected.

Keep capture and model files private. Do not share SIDB, SINF, hardware data, recovery models, or decrypted apps. Decrypted IPAs are analysis files and need signing before installation.

Releases

Tags matching v* publish binaries and SHA256SUMS through GitHub Actions. Tags such as v0.2.0-rc.1 create prereleases.

License

MIT. The DarkPhoenix-derived Go code keeps its Apache-2.0 notice in LICENSE-DARKPHOENIX.txt.

Directories

Path Synopsis
cmd
unfairplay command
internal
recovery
Code generated by generate_macos_fairplay_go_oracle.py; DO NOT EDIT.
Code generated by generate_macos_fairplay_go_oracle.py; DO NOT EDIT.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL