README

AirCard 🎴

 Apple Wallet Card Skinner & Lockscreen Passcode Themer (No Jailbreak Required)  
 Supports iOS 18.0 – 27.0.1 & iOS 27.2 beta 1–2 (iOS 27.2 beta 3+ patched)  
 Powered by the airlift AirTraffic sync exploit.


  


---

 Compatibility

| iOS Version | Status | Notes |
| :--- | :--- | :--- |
| iOS 18.0 – 27.0.1 | ✅ Supported | Full support for Wallet skins and Lockscreen passcode themes |
| iOS 27.2 beta 1 – beta 2 | ✅ Supported | Working |
| iOS 27.2 beta 3+ | ❌ Patched | Apple patched the underlying airlift exploit. Flashing will not work. |

 [!IMPORTANT]
 Do not update to iOS 27.2 beta 3 or newer if you want to continue using AirCard. The underlying AirTraffic sync exploit was patched by Apple in beta 3.

---

 Features
- 🎨 Custom Card Skins: Assign custom artwork, textures, or bank logos to Apple Pay and Wallet cards.
- 🔢 Lock Screen Passcode Themes (.passthm): Apply custom keypad button artwork from popular .passthm themes directly to iOS 18+ lockscreen.
- 🧩 Passcode Theme Creator: Create custom themes from a single wallpaper (Seamless Poster Slicing) or build key-by-key (Individual Keys).
- 🔍 Interactive Photo Framing: Pan and zoom artwork directly inside keypad buttons with real-time iPhone preview.
- ✏️ Edit Existing .passthm Themes: Open any Cowabunga or Nugget theme package directly in the creator, tweak button artwork, reposition photos, and re-export or flash.
- ⚡ Per-Card & Bulk Customization: Set unique artwork for each card or apply one design across all cards with a single click.
- 📱 Zero-Hassle Card Detection: Tap any card in your iPhone's Wallet app to detect its hash in real-time.
- 🚀 100% Standalone (Universal): Native support for both Apple Silicon and Intel (x86) Macs. All required device-communication utilities and image engines are pre-bundled inside the app.
- 📦 Zero Prerequisites: No Homebrew, Python packages, or terminal setup required for macOS users.

---

 Guides and sample artwork

Wallet setup, detailed troubleshooting, multi-card workflows, theme creation, compatibility reporting, and local artwork preparation:

- 简体中文使用指南
- English getting-started guide
- Card artwork and source notes
- Offline card artwork editor — download a single HTML file, frame an image locally, and export a 1536 × 969 PNG

---

 Installation

 macOS (Universal DMG)
1. Download AirCard.dmg from Releases.
2. Open AirCard.dmg and drag AirCard.app into your Applications folder.
3. Fully compatible with both Apple Silicon and Intel (x86) Macs.

 [!NOTE]
 First Launch on macOS (Gatekeeper):
 If macOS displays an unidentified developer prompt on first launch:
 - Method 1 (UI): Right-click (or Control-click) AirCard.app in Applications ➔ click Open ➔ click Open.
 - Method 2 (Terminal):
   sh
   sudo xattr -cr /Applications/AirCard.app
   

 [!TIP]
 macOS Developer Tools / Python Requirement:
 AirCard uses macOS native Python 3 (/usr/bin/python3). If macOS prompts that Developer Tools are required or if you recently installed/updated Xco

Top issues

Latest release

What's Changed in v1.2.6 (Hotfix Release)

This release addresses regressions in card discovery, UI card visibility, manual card hash entry, and cache invalidation introduced in v1.2.5.

 🔍 Wallet Card Discovery Restored (97, 102, 109, 136)
- Universal Log Parsing: Added recognition of PassKitUI: Dashboard loading (...) log lines where iOS outputs the active card hash when opening or tapping cards.
- Session & Global passIDs: Expanded scanner parsing to capture both passIDs[InSession] and passIDs[global] from nfcd.
- JSON Activation Support: NFC activations logged in modern JSON dictionary for