Airflow

项目概述

Airflow 是一款把 iPad / Mac 屏幕无线投到 Windows 电脑上的接收器，画面清晰、延迟低，单文件 exe 下载即用，不装 Python、不编译、不手动配依赖。首次启动自动安装 Apple Bonjour，之后在 iPad / Mac 的「屏幕镜像」里选 iPad-Screen 即可。它按设备自动区分显示方式：iPad 投屏走全屏镜像，Mac 走 1:1 不拉伸的扩展屏，按 F2 随时切换。接收引擎是 UxPlay（GPL-3.0），界面用 PyQt6 编写，本项目代码 MIT。

Windows 桌面变成 AirPlay 目标，iPad 镜像、Mac 扩展屏两相宜。

项目	内容
平台	Windows（单文件 exe）
技术栈	PyQt6 + UxPlay 接收引擎
画质	最高 H.265 4K，帧率可调
附加	内置 Deskflow KVM 键盘共享
许可证	MIT（引擎 UxPlay 与 Deskflow 为 GPL-3.0）

主要功能

• 设备自适应显示：iPad 全屏镜像、Mac 扩展屏 1:1 不拉伸，F2 切换
• 无边框置顶全屏：画面直接铺满，闲置自动隐藏鼠标，投屏期间禁止熄屏与休眠
• 视频参数：尺寸、画质、帧率、音频开关、翻转与旋转，改完自动重启投屏服务
• 多显示器与托盘：显示器选择、窗口位置记忆、托盘图标与关闭到托盘
• 状态角标：设备名、分辨率、帧率与连接时长常显
• KVM 键盘共享：内置 Deskflow，一套键鼠同时控制 PC 和 Mac，端口 24800

快捷键

按键	作用
F1	打开设置面板
F2	全屏镜像与扩展屏切换
F5	重启投屏服务
F3	复制局域网直发链接
ESC / Q	退出并安全关闭投屏服务

局域网直发

1. 设置 → 键盘共享，勾选「启用键盘共享」与「局域网分享」并保存
2. 主界面大字显示 http://本机IP:8123/，按 F3 复制链接
3. Mac 终端执行 curl -fsSL http://本机IP:8123/install.sh | bash，自动装 Deskflow 客户端并连接
4. Mac 首次使用需在系统设置的辅助功能里勾选 Deskflow，鼠标移到屏幕右边缘即切换键盘

快速上手

1. 从 Releases 下载 Airflow.exe 双击运行，首次弹 UAC 时点是
2. iPad / Mac 打开「屏幕镜像」选择 iPad-Screen
3. F1 进设置调画质、显示器与音频，F5 重启服务生效
4. 搜不到设备时确认同一局域网、防火墙放行 uxplay

系统要求

项目	要求
操作系统	Windows
网络	iPad/Mac 与电脑同一局域网，Bonjour 自动安装
日志	%TEMP%/Airflow.log

注意事项

• KVM 边界：AirPlay 协议本身不传键盘鼠标，键盘共享是独立的 Deskflow 通道
• 扩展屏比例：画面比例不对时切「全屏镜像/扩展屏」，或把 Mac 扩展屏分辨率调成 1080p
• 组件许可：Windows 预编译 UxPlay 来自 yztshh/Uxplay-airplay，两者均为 GPL-3.0