PadBridge v0.3.4

PadBridge 0.3.4

Windows 画面设置只保留一个“目标帧率”：用户设多少，就按多少发送。

• 可选 15～120 FPS，默认 60。设置 120 后，即使 OpenDisplay 声明 60 FPS，仍使用 120
  的采集节奏、编码时间基准和视频配置，不自动改成 60。
• 移除额外的帧率开关、实验性文案和模式标签；已有 120 FPS 设置在升级后继续生效。
• 自建副屏同步选择 60/90/120 Hz，镜像保持电脑主屏刷新率。接收端尺寸与像素吞吐限制
  仍通过视频缩放处理，不降低用户选定的目标帧率。
• 状态卡显示目标与实际发送 FPS。实际吞吐受电脑性能、连接状况影响，屏幕物理刷新率
  由 iPad 决定。
• 包含 0.3.3 的普通权限保存修复：新配置继承个人 AppData 权限；旧版管理员创建的配置
  只需一次权限修复，日常启动和修改设置不必使用管理员权限。
• Windows 安装器继续一次配置主程序、USB 与扩展组件，升级保留个人设置。

命令行示例：

PadBridge.exe start --transport usb --display-mode extend --monitor auto --fps 120

Windows 安装包为 padbridge-0.3.4-windows-x64-setup.exe。
Ubuntu 图形界面及其接收端协商行为保持不变。

PadBridge v0.3.3

PadBridge 0.3.3

修复 Windows 普通启动时修改画面设置的权限错误，增加最高 120 FPS 和强制目标帧率。

Windows 设置权限

• 旧版以管理员启动时，Python 的 mkdir(mode=0700) 会创建仅目录所有者、管理员和
  SYSTEM 可写的目录；所有者可能是 Administrators，导致同一个账户普通启动后无法保存。
• 新目录继承个人 AppData 权限；旧目录只给原登录用户补充访问权限，不清空连接或画面设置。
  旧配置无法访问时，启动会请求一次 Windows 管理员确认。日常运行不要求管理员权限。
• “安装扩展组件”只提升短时维护进程，界面和串流进程保持普通权限。

120 FPS

• Windows 画面设置支持 15～120 FPS，默认仍为 60。USB 与 Wi-Fi 共用此设置。
• 默认遵守接收端声明。勾选“强制目标帧率”后，即使 OpenDisplay 上报 60，也会按所选
  120 FPS 配置采集节奏、编码器时间基准与协议；尺寸和解码像素吞吐限制仍然保留。
• 自建虚拟副屏提供横竖屏的 60/90/120 Hz 模式。根据实际发送目标选择刷新率，不修改
  电脑主屏或用户已经启用的副屏。更新旧配置时保留自定义尺寸、GPU 与其他选项。
• 状态卡显示实际发送 FPS；强制模式同时显示接收端声明，避免把发送帧率当作物理显示帧率。
• 命令行示例：PadBridge.exe start --transport usb --display-mode extend --monitor auto --fps 120 --force-fps。

120 是发送目标，不保证所有设备、分辨率和网络下恒定达到。屏幕实际刷新率由 iPad 决定。
Ubuntu 图形界面的范围保持 15～60 FPS，强制模式仅用于 Windows。

验证

• Windows 单元、协议和界面测试，覆盖普通权限设置迁移、120 FPS 协商与强制发送、编码解码、
  副屏刷新率及原布局保留。
• 实机使用普通用户令牌保存 120 FPS 设置；通过 WGC + NVENC 测试原生副屏 120 Hz、
  断线重连和副屏回收。
• 当前测试 iPad 上报 60 FPS，USB 强制模式已收到超过 60 的接收统计；这不代表屏幕物理
  刷新率为 120 Hz，也不承诺 Wi-Fi 稳定 120 FPS。

下载 Windows 用户安装包 padbridge-0.3.3-windows-x64-setup.exe 即可升级，沿用已有设置。

PadBridge v0.3.2

PadBridge 0.3.2

Windows 安装器现在一次完成主程序、USB 通信组件和扩展屏幕组件的配置。
新用户只需下载并运行一个 EXE，安装完成后可直接选择 USB / Wi-Fi、镜像 / 扩展。
iPad 仍需打开 OpenDisplay；首次 USB 连接需在 iPad 上信任电脑。

下载

文件	用途
padbridge-0.3.2-windows-x64-setup.exe	Windows 11 x64 完整安装，推荐
padbridge-0.3.2-windows-x64.zip	便携版，适合已经配置组件的电脑
padbridge_0.3.2_amd64.deb	Ubuntu 24.04 amd64 / Xorg 安装
padbridge-0.3.2-source.tar.gz	对应标签的完整项目源码
SHA256SUMS、SHA256SUMS-windows	下载校验值

一次安装

