AirCard-Windows README

The project's README from github.com/Lumid-Off/AirCard-Windows. As one markdown file: README.md.

AirCard (Windows) 🎴

Apple Wallet Card Skinner & Lockscreen Passcode Themer for iOS 18+ (No Jailbreak Required)
Native Windows client written in Rust. Powered by the airlift AirTraffic sync exploit.


Features


Requirements


⚠️ Troubleshooting & Driver Repair (If Nothing Works)

[!TIP] iPhone not detected, AirTraffic sync hangs, or operation fails?
Corrupted or conflicting Apple USB drivers on Windows are the #1 root cause.

  1. Download and install 3uTools.
  2. Disconnect your iPhone from your PC.
  3. In 3uTools, go to Toolbox ➔ Repair Driver.
  4. Click Repair Now and wait for the Apple driver reinstallation to finish.
  5. Reconnect your unlocked iPhone, tap Trust, and launch AirCard.

Installation

Pre-built Executable

  1. Download aircard.exe from Releases.
  2. Connect your iPhone via USB, unlock it, and tap "Trust this Computer" if prompted.
  3. Run aircard.exe. After WiFi sync is enabled, later sessions can work without the cable.

WiFi Connection Setup

  1. Connect the iPhone by USB for the initial pairing.
  2. In Apple Devices or iTunes, enable Show this iPhone when on Wi-Fi / Sync with this iPhone over Wi-Fi.
  3. Apply the setting, then keep the iPhone and PC on the same local network.
  4. In AirCard, click Refresh and confirm the device shows a WiFi transport.
  5. Disconnect the cable, click Refresh again, and select WiFi only. Use Auto (USB preferred) when automatic fallback is desired.

If both transports are available, Auto uses USB first and falls back to WiFi. For a guaranteed end-to-end WiFi route, disconnect the USB cable, click Refresh, and then choose WiFi only. This is required because Apple's AirTraffic API selects its route by UDID rather than accepting a transport parameter.


How to Customize Apple Wallet Cards

  1. Connect your iPhone through USB or paired WiFi and ensure it is unlocked.
  2. In AirCard, stay on the Wallet tab and click Scan.
  3. On your iPhone:
    • Open Apple Wallet (or double-click the Side/Power button).
    • Tap the card you want to customize.
    • AirCard intercepts and saves the card hash automatically. Click Stop.
  4. Click Choose Image... to pick your artwork (PNG, JPG, or WebP — drag inside the preview to position the crop, then scale it to 1536 × 969).
  5. Click Apply Card Skin.
  6. Force-close the Wallet app on your iPhone from the App Switcher (swipe up from bottom, then swipe Wallet away) and reopen Wallet to see your new card!
  7. The first apply stores a local backup of the original card face. Use Restore Original later to write it back and invalidate Wallet's cached artwork.

How to Apply Lockscreen Passcode Themes (.passthm)

  1. Switch to the Passcode tab in AirCard.
  2. Click Choose .passthm... and select any .passthm package (Cowabunga or Nugget).
  3. Select your target iOS version cache:
    • Auto (TelephonyUI-10) — iOS 18+ (Default)
    • TelephonyUI-9 — iOS 16 - 17
    • TelephonyUI-8 — Legacy iOS
  4. Click Apply Passcode Theme.
  5. Lock your iPhone screen or open Phone dialer to see your new custom passcode keypad buttons!

[!IMPORTANT] Turn OFF Bold Text:
On your iPhone, go to Settings ➔ Display & Brightness and make sure Bold Text is turned OFF. If Bold Text is enabled, iOS ignores cached dialer button graphics and renders system vector fonts instead.


Building from Source

Prerequisites: Rust toolchain (stable-x86_64-pc-windows-msvc).

# Clone the repository
git clone https://github.com/Lumid-Off/AirCard-Windows.git
cd AirCard-Windows

# Run tests
cargo test

# Build release binary
cargo build --release

The compiled binary will be in target\release\aircard.exe.


Contributors

Credits

AirCard-Windows (Lumid-Off/AirCard-Windows)

Searching Database…

这是什么?AirCard 是一款 Windows 应用,让你在 iOS 18 及以上系统上给 Apple Wallet 卡片换自定义皮肤、给锁屏密码键盘换自定义主题,全程无需越狱 iPhone。
这是 Windows 程序,还是要装在我 iPhone 上的东西?它是一个用 Rust 编写、带 egui/eframe 图形界面的原生 Windows 桌面应用(单个 aircard.exe,约 7.5 MB);它通过 USB 或 WiFi 与 iPhone 通信,手机本身不安装任何东西。
怎么让它跑起来?从 Releases 页面下载 aircard.exe,用 USB 连接 iPhone,解锁并点按“信任此电脑”,然后运行 aircard.exe 即可。
除了应用本身还需要什么?64 位 Windows 10/11、用于设备驱动的 Apple Mobile Device Support(或 64 位 iTunes),以及首次配对用的 Lightning 或 USB-C 数据线。
最容易出问题的地方是什么?冲突或损坏的 Apple USB 驱动是连接失败的头号原因,需要用 3uTools 修复;另外,除非在 iOS 显示设置里关闭粗体文字,否则密码主题不会显示。
它也能在 macOS 上运行吗?不能。这个仓库是仅限 Windows 的 Rust 移植版;原版 macOS 应用和底层漏洞研究是由另一位开发者独立完成的。
具体能自定义哪些东西?钱包里 Apple Pay/Apple Cash 卡片的卡面,以及用 Cowabunga 或 Nugget 的 .passthm 主题包自定义的锁屏拨号键盘按键。
撤销我的修改安全吗?安全。第一次应用卡片皮肤时,AirCard 会在本地备份原始卡面,你可以点击 Restore Original 恢复原状并清除 Wallet 缓存的卡面图案。
它是如何做到无需越狱的?它依赖一个名为 'airlift' 的漏洞利用,滥用 Apple 内置的 AirTraffic 同步通道,因此从不修改 iPhone 的系统分区,也不会禁用安全机制。
不用数据线,能通过 WiFi 使用吗?可以——首次 USB 配对后,你可以在 Apple Devices/iTunes 里启用 WiFi 同步,然后在 AirCard 中选择 'WiFi only',之后不用数据线也能继续使用。
Creator
Lumid-Off
Size
0.1 MB
Stars
1.4K
Age
29d
Commits · 90 Days