Apparition
Download

Develop, debug and sideload.

Apparition builds your Xcode projects onto Apple Vision Pro, iPhone, iPad and Apple TV, patches Swift into the running app without a rebuild, and lets you or an agent debug it live through DebugTrace. It also sideloads other people's apps, launches them with JIT, and re-signs them every week over Tailscale, with no cable and no computer on the same network.

Free and open source under the MIT license. For macOS, Windows and Linux: a Mac gives the most complete setup, and none is required.

Three steps, then the device runs itself

  1. Install Apparition and pair your device

    Download the app and pair your device. On Vision Pro, open Settings > General > Remote Devices and type the code it shows; Apple TV pairs from Settings > Remotes and Devices > Remote App and Devices. An iPhone or iPad pairs over a USB cable once. Apparition then installs itself on the device, already set up to sign.

    Prefer a terminal? The apparition command line does the same.

  2. Install apps, or build your own

    Sign in with your Apple ID, or choose your own certificate. Then add a source and install from it right on the device, or add an Xcode project and build it onto the device.

  3. Let it refresh itself

    A daily Shortcuts automation re-signs your apps before they expire, and launching with JIT works from the device too. Both reach your computer, left in the menu bar, only when they need it.

A faster loop for your own apps

Your Mac builds, the device runs, and what you change is in the running app a few seconds later. Choose Develop apps when the desktop app first opens, or switch in its header at any time.

Xcode projects to your devices
Add a project's folder and build it onto a device from the Mac, or from the headset. Launch it with JIT when it needs to generate code, with its console attached.
Live patching, no rebuild
Edit a Swift file and run apparition inject: the running app has the change in a few seconds, with its state intact. The device asks you to allow code changes, so nothing is patched behind your back.
DebugTrace, built in
DebugTrace is the Swift package that makes your app debuggable while it runs. You, or an agent on the Mac, can read its state, drive it, watch its log, profile it and check its memory, with no logging added. A value you are tuning, such as a brightness or a timing, becomes a slider in the Mac app. Crashes arrive as traces, symbolicated.
From a PC, through the Mac
Pair a Windows or Linux computer, or another Mac, with your Mac. Its agents debug your apps through the Mac, and its builds go to your devices with apparition deploy, at home or over Tailscale.
In the app: register once
DebugSurface.shared.register([
  .query("player", "Position and mode") { _ in
    Player(x: game.x, flying: game.flying)
  },
  .command("teleport", "Move the player",
    parameters: [.number("x", "world x")]) { args in
    game.teleport(x: try args.requireDouble("x"))
  },
])
From the Mac: change it live
apparition build --run --mcp --inject
apparition inject com.example.app \
  --device AVP --file Sources/Update.swift
apparition inject com.example.app \
  --device AVP --run 'return model.count'

Sideloading and JIT, without the weekly chore

The same tool installs other people's apps. A free Apple ID signs them for seven days, and Apparition re-signs them before they expire.

Sources you already use
Add AltStore and SideStore sources, or point at a GitHub repo for apps that only publish release files. Share an IPA or .deb to Apparition and it asks before installing.
Refresh with Shortcuts
The Refresh Apps action re-signs whatever expires within three days. Run it from a daily automation, or ask Siri. A refresh needs no download, and your app data stays put.
JIT that works on current chips
On iOS 26 with an A15 or M2 and later, and on visionOS 27, a debugger attached once no longer lets an app run generated code. Apparition keeps it attached and prepares the memory the app asks for, so emulators like UTM and ARMSX2 run, from Apparition, a shortcut or Siri.
Your own certificate
With a paid developer account, import a .p12 and provisioning profiles. Apps then sign for as long as the profile lasts, usually a year, with no sign-in, no anisette and no free-account limits.

Refresh and launch from anywhere

Put the device and the computer running Apparition on Tailscale, and the weekly refresh, signing and JIT keep working wherever the device is. No cable, no trip home, no Xcode and no computer on the same network. A sleeping Mac at home wakes when the device knocks.

Your Mac at home does the work
The Mac app, left in the menu bar, connects to the device for it, over your Wi-Fi or over Tailscale. Type its Tailscale address into Apparition's Setup once.
Tailscale stays on
AltStore needs its computer on the same Wi-Fi. SideStore and StikDebug use LocalDevVPN, which takes the device's only VPN slot, so Tailscale can't run beside it. Apparition doesn't need that slot.

Step by step setup on GitHub

Mac, Windows or Linux

The desktop app runs on all three, and installing Apparition on your device, refreshing apps, launching with JIT and the companion work the same on each, with no Mac involved. A Mac is the most complete and most stable setup; Windows and Linux are fully supported, and we keep them working.

Mac: the most complete
Signing in needs nothing set up, and building your own apps (Xcode, live patching, the Develop tools) is only here. Move the app to Applications and clear the download quarantine once, since it isn't notarized.
Windows
Run Apparition Setup and choose Only me, or Everyone on this PC, which adds a background service that serves your devices with nobody signed in. Either way it lets your devices through Windows' firewall, so you aren't asked about it. SmartScreen may ask you to choose More info, then Run anyway. The zip is there too, to unzip anywhere. For an iPhone or iPad over USB, install Apple Devices (or iTunes) first; a Vision Pro or Apple TV pairs over Wi-Fi. To sign in with a free Apple ID with no Mac, choose Apparition's own (Android libraries), run your own anisette server with one Docker command (Docker Desktop, or Docker in WSL), give a third-party server's address, or pair with a Mac running Apparition. A paid account's certificate needs none of that. Windows on ARM works too.
Linux
Download the .deb (Debian, Ubuntu) or the AppImage for your CPU, x64 or ARM64. For an iPhone or iPad over USB, install and start usbmuxd. To sign in with a free Apple ID with no Mac, Apparition's own Android anisette needs nothing set up; or run your own server in Docker, give a third-party server's address, or pair with a Mac.
Can I develop my own apps without a Mac?

