AirCard README

The project's README from github.com/Mak5er/AirCard. As one markdown file: README.md.

AirCard 🎴

Apple Wallet Card Skinner & Lockscreen Passcode Themer for iOS 18+ (No Jailbreak Required)
Tested on iOS 27 release. Powered by the airlift AirTraffic sync exploit.

Donate with PayPal

Features

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):
    sudo xattr -cr /Applications/AirCard.app

How to Customize Apple Wallet Cards

  1. Connect your iPhone to your Mac via USB cable and ensure it is unlocked and trusted.
  2. In AirCard, stay on the Wallet Cards tab and click Scan Cards.
  3. On your iPhone:
    • Double-click the Side (Power) button to open Apple Pay.
    • Authenticate with Face ID.
    • Tap your card (or tap it once more) to trigger instant detection!
  4. Click on any card mockup or drag & drop an image directly onto the card.
  5. Click Flash Skins.
  6. Force-close the Wallet app on your iPhone from the App Switcher (or reboot) to see your new custom card design!

If scanning finds no cards

The scanner uses the iPhone's unified log service, including Info/Debug events. On iOS 18.6.2, the legacy log service can show Wallet activity while omitting the resource lookup messages that contain card identifiers.

Open Log and check for Connected to the unified device log stream, then double-click the side button, authenticate, and tap or switch cards. If the log reader stops, reconnect and unlock the iPhone, then start another scan. Values that iOS replaces with <private> cannot be recovered by the scanner.

If your device previously connected but scanning found zero cards, please try this build and report whether it helps. Include your iPhone model, iOS version, macOS version, and the AirCard version or commit tested. Avoid posting full device logs or card identifiers. See scanner validation for the verified environment and remaining coverage.

How to Apply Lockscreen Passcode Themes (.passthm)

  1. Switch to the Passcode Themes tab at the top of AirCard.
  2. Drag & drop any .passthm file into the app (or click Choose .passthm File).
  3. AirCard will inspect the theme and display an interactive preview on the numeric keypad (0–9, *, #).
  4. Click Apply Passcode Theme.
  5. Restart your iPhone to reload the lock screen cache and see your custom passcode buttons!

[!TIP] Universal Language & Bold Text Support:
AirCard automatically expands and flashes custom keypad assets for all system locales (English, Ukrainian, Russian, Spanish, German, French, etc.) and generates both standard and Bold Text cache bitmaps (--white and --white-bold), ensuring your theme works regardless of your iOS language or accessibility display settings!

Building from Source

git clone https://github.com/mak5er/AirCard.git
cd AirCard
chmod +x build.sh
./build.sh

This builds universal binaries (arm64 + x86_64), bundles dependencies into build/AirCard.app, and outputs build/AirCard.dmg.

Contributors

Credits

Support

If you find AirCard useful, you can support future development:

AirCard (Mak5er/AirCard)

Searching Database…

6.7K ·GitHub
AirCard
What is this?AirCard is a macOS app that lets you customize Apple Wallet card skins and iOS lockscreen passcode keypad themes on iOS 18+ without jailbreaking your iPhone.
Is this a jailbreak tool or something else?No, it's a standalone macOS desktop app that connects to your iPhone over USB and flashes custom artwork using a sandbox-escape technique called 'airlift', without jailbreaking the device.
How do I install and set it up?Download AirCard.dmg from the Releases page and drag AirCard.app into your Applications folder. On first launch, if macOS blocks it, right-click the app and choose Open to bypass Gatekeeper.
What do I need to use it?A Mac (Apple Silicon or Intel) and an iPhone on iOS 18+ connected via USB, unlocked and trusted. No Homebrew, Python, or terminal setup is required since all tools are pre-bundled.
Does card scanning always find my cards?Not always. On some iOS builds (e.g. 18.6.2) the device's log service can show Wallet activity but omit the resource lookup messages that contain card identifiers, causing zero cards to be detected.
Does it need Apple Silicon, or does it work on Intel Macs too?It works on both: AirCard ships as a universal binary supporting Apple Silicon and Intel (x86) Macs.
What exactly is the airlift exploit it uses?It's based on AirLift's AirTraffic/ATAirlock sandbox-escape proof of concept, which AirCard uses as the underlying mechanism (AirliftFFI) to flash custom assets onto the device.
Can I create my own lockscreen passcode theme?Yes, the built-in Passcode Theme Creator lets you build a theme from a single wallpaper via seamless poster slicing or design each keypad button individually.
Does it support non-English keyboards and accessibility settings?Yes, AirCard automatically generates keypad assets for all system locales and both standard and Bold Text cache bitmaps, so themes work regardless of language or accessibility display settings.
Can I edit themes made by other tools like Cowabunga or Nugget?Yes, AirCard can open existing .passthm theme packages from Cowabunga or Nugget directly in its creator so you can tweak artwork and re-export or re-flash them.
What are similar projects?TrollStore, AirCard-iOS, AirCard-macOS, macPad, Erosion, misaka26, AirCard-Windows, badnotes
Which topics is it in?universal, iphone, x86, jailbreak, exploit, themes, installer, hacking, apple, macos-app, sandbox, reverse-engineering
Creator
Mak5er
Size
8.5 MB
Stars
6.7K
Updated
CommitOct 05Releasev1.2.6Oct 04
Age
1mo
Commits · 90 Days