How do I set up Remote for a Swift project in Xcode?

Add Remote as a Swift package, include the RemoteCapture target, and patch your app's main.m with the correct IP address. Also, run an application like InjectionIII with Remote Control enabled to receive connections.

Can Remote be used with iOS simulators or only physical devices?

It can load from a bundle on the fly in simulators, but it's primarily designed for physical iPhones to eliminate device handling. The main value is in remote control of real devices.

What does the tolerance mean in Remote's snapshot testing?

Tolerance is measured in bytes difference after run-length encoding of similar pixels. You can adjust it during macro replay to account for minor UI variations and avoid false failures.

What screen elements does Remote fail to capture?

Remote misses video replay, OpenGL layers, UIAlertView prompts, and UIDatePickers due to its use of UIWindow.layer renderInContext. Animations are also skipped to save network bandwidth.

Remote or Apple's UITesting framework: which is better for automation?

Remote is better for direct device control and macro recording within Xcode, ideal for physical testing without handling. UITesting is more integrated with XCTest and supports broader automation scenarios, but requires handling devices or simulators.

How to fix Remote not connecting after restarting Xcode?

Wait about a minute for Xcode to accept remote connections due to firewall complications. Ensure the hostname is correctly compiled into the Swift package and that both devices are on the same network.

Open-Awesome

Remote

MITObjective-C

An Xcode plugin and Swift package that lets you control an iPhone from your Mac for recording and replaying touch macros during development.

GitHub

886 stars50 forks0 contributors

What is Remote?

Remote is an Xcode plugin and Swift package that allows iOS developers to control an iPhone from their Mac during development. It enables recording and replaying touch interactions as macros, performing snapshot-based end-to-end testing, and capturing screen output as videos. The tool solves the problem of constantly picking up physical devices for testing by providing a remote control interface within Xcode.

Target Audience

iOS developers working in Xcode who need to test applications on physical iPhones without constant device handling. It's particularly useful for developers creating automated UI tests or requiring reproducible touch sequences.

Value Proposition

Developers choose Remote because it integrates directly with Xcode, eliminates physical device handling during testing, and provides macro recording with snapshot validation for reliable end-to-end testing. Unlike simulators, it works with actual devices while offering automation capabilities typically requiring additional testing frameworks.

Overview

Control your iPhone from inside Xcode for end-to-end testing.

Use Cases

Best For

Recording and replaying touch sequences for consistent UI testing
Performing snapshot-based end-to-end testing on physical iPhones
Automating repetitive device interactions during iOS development
Capturing screen recordings of device sessions for debugging
Testing applications on real devices without physical handling
Creating editable macros for complex touch interaction scenarios

Not Ideal For

Testing apps with heavy video playback or OpenGL content, as Remote cannot capture these layers
Projects requiring immediate testing after Xcode restarts, due to connectivity delays of up to a minute
UI testing that relies on UIAlertView prompts or UIDatePickers, which are not rendered correctly
Teams preferring simulators over physical devices, since Remote is optimized for real iPhone control

Pros & Cons

Pros

Macro Automation

Record and replay touch sequences as editable macros in a WebView, enabling consistent and reproducible testing without physical device handling.

Snapshot Validation

Compare screen output against saved snapshots during macro replay with configurable tolerance, providing reliable end-to-end UI testing.

Remote Device Control

Interact with an iPhone through a Mac window in Xcode, eliminating the need to physically handle the device during development.

Video Recording

Capture all display output into QuickTime movies directly from the tool, useful for debugging or documentation.

Cons

Complex Setup

Requires patching main.m, adding Swift packages, and managing network connections, which can be error-prone and time-consuming compared to simpler tools.

Rendering Limitations

Cannot capture video replay, OpenGL layers, UIAlertView prompts, or UIDatePickers correctly, limiting its effectiveness for certain UI elements.

Connectivity Delays

Takes about a minute after Xcode restart for remote connections to establish due to firewall issues, disrupting immediate testing workflows.

Frequently Asked Questions

Related Projects

Kif

Keep It Functional - An iOS Functional Testing Framework

Stars6,248

Forks919

Last commit8 days ago

EarlGrey

:tea: iOS UI Automation Test Framework

Bluepill is a reliable iOS testing tool that runs UI tests using multiple simulators on a single machine

Stars3,208

Forks228

Last commit2 years ago

ViewInspector

Runtime introspection and unit testing of SwiftUI views

Stars2,628

Forks193