Building with Xcode and live patching need a Mac. xtool builds on Linux, and on Windows through WSL, and apparition deploy installs the result from the PC. A PC can also pair with a Mac, whose Xcode builds and whose agents debug your apps.

Signing in with a free Apple ID: we recommend your own Mac

Since October 2026, Apple gives free-account signing only to a sign-in that ends as a Mac's, and it checks the anisette, the data that identifies the computer, closely. We recommend taking it from a Mac you own, as Xcode does: no one can take it away, nothing about your sign-in goes to a third party, and it behaves as Apple's own tools do. It is a recommendation, not a requirement: on macOS, Windows and Linux, Apparition can also make its own Android anisette, which passed a full sign-in on 12 November 2026, and third-party servers still work.

A Mac on macOS 26 or earlier: the best
It needs no setup and no change to the Mac's security, and your other Apple devices get the usual sign-in push, with SMS offered too. Tested on an Intel MacBook on macOS 15.8, and confirmed on a stock macOS 26 guest. Intel Macs never get macOS 27, so an old Intel MacBook left awake makes a good always-on companion.
macOS 27: a small VM
On macOS 27, the Mac keeps its anisette to itself. On an Apple-silicon Mac, Apparition makes a small macOS 26 virtual machine for it: one button, no administrator password, no security cost to the Mac you use. The limit: a VM's sign-ins confirm by SMS only, with no push to your devices.
Apparition's own Android anisette
On macOS, Windows and Linux with no Mac at all, and nothing to install or run: Apparition fetches Apple Music's Android libraries from Apple on first use and runs them itself. Apple has turned this kind of anisette away before and let it back, so it can stop working. The companion can offer it to your devices too, which suits a Mac with 8 GB that has no room for the VM, or a Windows or Linux computer.
A third-party anisette server, or your own in Docker
Still works, on any computer with no Mac at all. To run your own, start the pinned anisette server container with Docker Desktop (or Docker in WSL on Windows) and give Apparition http://localhost:6970: the command is in the README, and it signs in with no Mac and no server from anyone else, with Apple's libraries kept out of Apparition's own process. Or give the address of any anisette v3 server in Settings and use Check server to see what it serves. We don't provide or recommend one, so you trust whoever runs it, and Apple decides what it accepts: a public Android-based server passed a full sign-in on 12 November 2026.
Works with any computer, or none

Installing, refreshing, launching with JIT and the companion run on macOS, Windows and Linux, with no Mac. For a free Apple ID's sign-in, any of them can use Apparition's own Android anisette, run its own anisette server in Docker, give a third-party server's address, or pair with a Mac running Apparition. On iPhone, iPad and Vision Pro, LocalDevVPN can stand in for the companion with no computer at all, though it takes the device's only VPN slot.

Questions

What do I need?

An Apple Vision Pro, iPhone, iPad or Apple TV, and a computer to install Apparition: a Mac, a Windows PC or a Linux machine. To sign apps you need an Apple ID (a spare free one is best) or your own developer certificate, and for a free Apple ID an anisette source: a Mac you own, Apparition's own Android anisette, your own server in Docker, or a third-party server. Building your own apps needs Xcode on a Mac.

What is DebugTrace, and do I have to use it?

It's a separate open-source Swift package, DebugTrace, that you link into an app you build. Apparition installs and refreshes any app without it. The live debugging, tuning and trace features need it.

Which apps work?

Apparition signs any IPA, and any .deb package that holds an app, such as Kodi's. Whether an app then runs depends on the app. We keep a list of the apps we've run ourselves (UTM, ARMSX2, Madeira, Kodi, Provenance and more), including the ones that need a caveat. If one you want fails, tell us.

What are the limits of a free Apple ID?

Apple allows 3 sideloaded apps per device, 10 App IDs per week and two certificates on a free account, and apps have to be re-signed every 7 days, which is why Apparition refreshes them. At the 3-app limit, Apparition shows what's installed and lets you remove one. A paid developer certificate lifts these limits.

Signing in fails with error -80045. What now?

Since 12 October 2026 Apple refuses sign-ins whose anisette doesn't match the device they claim to be, which broke most sideloaders. Apparition claims what its anisette really is, so it handles it. A sign-in from a computer Apple hasn't seen asks for a 2FA code: a push to your other devices when the anisette is a real Mac's, or SMS to your trusted number when it comes from a VM.

My Apple ID uses security keys. Can I still use it?

Not for signing. Create a separate free Apple ID for sideloading and sign in with that.

Will my apps refresh on their own?

Apparition asks the system for background time, but that isn't dependable. A daily Shortcuts automation is: pick a time you usually use the device, add Refresh Apps, and turn on Remember password. When a refresh can't run, the action says why.

macOS says Apparition can't be opened.

It isn't notarized by Apple, so macOS blocks it until you clear the download quarantine. Move Apparition to Applications, then run this in Terminal:

xattr -dr com.apple.quarantine /Applications/Apparition.app

Or open it once, then click Open Anyway in System Settings > Privacy & Security. Windows may show a SmartScreen warning for the same reason: choose More info, then Run anyway.

Download

Looking for the latest release…