How sheldonjoo/aircard-zh works
AirCard is a macOS app for customizing Apple Wallet card artwork and iPhone lock-screen passcode themes. The main workflows select or discover an iPhone and card, prepare artwork or a theme, then write assets to the device and refresh caches. The README also documents theme creation and editing, interactive previews, and bulk card updates. The excerpts show the backend and device-write mechanisms; wiring for some Swift UI actions and theme-creator operations is not fully sampled, so uncertain links are omitted.
Main entry points: aircard_backend.py Command Backend · apply_card_skin.py Device File Writer · device_helper.m Device Helper · AirCardApp.swift AirCard UI
Components 18
macOS Interface
- AirCard UI
AirCardApp.swift - Command Backend
aircard_backend.py
Wallet Skins
- Saved Card Hashes
aircard.py - Card Detection
aircard.py - Image Preparation
aircard.py - Asset Builder
card_assets.py - Skin Writer
aircard_backend.py - Cache Invalidation
apply_card_skin.py
Passcode Themes
- Theme Creator
AirCardApp.swift - Theme Parser
aircard_backend.py - Theme Writer
aircard_backend.py
Device Access
- Device File Writer
apply_card_skin.py - AirTraffic Host
Sources/airtraffic_host.m - Airlift Target
Sources/airlift_target.h - Device Helper
Sources/device_helper.m
Other components
- User
- iPhone
- Apple Wallet
Connections 22
- User → AirCard UI: uses
- AirCard UI → Command Backend: requests operations
- AirCard UI → Theme Creator: creates or edits
- Command Backend → Saved Card Hashes: loads and saves
- Command Backend → Card Detection: scans logs
- Card Detection → Device Helper: streams syslog
- Device Helper → iPhone: reads logs
- Command Backend → Image Preparation: prepares artwork
- Command Backend → Asset Builder: builds assets
- Command Backend → Skin Writer: writes card skin
- Skin Writer → Device File Writer: writes files
- Skin Writer → Cache Invalidation: invalidates caches
- Cache Invalidation → Device File Writer: writes cache files
- Command Backend → Theme Parser: parses theme
- Command Backend → Theme Writer: applies theme
- Theme Writer → Device File Writer: writes theme files
- Device File Writer → AirTraffic Host: dispatches writes
- Device File Writer → Device Helper: stages and finishes
- AirTraffic Host → iPhone: transfers files
- Device Helper → iPhone: accesses device
- Airlift Target → Device Helper: defines targets
- iPhone → Apple Wallet: displays updated skin