CamBridge: Giving the iOS Simulator a Real, Moving Camera Image
An open-source tool streamlines camera feature testing in the iOS Simulator by streaming live webcam feeds over localhost without needing physical devices.
Stock photo for illustration only, not from the actual event
- CamBridge is an open-source tool designed to feed real camera feeds into the iOS Simulator.
- It consists of a Mac menu bar app and a Swift package for Xcode projects.
- Streams length-prefixed JPEG frames over a TCP socket on localhost using a simple wire protocol.
- Supports Combine integration and has plans to support the Android Emulator in the future.
Building iOS applications that interact with AVCaptureSession—such as QR code scanners, document capture workflows, or AR features—historically forces developers into tedious workarounds. Neither the iOS Simulator nor the Android Emulator features real camera hardware, slowing down rapid iteration loops.
To tackle this challenge, CamBridge introduces a small, open-source utility divided into two main components designed to feed live video frames directly from a computer webcam into a running simulator.
The two main parts of CamBridge include:
- CamBridgeMenuBar: A Mac menu bar application that captures the built-in webcam and streams it over localhost as length-prefixed JPEG frames without requiring terminal commands or build steps.
- CamBridgeKit: A Swift package integrated into Xcode projects that provides CamBridgeCaptureSession, a drop-in replacement for AVCaptureSession.
This design ensures that view code does not require simulator-specific branching conditions. Furthermore, developers who already maintain a custom camera pipeline can utilize CamBridgeClient to publish decoded CGImage frames directly via Combine, avoiding strict coupling to the CamBridgeCaptureSession API.
Stock photo for illustration only, not from the actual event
Tools like CamBridge play a vital role in modern mobile software engineering. Simulating live camera input locally helps bridge the gap between desktop development and hardware-dependent features, drastically cutting down the friction of testing visual pipelines and user interfaces without deploying to physical iPhones constantly.
Under the hood, the wire protocol is documented inside the repository under Docs/PROTOCOL.md. It relies on a simple TCP socket mechanism tuned intentionally for smooth localhost performance rather than pristine image fidelity, keeping it optimized strictly as a developer utility.
Released under the MIT license, iOS Simulator support is fully operational, while Android Emulator compatibility remains on the roadmap since the underlying server already permits multiple concurrent clients. Feedback, issues, and pull requests are welcomed by the creator.
Source: Dev.to
Found something wrong in this article? Report an issue with this article
Comments
Leave a Comment