Skip to content

iCTRL 1.98.15

Choose a tag to compare

@wsvn53 wsvn53 released this 26 Oct 12:47
· 10 commits to main since this release
cd6ce82

An AI-friendly iOS/iPadOS automation service. Tell your agent "My iPhone is running iCTRL at :8200 — figure out how to drive it." and it reads the on-device manual and takes it from there. Works with any agent that can make HTTP requests: OpenClaw, Hermes, Minis, Claude Code, Codex and others.

Downloads

Which IPA do I need?

File Needed? What it is
iCTRLUITests-Runner.ipa Required The automation engine. It serves the JSON-RPC API that agents and clients call, and must be running.
iCTRL.ipa Optional A companion app for tasks on the phone itself:
• mount the Developer Disk Image without a Mac, and remount it after a reboot
• start and stop the runner
• choose who can reach the runner (this device only / LAN / LAN + nearby)
• see and revoke authorized clients
• read the runner's log live

Skip iCTRL.ipa if you mount the Developer Disk Image with Xcode or StikDebug, and manage the runner from its notification or a computer. With a free Apple ID you get three sideloaded apps, and SideStore uses one of them. Install StikDebug or the iCTRL app alongside the runner, not both.

Both IPAs are unsigned for distribution (ad-hoc, no provisioning profile). Sign them when you install:

  • Free Apple ID: the latest SideStore signs and installs them. Older SideStore releases skip the nested .xctest, and the runner then crashes on launch.
  • Paid account: Scripts/sign-ipa.sh -i iCTRLUITests-Runner.ipa

The runner also needs the Developer Disk Image mounted (Xcode, StikDebug or the iCTRL app). The README covers the whole setup.

What's new since 1.98.12

Streaming

  • Less heat while the screen is still. The video stream skips frames identical to the last one and slows capture while nothing changes. It sends a periodic heartbeat, and a keyframe whenever a viewer joins.
  • No more black stream after the runner goes to the background. The encoder is rebuilt when iOS invalidates it.

Remote page

  • Settings survive reloads. FPS, quality and verbose are kept in the browser.

Typing

  • Custom input fields that drop focus. Some fields, such as chat input bars, lose focus as soon as type sends key events. type now detects this, refocuses the field and taps the on-screen keyboard keys instead (via:"keyboard"; Chinese is entered through pinyin candidates). It never presses Send. Pass via:"keyboard" to use this path directly.
  • type reports failures. If the text can't be entered, type returns an error instead of success.
  • keyboard.visible detects third-party keyboards such as Gboard.

Security and pairing

  • More methods need authorization. Every method that reveals or changes device state now needs the device itself or a key.
  • The iCTRL app imports RemotePairing files, such as StikDebug's pairingFile.plist.