v0.1.0-preview.2LOCAL DISPLAY FABRIC

把每一块闲置屏幕,编入你的Mac 工作空间。

DisplayWeave 将 iPhone、iPad 和 Android 设备变成本地扩展显示器,支持 Apple USB/WiFi、Android ADB USB、自动 WiFi 回退、触摸、HEVC 与实验性高刷新。

macOS 14+iOS / iPadOS 17+Android 8+GPL-3.0
实时传输拓扑
已连接
SOURCE 00Mac 发送端采集 · 编码
USB 01Android 接收端ADB USB
LAN 02Apple 接收端本地 WiFi
自动回退USB ↔ WIFI

选择需要的发送端与接收端。

所有文件均由 GitHub 直接分发。安装前请先阅读签名边界。

01
发送端macOS

Mac 发送端预览版

通用 ad-hoc 签名应用,未使用 Developer ID 且未公证;可能需要手动允许 Gatekeeper。

DisplayWeave-Preview-0.1-macOS.zip
下载 macOS ZIP
02
接收端Android

离线签名 APK

无需 Google Play 即可安装,使用项目 Preview 密钥签名,并已通过 APK Signature Scheme v2 验证。

DisplayWeave-Preview-0.1-Android.apk
下载 Android APK
03
接收端输入包iOS / iPadOS

未签名自签输入包

不能直接安装;需使用你自己的 Apple 身份依法签名后才能安装到设备。

DisplayWeave-Preview-0.1-iOS-unsigned-resigning-input.ipa
下载自签输入包
v0.1.0-preview.2开发预览版——未通过 App Store、Google Play、Developer ID 公证或通用 iOS 签名分发。使用 SHA256SUMS.txt 验证全部下载

保留真实边界的版本状态板。

“已验证”表示在现有真机上完成;“实验性”表示已实现但性能依赖硬件;未完成工作会明确列出。

已验证

Android USB 与恢复

已验证有线 ADB forward 的 HEVC/120、H.264/60,以及拔插、ADB 重启、取消/恢复授权、回到前台和 Auto 回退恢复。

触摸与混合接收端

轻点、拖动、光标和双指滚动可回传 macOS;当前 iPhone WiFi 与 Android 可并发运行。

Android 离线分发

无需 Google 开发者账号,已验证 Release APK v2 签名、证书身份、首次安装和覆盖安装。

实验性

Android 高刷新

支持 30/60/90/120fps 协商、HEVC 与 H.264 回退;OnePlus WiFi HEVC/120 实测约 109–111 渲染 FPS,不保证稳定满 120 FPS。

可测量性能控制

已实现短时 CSV/JSONL benchmark、Target/Actual Bitrate 分离、Auto/Manual/Benchmark、自适应调节、低延迟队列与传输感知 GOP;同条件 USB/WiFi 矩阵仍待完成。

macOS 私有显示 API

Mac 发送端依赖 CGVirtualDisplay,未来 macOS 版本可能改变其私有行为。

待完成

剩余验证矩阵

双 Android 并发、同条件 USB/WiFi 受控 Benchmark,以及 30 分钟/2 小时耐久测试尚未完成。

Auto 跟随线缆,也不会把会话困住。

同一 install ID 锚定切换目标,因此无线调试端点不会伪装成第二台 USB 设备。

  1. 01

    发现有线 ADB

    只有包含有线 USB 元数据的设备行才具备资格。

  2. 02

    转发动态端口

    每个 serial 独享一个 Mac 本地 TCP 端口,映射到 Android :9000。

  3. 03

    有限恢复

    协议宽限加 0.5/1/2/4/8 秒退避,避免高速死循环。

  4. 04

    按 install ID 回退

    Auto 只回退到同一 Android 应用安装实例的 WiFi。

  5. 05

    重新升级 USB

    线缆恢复时先原子结束 WiFi,再建立有线连接。

像素向外传,输入向内回。

109–111渲染 FPS

OnePlus HEVC/120 WiFi 历史实测,属于单设备结果,不是承诺。

约 26 秒USB → WiFi 回退

从 socket reset 开始,经过协议宽限与完整有限恢复序列后的观察值。

1 + 1混合接收端

当前 iPhone 通过 WiFi、Android 通过独立会话同时运行。

双向本地交互

视频向设备发送,触摸、拖动、光标和双指滚动返回 macOS。

屏幕数据留在本地链路。

DisplayWeave 不要求账号或项目运营的云端中继,但这不代表所有传输都已达到生产安全级别。

01

仅限可信局域网

当前 WiFi 视频与控制 TCP 尚未生产级加密,请只在可信网络使用。

02

ADB 信任范围较广

Android USB 调试授权的是整台 Mac 调试主机,而不只是 DisplayWeave。

03

来源透明

DisplayWeave 是源自 OpenDisplay 的 GPL-3.0 软件,并保留 SideScreen 技术参考声明。

连接前需要了解的问题。

不通过 Google Play 能安装 Android APK 吗?

可以。为打开 APK 的来源允许安装未知应用,并在安装前核对 SHA-256 与项目证书指纹。

为什么 macOS 会显示安全警告?

Preview 使用 ad-hoc 签名且未公证,因为本次没有付费 Developer ID。请先检查源码和校验和,仅在信任产物时按文档允许 Gatekeeper。

IPA 可以直接安装吗?

不可以。它明确是未签名的自签输入包,用户必须提供自己的有效签名身份;第三方签名服务存在独立的安全和法律风险。

Android 回到桌面再进入会自动重连吗?

在已验证链路上可以。Surface 返回时接收端会幂等重启,Mac 会先重发 streamConfig,再请求关键帧。

Android USB 一定比 WiFi 快吗?

它可以避开局域网波动,但同条件受控 Benchmark 仍未执行。公开 Benchmark 文档规定了如何比较,不会编造数字。