177 ·GitHub
What is this?
AirCard for macOS is a native Mac port of the AirCard-Windows flow for customizing Apple Wallet cards: it flashes custom artwork onto cards in your iPhone's Wallet app and can also recolor the iOS passcode keyboard theme.
AirCard for macOS is a native Mac port of the AirCard-Windows flow for customizing Apple Wallet cards: it flashes custom artwork onto cards in your iPhone's Wallet app and can also recolor the iOS passcode keyboard theme.Is this an iPhone app or a Mac app?It is a macOS app (written in Swift 6.2 with Swift Concurrency) that drives a USB-paired iPhone. It relies on private Apple APIs, is experimental, and is not an official Apple tool.
It is a macOS app (written in Swift 6.2 with Swift Concurrency) that drives a USB-paired iPhone. It relies on private Apple APIs, is experimental, and is not an official Apple tool.How do I get it running?Build the universal app from the project folder with Swift Package Manager (or generate the .dmg) and open AirCardMac.app. Then connect a USB-paired iPhone, unlock it, tap 'Trust', and open Apple Books once before the first flash.
Build the universal app from the project folder with Swift Package Manager (or generate the .dmg) and open AirCardMac.app. Then connect a USB-paired iPhone, unlock it, tap 'Trust', and open Apple Books once before the first flash.Are there any catches I should know about?Yes — on Apple Pay cards you can only replace the artwork: iOS and the card issuer decide the number color, and Wallet ignores --white/--black suffixes for those assets. The port never modifies pass.json.
Yes — on Apple Pay cards you can only replace the artwork: iOS and the card issuer decide the number color, and Wallet ignores --white/--black suffixes for those assets. The port never modifies pass.json.What Mac and iPhone do I need?The .dmg ships a universal AirCardMac.app that runs on both Apple Silicon and Intel Macs. On the iPhone side it has been tested with an iPhone18,3 running iOS 27.2.
The .dmg ships a universal AirCardMac.app that runs on both Apple Silicon and Intel Macs. On the iPhone side it has been tested with an iPhone18,3 running iOS 27.2.Does flashing touch anything else on my iPhone?No — only the assets of the selected card are written and its caches invalidated. Apple Books temp files are preserved and restored, generated artifacts are cleaned up, and pass.json stays untouched.
No — only the assets of the selected card are written and its caches invalidated. Apple Books temp files are preserved and restored, generated artifacts are cleaned up, and pass.json stays untouched.How do I apply a new skin to a card?Tap 'Scan from Wallet' and pick the card in Apple Wallet so the hash fills in automatically (or paste it manually), choose an image, then hit 'Apply skin'. Afterward, close and reopen Wallet on the iPhone to see the change.
Tap 'Scan from Wallet' and pick the card in Apple Wallet so the hash fills in automatically (or paste it manually), choose an image, then hit 'Apply skin'. Afterward, close and reopen Wallet on the iPhone to see the change.Can I stack my own graphics on top of the card art?Yes. You can add one or more transparent PNG overlays, reorder them, and preview the result before flashing; overlays are combined in the order shown and included in every variant Wallet receives.
Yes. You can add one or more transparent PNG overlays, reorder them, and preview the result before flashing; overlays are combined in the order shown and included in every variant Wallet receives.What does the keyboard recoloring feature do?It applies .passthm passcode-keyboard themes for TelephonyUI-8/9/10. Since the digits are rasterized images rather than text, it recolors the key PNGs and writes --white/--black variants (-bold too, for Bold Text) into the TelephonyUI cache, then locks the iPhone so the cache reloads.
It applies .passthm passcode-keyboard themes for TelephonyUI-8/9/10. Since the digits are rasterized images rather than text, it recolors the key PNGs and writes --white/--black variants (-bold too, for Bold Text) into the TelephonyUI cache, then locks the iPhone so the cache reloads.Which image sizes and formats does it produce?It prepares card art at 1536×969 and 1024×646 as PNG plus a PDF variant, preserving image edges, and writes Apple Pay artwork under the canonical names cardBackgroundCombined, diffuse, background and strip at 3x, 2x and PDF.
It prepares card art at 1536×969 and 1024×646 as PNG plus a PDF variant, preserving image edges, and writes Apple Pay artwork under the canonical names cardBackgroundCombined, diffuse, background and strip at 3x, 2x and PDF.What are similar projects?MonitorControl, AirCard, omarchy-apple-dev, AirCard-iOS, placard, swiftui-logo-draw, textream, Wind-Waker-Recomp
MonitorControl, AirCard, omarchy-apple-dev, AirCard-iOS, placard, swiftui-logo-draw, textream, Wind-Waker-RecompWhich topics is it in?png, swift-package-manager, iphone, wallet, keyboard, xcode, theme, apple, macos-app, reverse-engineering, apple-silicon, image-processing
png, swift-package-manager, iphone, wallet, keyboard, xcode, theme, apple, macos-app, reverse-engineering, apple-silicon, image-processing