Repository navigation
Releases
XDeviceBridge 1.6.1
XDeviceBridge 1.6.1
- Add
xdb_client_connect_cancellablewith a thread-safe cancellation callback. - Cover startup-lock waiting, automatic server startup/retries, loopback connection and hello handshake with one 15-second budget.
- Join cancellation watchdogs before return so callback userdata can be released safely.
- Document the API and test stalled hello, startup retries, concurrent startup-lock cancellation and callback lifetime.
Based on 1.6.0. Existing connect behavior, C ABI 1, RPC protocol 1 and pairing records remain compatible.
XDeviceBridge 1.6.0
- Add
video.start.max_bitrateto request a device video bitrate ceiling in bit/s,
with no device-specific clamp. Report the request and negotiatedTXMaxBitrate.
Shared video preserves the first producer's setting and warns on differing requests. - Add
video.start.max_fpsto limit receiver BGRA conversion and publication.
Continue reference decoding and encoded recording unchanged. Shared groups use
the highest requested rate, with unlimited taking precedence. - Advertise both capabilities through
server.info. C ABI 1, RPC protocol 1 and
pairing records remain unchanged. Default decode behavior remains unchanged.
XDeviceBridge 1.5.1
Fix Windows SDK header compatibility when compiling the native DNS-SD backend from source. The backend now includes the user-mode IP Helper header instead of including netioapi.h directly.
The fix passed xdb's cross-platform CI and the InblessBuild consumer build. Runtime behavior, C ABI 1, RPC protocol 1 and pairing records are unchanged.
Desktop runtime archives and matching dependency source archives are provided below. The macOS ZIP is Developer ID signed and notarized by Apple.
XDeviceBridge 1.5.0
XDeviceBridge 1.5.0 adds command-line device selection, wait commands and mDNS diagnostics.
- Add
xdb version/--version,xdb help,XDB_SERIAL, and adb-style-d/-eselectors. - Add
get-stateandget-serialnofor scripts. Device states retain xdb'sdiscovered,pairedandconnectedmeanings. - Add cancellable
wait-for-device, including direct-IP probing with a UDID, optional deadlines, timeout exit 124 and cancellation exit 130. - Add
mdns checkandmdns servicesto inspect the discovery backend and service endpoints without opening a device session. - Distinguish missing pairing, explicit authorization rejection and locked devices, preserving network/transport failure details and showing the appropriate next step.
- Fix CLI compilation with older Apple libc++ by applying the existing threading compatibility options.
C ABI 1 and local RPC protocol 1 remain unchanged. Existing pairing records are retained.
Runtime archives and corresponding source materials are included. The macOS ZIP is Developer ID signed and Apple notarized; SHA256 checksum files accompany each platform's archives.
XDeviceBridge 1.4.0
XDeviceBridge 1.4.0
- Add up to five simultaneous touch contacts via
input.touch.contact(0–4).
Omittingcontactretains single-contact behavior. Each report preserves the
other held contacts; individual release affects only the selected contact. - Preserve shared-mirror gesture ownership until every contact is lifted.
- Fix final-session teardown discarding queued input releases. Cleanup waits for
a bounded TCP acknowledgement without adding this wait to ordinary input RPCs.
C ABI 1, RPC protocol 1 and stored pairing records remain compatible.
Validated over Wi-Fi on iPhone14,4 / iOS 27.0.1: two/five contacts, individual
release, disconnect cleanup, shared control ownership, MaaFramework MultiSwipe,
desktop scrctl's three scrcpy-style mouse gestures and Android MirrorView input.
Desktop/Android input events were injected through their real UI handlers;
physical five-finger touchscreen hardware was not part of this acceptance.
XDeviceBridge 1.3.0
-
Wake the request disconnect monitor immediately when an RPC completes, removing
an avoidable polling wait of up to 50 ms before replies. Preserve bounded EOF
detection and cancellation without changing the wire protocol or client API. -
Add capability-negotiated
access: "shared"control groups. Independent mirrors
share one video producer, retain separate attachment/input lifetimes and reject
conflicting media options. Legacy control access remains exclusive. Audio has
one consuming group; recording remains exclusive. -
Add
connection.openwithaccess: "read"for screenshots and read-only
queries alongside an existing controller. Scope attachments to their access,
preserve media when readers close, and stop media/release held inputs when the
last control attachment closes. Readers can retain the device for screenshots;
a later controller can acquire it with a fresh capability. -
The screenshot CLI negotiates read access when Server advertises
capabilities.read_only_sessions; older Servers retain their existing behavior.
C ABI 1 and local RPC protocol 1 remain compatible. Existing pairing records are preserved. Restart the Server after upgrading; updating only a client library does not apply the RPC latency fix. Shared control requires client capability negotiation; legacy clients keep exclusive control.
macOS binaries are signed and notarized. Runtime archives, matching source materials and SHA256 manifests are attached.
v1.2.0
What's new
- Manual Wi-Fi connections:
xdb [-s UDID] connect HOST[:PORT]authenticates a known endpoint without multicast discovery. Server retains the base connection after CLI, capture and media sessions exit.xdb disconnect [HOST[:PORT]]closes matching manual connections and invalidates their sessions, preserving pairing records and DDI. There is no automatic reconnect; independent control sessions remain exclusive per device. - Pairing display brands:
xdb pair --display-brand NAMEandpair.display_brandlet applications use their own host name/model prefix. The default remainsxdb; device identities, display serials, keys and stored pairing records are preserved. - Device listing: merge connected endpoints with discovered devices by UDID, including manual connections with no multicast advertisement. Remove the redundant
connection:text label while preserving JSON compatibility. - Compatibility: C ABI 1 and RPC protocol 1 remain unchanged. New commands check Server capabilities and explain when an older background Server needs upgrading.
Upgrade
Restart an existing Server after installing the new version:
xdb kill-server
xdb devices -lThe next client starts the upgraded Server. Existing pairing records are retained. Manual connections are not restored after Server restart.
The macOS ARM64 delivery is Developer ID signed and notarized. Linux x86_64 and Windows AMD64 runtime archives, corresponding source materials, and SHA256 checksum files are attached.
See installation, API reference, and 中文说明.
v1.1.0
- Keep desktop native discovery subscriptions for the Server lifetime. Warm
device listings and automatic Wi-Fi connection discovery reuse an updated
snapshot instead of waiting a fresh scan window. Follow native removals, reclaim
retired queries, and clear failed providers before request-driven recovery. - Finish idle image-mounter sessions with a bounded, cancellable
Hangupbefore
closing or reconnecting. This prevents repeated Wi-Fi DDI queries from waiting
about 30 seconds on affected devices; incomplete uploads and failed transports
close directly without sending plist commands into raw image data. - Add
xdb ddi statusandxdb ddi remove, with USB/Wi-Fi selection and JSON
output. Query mount and Cryptex installation state independently; reverse device
preparation by uninstalling the reported DDI Cryptex or unmounting the image.
Verify absence and preserve pairing records, host caches and unrelated Cryptexes. - Use system Bonjour for macOS device discovery and temporary Wi-Fi pairing
advertisements, with direct mDNS as a startup fallback. Keep existing pairing
records, advertisement identity, discovery budgets and SDK contracts. - Add an optional Linux Avahi backend with runtime library loading and direct
mDNS fallback. Preserve pairing records and avoid adding Avahi dependencies to
lightweight clients. - Use optional Windows system DNS-SD for device discovery, preserving
interface-scoped addresses and asynchronous cancellation with direct mDNS as a
startup fallback. Keep direct mDNS for complete pairing-host advertisements. - Add an Android API 34+
NsdManageradapter for App-owned discovery subscriptions,
resolved service updates and loss notifications. Multiple embedded runtimes can
share a subscription through lifecycle leases; older Android versions retain
direct mDNS discovery. The host App still owns permissions and lifecycle. - Synchronize the English and Chinese DDI RPC references and check both languages
for complete method coverage.
C ABI 1, local RPC protocol 1 and existing pairing records remain compatible.
Restart an already running Server to use the new discovery and DDI behavior;
updating only a client library does not upgrade the Server. Older servers do not
provide the new ddi.status and ddi.remove methods. See the
validation record for tested devices and remaining boundaries.
Full Changelog: v1.0.1...v1.1.0
v1.0.1
v1.0.0
Full Changelog: https://github.com/scrctl/XDeviceBridge/commits/v1.0.0