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 是一款 macOS 应用,可以让你在 iOS 18 及以上版本的 iPhone 上自定义 Apple Wallet 卡片皮肤和 iOS 锁屏密码键盘主题,无需越狱。
这是越狱工具还是别的什么?不是。它是一款独立的 macOS 桌面应用,通过 USB 连接你的 iPhone,利用一种名为 airlift 的沙盒逃逸技术刷入自定义图片,全程无需越狱。
怎么安装和配置?从 Releases 页面下载 AirCard.dmg,并将 AirCard.app 拖入你的应用程序文件夹。首次启动时,如果 macOS 拦截了应用,右键点击应用并选择“打开”即可绕过 Gatekeeper。
使用它需要什么条件?需要一台 Mac(Apple Silicon 或 Intel)和一台 iOS 18 及以上版本的 iPhone,通过 USB 连接,保持解锁并信任电脑。所有工具都已预先打包,因此无需 Homebrew、Python,也无需配置终端。
扫描卡片总能找到我的卡吗?不一定。在某些 iOS 版本(例如 18.6.2)上,设备的日志服务虽然会显示 Wallet 活动,却会遗漏包含卡片标识符的资源查找消息,导致一张卡也检测不到。
它需要 Apple Silicon 芯片吗,还是 Intel Mac 也能用?两者都可以:AirCard 以通用二进制形式发布,同时支持 Apple Silicon 和 Intel(x86)架构的 Mac。
它使用的 airlift 漏洞利用到底是什么?它基于 AirLift 项目的 AirTraffic/ATAirlock 沙盒逃逸概念验证,AirCard 以此作为底层机制(AirliftFFI)把自定义资源刷入设备。
我可以自己制作锁屏密码主题吗?可以。内置的 Passcode Theme Creator 既可以通过无缝海报切分从一张壁纸生成主题,也可以逐个设计键盘上的每个按键。
它支持非英文键盘和无障碍设置吗?支持。AirCard 会为所有系统区域自动生成键盘素材,并同时生成标准与粗体文本两种缓存位图,因此无论系统语言或无障碍显示设置如何,主题都能正常使用。
我可以编辑 Cowabunga 或 Nugget 等其他工具制作的主题吗?可以。AirCard 能够直接在其创作器中打开来自 Cowabunga 或 Nugget 的现有 .passthm 主题包,让你调整图片后重新导出或重新刷入。
Creator
Mak5er
Size
8.5 MB
Stars
6.7K
Age
1mo
Commits · 90 Days