AirCard-iOS README

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

AirCard-iOS

AirCard-iOS Icon

Apple Wallet card skins, lock screen passcode themes, and PosterBoard wallpapers directly on iOS (18.0 – 27.2 beta 2).

Platform Swift Rust License Donate with PayPal

Overview

AirCard-iOS customizes Apple Wallet card artwork, lock screen passcode dialers, and lock screen wallpapers on device without a jailbreak.

The app communicates with internal system services over a local loopback tunnel (10.7.0.1 or 127.0.0.1) provided by LocalDevVPN. File operations are handled by AirliftFFI, a Rust library that interfaces with the AirTraffic service.

Compatibility

iOS Version Status Pairing Method Features Supported
iOS 27.0 – 27.0.1 ✅ Supported On-device Settings or imported pairing file Wallet skins, Passcode themes, Tendies wallpapers
iOS 27.2 beta 1 – beta 2 ✅ Supported On-device Settings or imported pairing file Tested and working
iOS 18.0 – 26.x ✅ Supported Imported pairing file only Wallet skins & Passcode themes (via SideStore / LiveContainer / AltStore pairing file)
iOS 27.2 beta 3+ ❌ Patched None Apple patched the underlying airlift exploit. Does not work.

[!IMPORTANT] Do not update past iOS 27.2 beta 2: Apple patched the AirTraffic sync exploit in iOS 27.2 beta 3. If you update past beta 2, file injection will no longer work.

Features

Apple Wallet card skins

Passcode dialer themes

PosterBoard wallpapers (.tendies)

Pairing options

Prerequisites

  1. iOS 18.0 – 27.2 beta 2 (iOS 27.0+ for on-device Settings pairing, or imported pairing file on iOS 18–26). Note: iOS 27.2 beta 3+ is patched.
  2. LocalDevVPN / WireGuard: Running in loopback mode (10.7.0.1 or 127.0.0.1) so local connections can reach internal device services.
  3. Pairing record: Either on-device pairing or an imported pairing file.

Pairing Setup Guide

AirCard-iOS requires a pairing record to communicate with device lockdown services. Choose the method that best matches your setup:

If you already use SideStore on your device, it has already created a valid pairing file:

  1. Open AirCard-iOS and go to the Pairing tab.
  2. Tap Import Pairing File….
  3. In the Files document picker, navigate to:
    On My iPhone › SideStore › ALTPairingFile.mobiledevicepairing
  4. Select ALTPairingFile.mobiledevicepairing. The app will load it immediately (Pairing file loaded ✅).

Option B: LiveContainer (with SideStore inside)

If you run SideStore inside LiveContainer:

  1. Open AirCard-iOS › Pairing tab › tap Import Pairing File….
  2. In the Files document picker, navigate to:
    On My iPhone › LiveContainer › SideStore › Documents › ALTPairingFile.mobiledevicepairing
    (depending on your LiveContainer version, you can also check On My iPhone › LiveContainer › Data › App › ... › SideStore › Documents)
  3. Select ALTPairingFile.mobiledevicepairing.

Option C: iLoader / Jitterbug / AltStore / Computer

Option D: On-Device Pairing (iOS 27+ only)

On devices running iOS 27 or newer:

  1. In the Pairing tab, tap Pair This iPhone.
  2. Note the 6-digit PIN displayed on screen.
  3. Open Settings › Privacy & Security › Developer Mode › Pair with AirCard-iOS.
  4. Enter the PIN to approve the pairing. AirCard-iOS will complete the handshake and save the credentials.

Installation

Install AirCard-iOS.ipa using your preferred sideloading method:

Building from source

Requirements

Build the IPA

git clone https://github.com/mak5er/AirCard-iOS.git
cd AirCard-iOS
./build-ipa.sh

The completed package is written to build/AirCard-iOS.ipa.

Rebuilding the Rust framework

To compile changes in rust-core:

./build-ios.sh

Repository structure