• 自动检测 Apple USB 服务与程序拥有的虚拟显示驱动；已有可用组件直接复用。
• 缺少 USB 支持时，向导自动从 Apple 官方服务器获取 Apple Mobile Device Support
  19.4.0.10 x64（约 39 MB），验证 SHA-256 和 Apple 发布者签名后安装。不要求用户安装
  iTunes、Apple Devices、Python、包管理器或另外运行命令。
• Virtual Display Driver 25.7.23 的签名驱动已内置，保留 MIT 许可证，安装时再次验证签名。
• 首次安装缺失系统组件需要联网及管理员确认，Windows 也可能要求确认驱动发布者。
  Apple 的原始许可条款与 PadBridge 许可一起显示在安装向导中。
• 组件准备失败时停在安装页，显示错误并允许重试；不会把未完成的 USB / 扩展配置报告为成功。
  需要重启时由安装器提示，不强制重启电脑。
• 升级沿用用户安装目录和设置。系统组件供多个程序共用，卸载主程序不会移除它们。
• 保留其他软件的虚拟显示配置，遇到无法确认所有权的同类驱动时报告冲突。

仓库与包整理

• 移除两份过时 Linux 交接文档和四个未使用的上游界面 / 入口模块；仍可从 Git 历史查阅。
• Windows 包把完整对应源码集中为 source.zip，仅收集 Git 跟踪文件，避免打入本机临时文件。
• 安装目录仅附 Windows 指南、当前发布说明与许可证；完整开发文档、构建脚本、两端代码和测试
  仍在源码包内。Ubuntu 运行功能保持 v0.3.1 的行为。

安装器本身尚未做 Authenticode 代码签名；内置显示驱动和下载的 Apple 组件各自有独立签名。

PadBridge v0.3.1

PadBridge 0.3.1

Windows 11 新增可直接下载安装的 EXE，安装后可从开始菜单启动，也可在
“设置 → 应用 → 已安装的应用”中卸载。保留 v0.3.0 的 Windows 与 Linux 串流功能。

下载

文件	用途
padbridge-0.3.1-windows-x64-setup.exe	Windows 11 x64 安装版，推荐普通用户下载
padbridge-0.3.1-windows-x64.zip	Windows 便携版，完整解压后运行
padbridge_0.3.1_amd64.deb	Ubuntu 24.04 amd64 / Xorg 安装包
padbridge-0.3.1-source.tar.gz	对应版本标签的源码
SHA256SUMS、SHA256SUMS-windows	下载文件的 SHA-256 校验值

Windows 安装与升级

• 安装向导支持简体中文和英文，默认安装到当前用户的 %LOCALAPPDATA%\Programs\PadBridge，
  应用安装本身不要求管理员权限；自动创建开始菜单入口，可选创建桌面快捷方式。
• 安装包包含 Python、Qt、视频运行库和完整项目源码，无需用户另外安装 Python 或手动处理 _internal。
• 后续运行新版安装包即可升级，沿用原安装目录，保留 AppData 中的连接、画面和左右位置设置。
• 更新和卸载前，从托盘或窗口菜单选择“退出 PadBridge”。检测到界面或后台进程仍在运行时，
  安装器会要求先退出，不会强制结束正在使用的串流。
• 卸载移除已安装的程序文件和快捷方式，保留用户设置与用户自行放入安装目录的其他文件。
  Apple 通信组件、独立安装的虚拟显示驱动和显卡程序配置不随应用卸载。
• 原有 ZIP 用户可直接改用安装版，用户设置仍然共用；旧便携目录由用户自行保留或移除。
  显卡按 EXE 路径保存的设置需指向新的安装位置，详见 Windows 指南。

应用安装器目前未做 Authenticode 代码签名，Windows 可能显示未知发布者；
这与首次扩展时单独安装、已签名的虚拟显示驱动是两回事。安装器不自动安装驱动或更改安全策略。

验证

Windows CI 增加真实安装、旧版本安装记录升级、开始菜单和卸载登记、运行中保护、
卸载后保留用户文件与设置的回归测试，并验证安装后的编码器。
Ubuntu 继续执行原有测试、.deb 构建与包检查。本版没有调整 Linux 串流管线或性能参数。

完整使用说明见 Windows 指南。

PadBridge v0.3.0

PadBridge 0.3.0

本版将 Windows 11 后端与 Linux 性能优化合入同一个正式版本，支持通过 USB 或同局域网 Wi-Fi
把 iPad 用作镜像屏或扩展屏。iPad 端仍使用 OpenDisplay。

下载与升级

文件	用途
padbridge_0.3.0_amd64.deb	Ubuntu 24.04 x86_64 / Xorg 安装包
padbridge-0.3.0-windows-x64.zip	Windows 11 x64 便携包，完整解压后运行 PadBridge/PadBridge.exe
padbridge-0.3.0-source.tar.gz	与本次版本标签对应的完整源码
SHA256SUMS、SHA256SUMS-windows	Linux/源码及 Windows 包的校验值

