Mak5er/AirCard-iOS

Apple Wallet card skins, lock screen passcode themes, and PosterBoard wallpapers directly on iOS (18.0 – 27.2 beta 2).

AirCard-iOS customizes Apple Wallet card artwork, lock screen passcode dialers, and lock screen wallpapers on device without a jailbreak.

The app communicates with internal system services over a local loopback tunnel (10.7.0.1 or 127.0.0.1) provided by LocalDevVPN. File operations are handled by AirliftFFI, a Rust library that interfaces with the AirTraffic service.

• Writes custom card artwork to Passbook caches (cardBackgroundCombined@3x.png, @2x.png, and cardBackgroundCombined.pdf for transit cards like Suica).
• Flushes front-face and thumbnail caches so new artwork appears immediately when Wallet opens.
• Detects card identifiers in real time when you bring up Apple Pay.
• Apply artwork to individual cards or batch-flash every detected card.

• Live dialer preview with touch panning and zoom framing.
• Full poster layout across all ten buttons, or individual circular button cutouts.
• Targets system dialer caches (TelephonyUI-10).
• Localized number subtext options, including Ukrainian and Russian Cyrillic layouts.
• Import and export themes as .passthm files.

• Import and unpack .tendies wallpaper archives directly from the Files app.
• Auto-detects PosterBoard wallpaper containers and active descriptor UUIDs.
• Injects wallpaper configurations and assets into PosterBoard storage.
• Automatically triggers a NeoSpring respring after flashing to apply wallpapers without rebooting your iPhone.

• Import pairing file: Supports pairing files (.mobiledevicepairing, .plist, .mobilepair) from SideStore, LiveContainer, iLoader, AltStore, Jitterbug, or exported from Mac/PC.
• On-device pairing (iOS 27+): Advertises locally over Bonjour so the phone can pair with itself via Settings > Privacy & Security > Developer Mode > Pair with AirCard-iOS.
• Safe unpairing: Easily delete the active pairing file to re-pair or switch pairing credentials at any time.

1. iOS 18.0 – 27.2 beta 2 (iOS 27.0+ for on-device Settings pairing, or imported pairing file on iOS 18–26). Note: iOS 27.2 beta 3+ is patched.
2. LocalDevVPN / WireGuard: Running in loopback mode (10.7.0.1 or 127.0.0.1) so local connections can reach internal device services.
3. Pairing record: Either on-device pairing or an imported pairing file.

AirCard-iOS requires a pairing record to communicate with device lockdown services. Choose the method that best matches your setup:

If you already use SideStore on your device, it has already created a valid pairing file:

1. Open AirCard-iOS and go to the Pairing tab.
2. Tap Import Pairing File….
3. In the Files document picker, navigate to:

   On My iPhone › SideStore › ALTPairingFile.mobiledevicepairing
   

4. Select ALTPairingFile.mobiledevicepairing. The app will load it immediately (Pairing file loaded ✅).

If you run SideStore inside LiveContainer:

1. Open AirCard-iOS › Pairing tab › tap Import Pairing File….
2. In the Files document picker, navigate to:

   On My iPhone › LiveContainer › SideStore › Documents › ALTPairingFile.mobiledevicepairing
   

   (depending on your LiveContainer version, you can also check On My iPhone › LiveContainer › Data › App › ... › SideStore › Documents)
3. Select ALTPairingFile.mobiledevicepairing.

• iLoader / Jitterbug: In the respective app, export your pairing file (<UDID>.mobiledevicepairing) into the Files app, then import it in AirCard-iOS.
• Mac / PC: Generate a pairing record using jitterbugpair, pymobiledevice3, or copy it from your computer (/var/db/lockdown/<UDID>.plist on macOS or %ProgramData%\Apple\Lockdown\<UDID>.plist on Windows), AirDrop/transfer it to your device, and import it into AirCard-iOS.
• Manual placement: You can also drop any .mobiledevicepairing or .plist directly into On My iPhone › AirCard-iOS via the Files app; it will appear under Discovered in Documents ready to use.

On devices running iOS 27 or newer:

1. In the Pairing tab, tap Pair This iPhone.
2. Note the 6-digit PIN displayed on screen.
3. Open Settings › Privacy & Security › Developer Mode › Pair with AirCard-iOS.
4. Enter the PIN to approve the pairing. AirCard-iOS will complete the handshake and save the credentials.

Install AirCard-iOS.ipa using your preferred sideloading method:

• SideStore or AltStore
• TrollStore
• LiveContainer
• Xcode or iOS App Signer

• macOS 14.0 or newer with Xcode 16 or newer
• XcodeGen (brew install xcodegen)
• Rust toolchain (only needed if rebuilding rust-core)

git clone https://github.com/mak5er/AirCard-iOS.git
cd AirCard-iOS
./build-ipa.sh

The completed package is written to build/AirCard-iOS.ipa.

To compile changes in rust-core:

./build-ios.sh

AirCard-iOS/
├── ios-app/                   # SwiftUI application
│   ├── AirCardApp.swift       # App entry point and lifecycle
│   ├── AppViewModel.swift     # State management and exploit orchestration
│   ├── ContentView.swift      # Main UI views
│   ├── TendiesView.swift      # PosterBoard wallpaper view
│   ├── TendiesEngine.swift    # Tendies extraction and injection logic
│   ├── RespringHelper.swift   # NeoSpring WebKit respring implementation
│   ├── Models.swift           # Image slicing, theme layout, archive packing
│   ├── PairingController.swift# Bonjour host and pairing sync
│   ├── NetworkStatus.swift    # VPN loopback detection
│   ├── Utilities.swift        # Background keep-alive and helper functions
│   ├── GrappaHelper.[h,m]     # ATC protocol helpers
│   ├── Info.plist             # Bundle configuration
│   └── Assets.xcassets/       # App icons and image sets
├── AirliftFFI.xcframework/    # Compiled arm64 Rust static library and headers
├── rust-core/                 # Rust core source code
├── project.yml                # XcodeGen project definition
├── build-ipa.sh               # IPA build script
├── build-ios.sh               # Rust framework build script
├── LICENSE                    # MIT License
└── README.md                  # Project documentation

• @mak5er: Lead developer, UI, passcode theming, Tendies engine, on-device pairing.
• @merybist: Initial base port.
• AirLift by 0xjohnny (@0xjohnnydev): AirTraffic and ATAirlock sandbox escape research underlying AirliftFFI.
• NeoSpring: Swift implementation by @skadz108 and @rooootdev, and @neonmodder123 for the WebKit GPU process respring technique.
• Built upon concepts from the AirCard project.

If you want to support AirCard-iOS development by @mak5er:

• Twitter / X: @mak5er
• GitHub: @mak5er
• PayPal: Donate via PayPal (Maksym Reva)
• TON: UQBm9KPhtMw-XVVjirUoa09wzrlyWsbeZhKfefl1Uw-qNZ-r
• USDT (TRC20): TDkDMCyjYxgvkWUnQiF5Erk2RyPQMT6G1n
• USDT / BNB (BEP20): 0x0954dc491c502849d04956ef74634aa5931a08e8

MIT License. See LICENSE for details.