AirCard-macOS README

The project's README from github.com/alejadxr/AirCard-macOS. As one markdown file: README.md.

AirCard macOS

Port nativo para macOS del flujo de personalización de tarjetas de Apple Wallet de AirCard-Windows. La interfaz y la orquestación están escritas en Swift 6.2 y usan Swift Concurrency para la detección del iPhone, preparación de imágenes y escritura atómica.

Estado: probado con un iPhone18,3 en iOS 27.2 (build 24B5084k). El proyecto usa APIs privadas de Apple y es experimental; no es una herramienta oficial.

Ejecutar

Desde esta carpeta:

chmod +x Scripts/build_helpers.sh
Scripts/build_helpers.sh
swift run

Para generar una aplicación universal que puedas abrir con doble clic:

chmod +x Scripts/build_app.sh
Scripts/build_app.sh
open build/AirCardMac.app

Para generar también un instalador .dmg:

chmod +x Scripts/build_dmg.sh
Scripts/build_dmg.sh
open build/AirCardMac.dmg

El DMG contiene la aplicación universal AirCardMac.app para Apple Silicon e Intel.

Conecta un iPhone emparejado por USB, desbloquéalo y pulsa “Confiar”. Abre Apple Books una vez antes del primer flash. Pulsa “Escanear desde Wallet”, abre Apple Wallet y toca la tarjeta; el hash se rellenará solo. También puedes pegar el hash manualmente. Después elige una imagen, añade uno o varios overlays PNG transparentes si quieres, y pulsa “Aplicar skin”. Los overlays se combinan en el orden mostrado y se incluyen en todas las variantes que recibe Wallet. Al terminar, cierra y abre Wallet en el iPhone.

El flujo conserva/restaura los archivos temporales de Books y limpia los artefactos generados. Solo se escriben los assets de la tarjeta seleccionada y se intentan invalidar sus cachés.

Alcance actual

Sobre el color de los números

El repositorio original también soporta paquetes .passthm para el teclado de código de iOS. Los números no son texto recoloreable: son imágenes rasterizadas que se copian a cachés de TelephonyUI con nombres como:

en-2-A B C--white.png
en-2-A B C--white-bold.png

Por tanto, para cambiar el color hay que recolorear o regenerar los PNG de las teclas y después escribir las variantes correspondientes en /var/mobile/Library/Caches/TelephonyUI-10 (o -9/-8, según iOS). La variante -bold es la que usa iOS cuando está activo “Texto en negrita”.

En la app: elige un .passthm, selecciona el color, verifica la previsualización y pulsa “Aplicar color al teclado”. El port conserva los nombres y variantes del paquete, convierte JPG/JPEG a PNG y hace la escritura por lotes con fallback individual. Después bloquea el iPhone para que TelephonyUI recargue la caché.

Además de conservar el nombre original, la variante elegida en la interfaz se escribe como --white o --black; si la imagen es -bold, se usa --white-bold o --black-bold respectivamente.

Para tarjetas Apple Pay, iOS dibuja los números y normalmente decide su color internamente; el port original tampoco modifica pass.json, solo reemplaza el artwork y limpia las cachés de Wallet. La build actual escribe además los assets canónicos diffuse, background y strip, siguiendo el port iOS relacionado, porque algunas variantes de Wallet pueden leer esos nombres en lugar de cardBackgroundCombined.

AirCard-macOS (alejadxr/AirCard-macOS)

Searching Database…

Что это такое?AirCard для macOS — это нативная Mac-версия инструмента AirCard-Windows для настройки карт в Apple Wallet: она прошивает собственные изображения на карты в приложении Wallet на iPhone, а ещё может менять цветовую тему клавиатуры ввода код-пароля в iOS.
Это приложение для iPhone или для Mac?Это приложение для macOS (написано на Swift 6.2 с использованием Swift Concurrency), которое управляет подключённым по USB iPhone. Оно опирается на приватные API Apple, является экспериментальным и не является официальным инструментом Apple.
Как его запустить?Соберите универсальное приложение из папки проекта с помощью Swift Package Manager (или сгенерируйте .dmg) и откройте AirCardMac.app. Затем подключите iPhone по USB (сопряжённый ранее), разблокируйте его, нажмите «Доверять» и один раз откройте Apple Books перед первой прошивкой.
Есть ли подводные камни, о которых стоит знать?Да — на картах Apple Pay можно заменить только изображение: цвет номера определяют iOS и банк-эмитент, а Wallet игнорирует варианты с суффиксами --white/--black для этих ресурсов. Порт никогда не изменяет pass.json.
Какой Mac и iPhone мне нужны?В .dmg входит универсальное AirCardMac.app, которое работает и на Mac с Apple Silicon, и на Intel. Со стороны iPhone протестировано на iPhone18,3 с iOS 27.2.
Прошивка затрагивает что-то ещё на моём iPhone?Нет — записываются только ресурсы выбранной карты и сбрасываются её кэши. Временные файлы Apple Books сохраняются и восстанавливаются, сгенерированные артефакты удаляются, а pass.json остаётся нетронутым.
Как применить новый скин к карте?Нажмите «Scan from Wallet» и выберите карту в Apple Wallet, чтобы хеш подставился автоматически (или вставьте его вручную), выберите изображение и нажмите «Apply skin». После этого закройте и заново откройте Wallet на iPhone, чтобы увидеть изменение.
Можно ли наложить свою графику поверх изображения карты?Да. Можно добавить одну или несколько прозрачных PNG-наложек, изменить их порядок и посмотреть предварительный результат перед прошивкой; наложения объединяются в показанном порядке и входят в каждый вариант, который получает Wallet.
Что делает функция перекраски клавиатуры?Она применяет темы клавиатуры код-пароля в формате .passthm для TelephonyUI-8/9/10. Поскольку цифры там представляют собой растровые изображения, а не текст, она перекрашивает PNG-файлы клавиш и записывает варианты --white/--black (а также -bold для жирного текста) в кэш TelephonyUI, затем блокирует iPhone, чтобы кэш перезагрузился.
Какие размеры и форматы изображений она создаёт?Она готовит изображения карт в размерах 1536×969 и 1024×646 в формате PNG плюс вариант в PDF, сохраняя края изображения, и записывает графику Apple Pay под каноническими именами cardBackgroundCombined, diffuse, background и strip в 3x, 2x и PDF.
Creator
alejadxr
Size
4.5 MB
Stars
177
Age
26d
Commits · 90 Days