升级前从托盘退出旧版。Ubuntu 使用 sudo apt install ./padbridge_0.3.0_amd64.deb；
Windows 将便携包完整解压到新目录。用户设置保存在各自的用户配置目录中。

Windows 11

• 新增原生镜像与自动虚拟扩展屏、USB/Wi-Fi、触控、Qt 界面和托盘。
• 首次扩展安装固定版本的签名虚拟显示组件，之后自动创建和回收本程序的副屏。
• WGC 采集、NVENC 直接处理 BGRA、独立发送线程，保留 GDI/x264 回退。
• 无 B 帧/前瞻、四帧码率缓冲及逐步帧内刷新，保留主动请求 IDR 恢复。
• 修复镜像/扩展切换后残留黑边，以及副屏重建后误用旧采集设备的问题。

安装与依赖见 Windows 使用说明。

Ubuntu 24.04 / Xorg

• 新增 CUDA 转色/缩放和 NVENC 组合自检，保留 CPU 转色/NVENC 及 x264 回退。
• 限制两帧在途，独立顺序发送，让网络等待与编码并行，避免阻塞桌面事件循环。
• 左/右副屏位置选择与旋转布局恢复；退出和后台异常结束后只回收拥有的副屏。
• 保留镜像不修改主屏、XShm 尺寸变化保护，以及首帧后自动同步 iPad 显示区域。
• 同条件 USB 短测中，串流进程 CPU 从约单核 42% 降至 17%，发送帧率仍约 59.7 FPS。

实现、测量口径和数据见 Linux 优化记录。

两端共通的体验

保存分辨率、帧率、码率与默认左右位置；状态数据提供最近两秒实际 FPS、各阶段耗时与接收端统计。
连接错误保留在状态卡中。关闭窗口隐藏到托盘，真正退出会停止串流并收回副屏。
未连接时不运行采集或编码，连接后静止画面仍保持持续采集。

验证与范围

• Linux 183 项单元/协议测试通过；Ubuntu 与 Windows CI 均执行测试、构建和包检查。
• Linux 实机验证 USB/Wi-Fi、镜像/扩展、左右位置、回收、托盘退出与闲置占用；
  用户确认新版无线画面和 iPad 横竖旋转正常。Windows 实机验证详见
  Windows 优化记录。
• Linux 扩展仍需支持的空闲 Intel/AMD HDMI 接口；镜像请在 PadBridge 内切换。
  Windows USB 需要 Apple 移动设备支持，首次虚拟扩展需要安装驱动组件。
• Wi-Fi 仍可能出现延迟尖峰；自动码率是 USB 24 / Wi-Fi 10 Mbps 固定预设，尚无动态码率。
  Linux 的 GStreamer 1.24 没有 Windows 使用的逐步帧内刷新参数。
• 当前目标为 Ubuntu 24.04 amd64 / Xorg 与 Windows 11 x64；其他系统和硬件尚未全面验证。

PadBridge v0.2.0

PadBridge 0.2.0

首个发布版本：通过 USB 或同一局域网 Wi-Fi，将 iPad 用作 Ubuntu 扩展屏或镜像屏。
iPad 端使用 App Store 的 OpenDisplay（Philip Poloczek）。

功能

• 扩展屏与保持主屏原始设置的镜像模式。
• 分辨率、15～60 FPS、自动或 1～50 Mbps 目标码率。
• NVENC 硬件编码，无法使用时尝试 x264 软件编码。
• 侧边栏界面和系统托盘：关闭窗口后继续连接，托盘退出则停止串流并回收副屏。
• 未连接时不启动视频采集或编码。
• 修复显示尺寸变化时的 XShm BadMatch 竞争，以及镜像切回扩展后等待鼠标移动才更新显示区域的问题。

安装

支持目标为 Ubuntu 24.04 amd64 / Xorg。Windows、Wayland 和 ARM 尚不支持。

sudo apt install ./padbridge_0.2.0_amd64.deb

扩展模式需要 Intel / AMD 驱动支持的空闲 HDMI 接口；镜像模式不需要创建虚拟接口。
镜像请在 PadBridge 内切换，系统显示设置中的强制镜像不是支持路径。
Wi-Fi 协议适用于可信局域网。

验证与文件

• 发布前通过 26 项本地测试和 143 项上游协议 / 会话测试。
• 实机验证过 USB、Wi-Fi、镜像与扩展、参数调整及活动连接中的托盘退出。
• 使用独立 Xephyr 显示器验证截图尺寸变化后的恢复；不以 CI 通过代替硬件验证。
• 其他电脑的显示接口、驱动和性能尚未逐一实测。

下载 .deb 安装包、padbridge-0.2.0-source.tar.gz 对应源码及 SHA256SUMS。
发布包使用系统依赖，不包含开发机的运行库、用户配置或测试截图。