How alrrstd/aircard-windows works
AirCard is a Windows desktop and interactive-CLI tool for customizing Apple Wallet card artwork on a connected iPhone. The main workflow is to detect or select a card, prepare artwork, then write card assets and invalidate caches; the Apple Cash studio adds 3D-metal asset generation and flashing. The README also documents card restoration and holographic effects. Source excerpts show the core flash and sync mechanisms, but not every GUI action or restoration implementation, so those relationships are documented at the product level where needed.
Main entry points: core_flasher.py Card asset flasher · app.py Desktop studio · cli.py Interactive CLI · apple_cash.py Apple Cash 3D assets
Components 16
User interfaces
- Desktop studio
app.py - Interactive CLI
aircard/cli.py - CLI launcher
main.py
Card discovery
- Live card scanner
aircard/scanner.py - Saved card catalog
aircard/scanner.py - Card and asset config
aircard/config.py
Artwork studio
- Skin image processing
aircard/image_util.py - Apple Cash 3D assets
aircard/apple_cash.py
Device and flashing
- Device and lockdown
aircard/device.py - Card asset flasher
aircard/core_flasher.py - AirTraffic sync bridge
aircard/airtraffic.py
Other components
- User
- Connected iPhone
- Apple device DLLs
- Apple Wallet
- Apple factory assets
Connections 31
- User → Desktop studio: uses
README.md - User → CLI launcher: launches
README.md - CLI launcher → Interactive CLI: calls
main.py - Desktop studio → Live card scanner: scans cards
app.py - Desktop studio → Saved card catalog: manages cards
app.py - Interactive CLI → Live card scanner: scans cards
aircard/cli.py - Interactive CLI → Saved card catalog: reads and saves
aircard/cli.py - Live card scanner → Saved card catalog: persists metadata
aircard/scanner.py - Live card scanner → Card and asset config: uses paths and patterns
aircard/scanner.py - Live card scanner → Device and lockdown: opens lockdown
aircard/scanner.py - Desktop studio → Skin image processing: prepares artwork
app.py - Interactive CLI → Skin image processing: prepares artwork
aircard/cli.py - Desktop studio → Card asset flasher: flashes card skin
app.py - Interactive CLI → Card asset flasher: flashes card skin
aircard/cli.py - Desktop studio → Apple Cash 3D assets: creates and flashes 3D assets
app.py - Apple Cash 3D assets → Card asset flasher: uses cache invalidation
aircard/apple_cash.py - Apple Cash 3D assets → Device and lockdown: opens lockdown
aircard/apple_cash.py - Apple Cash 3D assets → Skin image processing: uses transparent PNG
aircard/apple_cash.py - Card asset flasher → Device and lockdown: opens lockdown
aircard/core_flasher.py - Card asset flasher → AirTraffic sync bridge: syncs assets
aircard/core_flasher.py - Card asset flasher → Skin image processing: uses transparent PNG
aircard/core_flasher.py - Card asset flasher → Card and asset config: uses asset lists
aircard/core_flasher.py - AirTraffic sync bridge → Card and asset config: finds DLL directory
aircard/airtraffic.py - Device and lockdown → Connected iPhone: connects over USB
aircard/device.py - Card asset flasher → Connected iPhone: writes card files
aircard/core_flasher.py - AirTraffic sync bridge → Connected iPhone: syncs assets
README.md - AirTraffic sync bridge → Apple device DLLs: calls native bridge
aircard/airtraffic.py - Apple Cash 3D assets → Apple factory assets: downloads official logos
aircard/apple_cash.py - User → Connected iPhone: selects card in Wallet
README.md - Desktop studio → Skin image processing: applies holographic effects
app.py - Desktop studio → Card asset flasher: restores factory artwork
README.md