A command-line tool for iOS over-the-air (OTA) app distribution via Apple's itms-services:// protocol.

Given a .ipa file and a public HTTPS base URL, itms-services generates a manifest.plist and an index.html install page (with QR code), and optionally starts an HTTP file server — all in one command.

# Coming soon — track https://github.com/xykong/itms-services/releases

go install github.com/xykong/itms-services@latest

Download the latest binary for your platform from the Releases page.

itms-services build MyApp.ipa \
  --host-url        https://example.com/install \
  --display-image   https://example.com/assets/icon.png \
  --output          ./output

Produces ./output/manifest.plist and ./output/index.html.
Point your web server at ./output/ and send users the index.html URL.

itms-services serve MyApp.ipa \
  --host-url      https://example.com \
  --display-image https://example.com/icon.png \
  --port          8080

This copies MyApp.ipa into ./output/, generates the manifest and page, then starts an HTTP server on :8080.

Note: Apple requires itms-services:// to fetch the manifest over HTTPS. For local testing use ngrok or Caddy as a TLS reverse proxy in front of the built-in server.

itms-services build MyApp.ipa …
        │
        ├─ reads Info.plist from MyApp.ipa (bundle ID, version, display name)
        ├─ renders manifest.plist  ──► served at <host-url>/manifest.plist
        └─ renders index.html      ──► served at <host-url>/index.html
                  │
                  └─ install button href:
                     itms-services://?action=download-manifest&url=<host-url>/manifest.plist

Apache 2.0 — see LICENSE.