minimuxer is the lockdown muxer library used by SideStore. It manages device communication, app installation/sideloading, Developer Disk Image (DDI) mounting, AFC file system operations, and pairing over local loopback VPN or remote endpoints.
βββ Common/ β MinimuxerCommon package
β βββ FFIDispatcher.swift β Serial GCD dispatch queue utility for FFI calls
β βββ MinimuxerConstants.swift β Constants & default configurations
β βββ NetworkUtils.swift β TCP socket probing & device reachability checks
βββ DeviceGateway/ β DeviceGateway package (libimobiledevice / idevice)
β βββ DeviceGatewayAPI.swift β Gateway protocol definitions
β βββ idevice/ β Idevice backend implementation
β βββ libimobiledevice/ β Libimobiledevice backend implementation
βββ Sources/ β Main Minimuxer package
βββ MinimuxerApi.swift β Public API contracts & Minimuxer composition root
βββ MinimuxerImpl.swift β Core Minimuxer API implementation
βββ EMProxyImpl.swift β EMProxy wrapper implementation
βββ MinimuxerError.swift β Public error definitions
βββ Services/
β βββ DeviceConnectionManager.swift β Route discovery & connection reachability
β βββ DeviceEndpoint.swift β Active target device IP state
β βββ HeartbeatService.swift β Heartbeat keep-alive service
β βββ Mounter.swift β Developer Disk Image (DDI) mounter
β βββ NetworkIfaceScanner.swiftβ Network interface scanner
β βββ NetworkObserverService.swift β Network path monitoring (NWPathMonitor) & endpoint lifecycle
β βββ UsbmuxdProxyServer.swift β Usbmuxd proxy server listener over TCP
β βββ WirelessPairService.swiftβ Wireless pairing service & PIN verification
βββ Types/
βββ RawPacket.swift β Low-level packet parsing
- DeviceGateway: Pluggable device gateway backend (
libimobiledeviceandideviceC/FFI bindings). - EMProxy: Pre-built
EMProxy.xcframeworkfor WireGuard loopback server and handshake handling. - ZIPFoundation: Used for extracting DDI disk images and IPA application bundles.
Minimuxer.shared(backend:): Memoized singleton factory returning an instance with:.core: Primary API for app installation, uninstallation, DDI mounting, profile management, and AFC file operations..network: Handles network path monitoring, interface scanning, and endpoint attachment/detachment..wirelessPair: Manages wireless pairing flow and PIN verification (iOS 27+)..emproxy: Controls EMProxy WireGuard loopback server and handshake client..gateway: Active device gateway backend (libimobiledeviceoridevice).
.localVPN: On-device loopback VPN connection. Uses user-configured override peer IP when present; auto-discoversutun*interface peer IP only when no override is configured..remoteServer: Remote server endpoint configuration over LAN, Wi-Fi, or external VPN.
minimuxer is integrated as a standard Swift Package (Package.swift).
swift build- Baseline Rust implementation from minimuxer by @jkcoxson
- RPPairing initial Rust implementation end-to-end support added in minimuxer by @hugeblack backed by Remote Pairing(RPPairing) implementation in
idevice - Swift complete rewrite by @mahee96
- VPN auto-discovery initial research by @nythepegasus
- Enhanced research for end-to-end VPN auto-discovery and probing implementation by @mahee96
- Port from
rustylibimobiledevicebridge toidevicebridge by @mahee96 - Alternative device-gateway (
libimobiledevicegateway) bridge implementation backed bylibimobiledeviceby @mahee96 - Alternative RPPairing ground-up implementation in C++ (based on spec from jkcoxson's rppairing-spec) called RemotePairingKit by @mahee96
This project is licensed under the terms of the GNU Affero General Public License v3.0 (AGPL-3.0).