Run a virtual iPhone on an Apple Silicon Mac.
Swift
/*
* libvcamcaptured — synthetic camera source injection in cameracaptured.
*
* Optional hook for `/usr/libexec/cameracaptured`. Building the guest
* component does not install or inject it; a process loader is required.
*
* Strategy (iOS 26.x):
* 1. AVF clients query `+[AVCaptureDevice devicesWithMediaType:]`.
* 2. That bottoms out at `FigCaptureSourceRemoteCopyCaptureSources(1)`
* which XPC-calls cameracaptured's
* `_captureSourceServer_handleCopySourcesMessage`.
* 3. The daemon iterates `_sSourceList` (CFMutableArrayRef in
* CMCapture's __DATA_DIRTY.__bss) under `_sSourceListLock` and
* serializes each via `_captureSourceServer_createSerializedSource`.
* 4. We build a synthetic source using Apple's own
* `FigCaptureSourceCreateFromBacking` — which produces a proper
* CMBaseObject with valid PAC-signed vtable — then append it to
* `_sSourceList` under the lock.
* 5. Post the Darwin notification subscribed-to by AVF clients so they
* drop their cached device list and re-query.
*
* Version portability:
* No hardcoded image VMAs. All CMCapture addresses are recovered at
* runtime via:
* - dlsym for exported functions (FigCaptureSourceServerStart,
* FigCaptureSourceCreateFromBacking, CMBaseObjectGetVTable).
* - getsectiondata to map CMCapture's __text bounds.
* - Structural xref pattern scan of __text to find the
* `_sSourceList` / `_sSourceListLock` slots:
* `adrp Xn, <page>; ldr Xm, [Xn, #<imm>]`
* where #imm matches the slot's per-page offset (compiler emits the
* same instruction pair from every xref site, so we expect multiple
* matches; we accept only when all matches agree).
*/
#include <stdarg.h>
#include "VCamCapturedPrivate.h"
// Each subsystem lives in its own folder and translation unit:
// Image/ CMCapture image resolution, structural scans, code patches
// Synthetic/ the synthetic source, device and stream classes
// Frames/ the shm frame reader and viewfinder / sink delivery
// Hooks/ observation and delivery hooks on the capture graph
// Prewarm/ the GPU prewarm skip for the paravirtual Metal driver
// Cross-file symbols are declared in each folder's header with hidden
// visibility, so none becomes a public dylib interface.
// MARK: - sentinel logging
void vcc_log(NSString *fmt, ...) {
va_list args;
va_start(args, fmt);
NSString *msg = [[NSString alloc] initWithFormat:fmt arguments:args];
va_end(args);
NSString *line = [NSString
stringWithFormat:@"%@ [vcamcaptured:%d:%@] %@\n",
[NSDate.date description],
getpid(),
NSProcessInfo.processInfo.processName ?: @"?",
msg];
NSData *data = [line dataUsingEncoding:NSUTF8StringEncoding];
if (!data.length) return;
int fd = open(VPHONE_VCAM_CAPTURE_LOG_PATH, O_WRONLY | O_CREAT | O_APPEND, 0644);
if (fd >= 0) {
(void)write(fd, data.bytes, data.length);
close(fd);
}
NSLog(@"vcamcaptured: %@", msg);
}
// MARK: - method swizzling
void vcc_swizzle_method(Class cls, SEL sel, IMP newImp, IMP *outOrig) {
Method m = class_getInstanceMethod(cls, sel);
if (!m) {
vcc_log(@" swizzle: -[%s %@] missing", class_getName(cls),
NSStringFromSelector(sel));
return;
}
*outOrig = method_setImplementation(m, newImp);
vcc_log(@" swizzled -[%s %@] (orig imp=%p)", class_getName(cls),
NSStringFromSelector(sel), *outOrig);
}
// MARK: - constructor
__attribute__((constructor)) static void vcc_init(void) {
@autoreleasepool {
vcc_log(@"loaded (argv0=%@)",
NSProcessInfo.processInfo.arguments.firstObject ?: @"?");
// Not delayed with the camera hooks below: the daemon asks for its
// capture sources as soon as a client connects.
vcc_install_microphone_source();
vcc_install_remix_session_skip();
// Schedule install after the daemon has run its own init. The delay
// gives FigCaptureSourceServerStart's `dispatch_once` block time to
// allocate _sSourceList before we try to mutate it.
dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(3 * NSEC_PER_SEC)),
dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{
@autoreleasepool {
vcc_install_synthetic();
vcc_start_frame_receiver();
vcc_install_endpoint_hook();
vcc_install_sink_observation();
vcc_install_still_sink_observation();
vcc_install_session_graph_observation();
vcc_install_still_coordinator_observation();
vcc_install_still_coord_node_observation();
vcc_install_still_pipeline_observation();
vcc_install_pipelines_addStill_observation();
vcc_install_parsed_cfg_observation();
vcc_install_csp_requires_master_clock_hook();
vcc_install_session_init_capture();
vcc_construct_still_sink();
// Probe: drive our manually-installed handler 15s
// after install. Gives time for vphoned to produce
// shm frames our reader can wrap into a CMSampleBuffer.
dispatch_after(dispatch_time(DISPATCH_TIME_NOW,
(int64_t)(15 * NSEC_PER_SEC)),
dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0),
^{ @autoreleasepool { vcc_drive_still_sink_once(); }});
vcc_install_viewfinder_hooks();
vcc_dump_sink_node_methods();
// Signature corrected against the observed type
// encoding @40@0:8@16i24B28^i32 (clientPID is int,
// err is int*). Hook is currently observe-only —
// calls orig and logs return + err, which lets us
// see what client/PID is asking for our device and
// confirm the -12780 nil-return path before we add
// synthesis logic.
vcc_install_device_vendor_hook();
vcc_install_copy_streams_hook();
vcc_install_copy_streams_from_hook();
}
});
// Not delayed: the daemon starts its shader preload at launch, and the
// call has to be gone before the precompilation queue reaches it.
vcc_install_gpu_prewarm_skip();
}
}