RemoteCompanion: Scriptable System Control for Rootless Jailbreaks

If you've ever tinkered with a jailbroken iOS device, you know the power it unlocks. But with the rise of rootless jailbreaks, some of the old ways of automating and controlling the system from a computer became a bit more complicated. That's where RemoteCompanion comes in. It's a tool that bridges that gap, giving you a clean, scriptable way to control a rootless-jailbroken device from your desktop, no convoluted SSH port forwarding required.

Think of it as a dedicated remote control for your jailbroken iPhone or iPad, built for the modern era of iOS hacking. It solves a real, practical problem for developers and power users who want to automate tasks or build tools that interact with the system.

What It Does

RemoteCompanion is a client-server application. You run a small server (a "tweak") on your jailbroken iOS device. This server listens for commands. On your computer (macOS, Linux, Windows), you run the client. The client can then send a variety of commands to the device over your local network.

These commands let you perform actions like rebooting the device, respringing the SpringBoard, launching apps, simulating touch events, and even triggering Activator events. The key is that it provides a structured, programmatic way to do all this from your computer's terminal or your own scripts.

Why It's Cool

The clever part is in its design for the rootless environment. Instead of fighting the new sandboxing constraints, RemoteCompanion works within them. It uses the PosixSpawn API for process control and leverages standard iOS frameworks in a way that's compatible with rootless jailbreaks like Dopamine or palera1n-rootless.

For developers, the real win is the scriptability. You can now write a Python script on your laptop that, for example, launches a beta app on your tethered test device, simulates a series of taps to navigate to a specific screen, and then resprings—all automatically. It turns your device into a more integrated part of your development and testing workflow. It's also just a solid, focused tool that does one thing and does it well, without unnecessary bloat.

How to Try It

Getting started is straightforward. You'll need a device with a rootless jailbreak already installed.

1. On your iOS device: Add the repository https://saihgupr.github.io/repo to your package manager (like Sileo or Zebra). Search for and install the "RemoteCompanion" package. This installs the server tweak.
2. On your computer: Head to the RemoteCompanion GitHub repository. Download the latest release of the client binary for your operating system (macOS, Linux, or Windows) from the Releases page.
3. Connect: Make sure your computer and iOS device are on the same Wi-Fi network. Run the client on your computer with the -h flag to see all available commands. The basic syntax to, for example, respring your device would be:

   ./remotecompanion -a YOUR_DEVICE_IP -p 2222 -c respring
   

   (You'll find your device's IP in the Wi-Fi settings).

Check the project's README for the full list of commands and more detailed setup instructions.

Final Thoughts

RemoteCompanion feels like a necessary utility that the rootless jailbreak community was missing. It's not trying to be a flashy all-in-one suite; it's a precise tool that solves the problem of remote control and automation effectively. If you're building tweaks, testing apps, or just like to automate your device interactions from your desktop, this is a project worth adding to your toolkit. It simplifies a process that was previously a bit of a hassle, and that's always a win.

Follow us for more projects like this: @githubprojects