AirCard-iOS/
├── ios-app/                   # SwiftUI application
│   ├── AirCardApp.swift       # App entry point and lifecycle
│   ├── AppViewModel.swift     # State management and exploit orchestration
│   ├── ContentView.swift      # Main UI views
│   ├── TendiesView.swift      # PosterBoard wallpaper view
│   ├── TendiesEngine.swift    # Tendies extraction and injection logic
│   ├── RespringHelper.swift   # NeoSpring WebKit respring implementation
│   ├── Models.swift           # Image slicing, theme layout, archive packing
│   ├── PairingController.swift# Bonjour host and pairing sync
│   ├── NetworkStatus.swift    # VPN loopback detection
│   ├── Utilities.swift        # Background keep-alive and helper functions
│   ├── GrappaHelper.[h,m]     # ATC protocol helpers
│   ├── Info.plist             # Bundle configuration
│   └── Assets.xcassets/       # App icons and image sets
├── AirliftFFI.xcframework/    # Compiled arm64 Rust static library and headers
├── rust-core/                 # Rust core source code
├── project.yml                # XcodeGen project definition
├── build-ipa.sh               # IPA build script
├── build-ios.sh               # Rust framework build script
├── LICENSE                    # MIT License
└── README.md                  # Project documentation

Credits

Support & Donations

If you want to support AirCard-iOS development by @mak5er:

License

MIT License. See LICENSE for details.

AirCard-iOS (Mak5er/AirCard-iOS)

Searching Database…

1.9K ·GitHub
AirCard-iOS
Что это?AirCard-iOS позволяет настраивать оформление карт Apple Wallet, темы номеронабирателя на экране блокировки и обои PosterBoard прямо на iPhone с iOS 27 или новее.
Нужно ли делать джейлбрейк iPhone, чтобы этим пользоваться?Нет, он работает без джейлбрейка. Он общается с внутренними системными службами через локальный loopback VPN-туннель и библиотеку обработки файлов на Rust под названием AirliftFFI.
Как установить его на телефон?Установите файл AirCard-iOS.ipa в обход магазина с помощью SideStore, AltStore, TrollStore, LiveContainer или Xcode/iOS App Signer, затем выполните сопряжение с устройством через Developer Mode.
Что должно работать в фоне, чтобы это функционировало?LocalDevVPN должен работать в режиме loopback (10.7.0.1 или 127.0.0.1), чтобы приложение могло обращаться к внутренним службам устройства, а телефон должен быть однажды сопряжён через Developer Mode.
Это работает на любом iPhone?Нет, сейчас поддерживается только iOS 27.0 и новее, поскольку эксплойт и системные пути к файлам, на которых он основан, нацелены именно на этот диапазон версий.
Нужно ли каждый раз подключать его к компьютеру?Нет, после первого сопряжения через Developer Mode по Bonjour приложение полностью работает на самом устройстве — компьютер или внешнее подключение не нужны.
Как именно он меняет оформление карт в Wallet?Он перезаписывает кэшированные изображения карт Passbook (файлы cardBackgroundCombined) и сбрасывает кэши, чтобы новое оформление появилось сразу, — либо на одной карте, либо пакетно на всех обнаруженных.
Могу ли я сделать свой пакет обоев для экрана блокировки и поделиться им?Да, он импортирует и распаковывает архивы обоев .tendies, внедряет их в хранилище PosterBoard и запускает respring через NeoSpring, чтобы применить их мгновенно без перезагрузки.
Можно поделиться созданной мной темой номеронабирателя?Да, темы номеронабирателя можно экспортировать и импортировать как файлы .passthm, так что ими можно делиться с другими пользователями.
Что делает возможной кастомизацию без джейлбрейка?Он основан на исследованиях выхода из песочницы (AirTraffic/ATAirlock) из проекта AirLift, библиотеке файловых операций на Rust под названием AirliftFFI и технике respring через NeoSpring.
What are similar projects?Erosion, AirCard, AirCard-Windows, misaka26, Ketamine, placard, AirCard-macOS, badnotes
Which topics is it in?tweaks, wallpaper, exploit, ios-app, themes, xcode, hacking, theme, apple, sandbox, reverse-engineering, swift
Creator
Mak5er
Size
130.1 MB
Stars
1.9K
Updated
CommitOct 05Releasev1.3.2Oct 04
Age
29d
Commits · 90 Days