Skip to content

Releases

XDeviceBridge 1.6.1

Choose a tag to compare

@YJBeetle YJBeetle released this 06 Nov 08:22

XDeviceBridge 1.6.1

  • Add xdb_client_connect_cancellable with 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

Choose a tag to compare

@github-actions github-actions released this 30 Oct 12:54
  • Add video.start.max_bitrate to request a device video bitrate ceiling in bit/s,
    with no device-specific clamp. Report the request and negotiated TXMaxBitrate.
    Shared video preserves the first producer's setting and warns on differing requests.
  • Add video.start.max_fps to 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

Choose a tag to compare

@github-actions github-actions released this 29 Oct 22:06

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

Choose a tag to compare

@github-actions github-actions released this 29 Oct 18:40

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 / -e selectors.
  • Add get-state and get-serialno for scripts. Device states retain xdb's discovered, paired and connected meanings.
  • Add cancellable wait-for-device, including direct-IP probing with a UDID, optional deadlines, timeout exit 124 and cancellation exit 130.
  • Add mdns check and mdns services to 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

Choose a tag to compare

@github-actions github-actions released this 29 Oct 13:18

XDeviceBridge 1.4.0

  • Add up to five simultaneous touch contacts via input.touch.contact (0–4).
    Omitting contact retains 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

Choose a tag to compare

@YJBeetle YJBeetle released this 28 Oct 15:10
  • 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.open with access: "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

Choose a tag to compare

@github-actions github-actions released this 28 Oct 07:23

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 NAME and pair.display_brand let applications use their own host name/model prefix. The default remains xdb; 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 -l

The 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

Choose a tag to compare

@github-actions github-actions released this 27 Oct 10:44
  • 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 Hangup before
    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 status and xdb 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+ NsdManager adapter 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

Choose a tag to compare

@github-actions github-actions released this 26 Oct 05:50

Full Changelog: v1.0.0...v1.0.1

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 24 Oct 17:49