v0.3.3LOCAL DISPLAY FABRIC

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

DisplayWeave 将 iPhone、iPad 和 Android 设备变成本地扩展显示器,支持 Apple USB/WiFi、Android ADB USB、已验证的 Mac/Android 更新渠道、触摸、HEVC 与实验性高刷新。

macOS 14+iOS / iPadOS 17+Android 8+GPL-3.0
连接方式示意
示意图
SOURCE 00Mac 发送端采集 · 编码
USB 01Android 接收端ADB USB
LAN 02Apple 接收端本地 WiFi
自动回退USB ↔ WIFI

下载正式版。

Mac 桌面自动匹配根据可用显示器数据估算尺寸,并保留已有设置。目前不支持原生 5K 视频,双 Mac 实机验收尚未完成;Android 与 macOS 在安装更新前校验下载。

01
发送/接收macOS

带引导的 Mac 首次安装

把 DisplayWeave 拖入“应用程序”,后续版本使用 EdDSA 认证的 Sparkle 更新。使用固定 Apple Development 签名,未公证;首次从临时签名版升级可能需要重新授权。

DisplayWeave-macOS.dmg
下载 macOS DMG
02
接收端Android

已验证的应用内更新

首次覆盖安装到现有应用;后续下载会校验大小、哈希、包名、版本、SDK 和固定签名证书,再由系统确认。

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

未签名自签输入包

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

DisplayWeave-iOS-unsigned-resigning-input.ipa
下载自签输入包
v0.3.3DisplayWeave 使用邀请配对;OpenDisplay 可从主界面选择兼容连接。Mac 使用固定 Apple Development 签名且未公证;iOS 需自行签名。使用 SHA256SUMS.txt 验证全部下载下载对应源码(GPL-3.0)

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

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

已验证

Android USB 与恢复

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

触摸与混合接收端

Preview 2 既有证据覆盖轻点、拖动、光标、双指滚动,以及 iPhone WiFi 与一台 Android 并发;本版本未重新执行该实机矩阵。

Android 离线分发

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

更新与 iPhone 显示链路

Mac EdDSA 与 Android 包/证书校验会拒绝被篡改的更新;Metal drawable 同步修复已报告的 iPhone 黑屏链路,接收协议保持不变。

实验性

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混合接收端

Preview 2 既有证据:iPhone 通过 WiFi、Android 通过独立会话同时运行。

双向本地交互

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

屏幕数据留在本地链路。

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

01

加密配对

Apple 与 Android 默认使用固定证书指纹的双向 TLS。新版通过接收邀请配对,OpenDisplay 可选择主界面兼容入口;旧版连接不加密,仅限可信网络。

02

ADB 信任范围较广

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

03

来源透明

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

连接前需要了解的问题。

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

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

后续 Mac 和 Android 版本还要重新安装吗?

Mac 使用签名验证的 Sparkle 更新;Android 可在“设置与帮助”检查,并需系统安装确认。元数据在 GitHub Pages,安装包在 GitHub Releases。尚无此更新渠道的旧版本需手动安装一次。

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

本版本使用 Apple Development 签名保持升级身份一致,尚未使用 Developer ID 签名或公证,因此 macOS 仍可能要求确认。请核对校验和,并按首次安装说明操作。

IPA 可以直接安装吗?

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

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

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

Android USB 一定比 WiFi 快吗?

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