FreeControl

项目概述

当你要在电脑上投屏控制多台 Android 设备、又不想背 scrcpy 命令行参数时，FreeControl 提供了一套可视化面板：设备清单、无线配对、参数控件、连接控制全部图形化完成，投屏与控制本身仍由 scrcpy 执行。项目以 Rust + Tauri 2 + Svelte 构建，MIT 许可证，Windows 提供免安装单文件，Linux 与 macOS 各有安装包，scrcpy 与 adb 按需下载、无需手动安装。

scrcpy 干活，FreeControl 管设备、配参数、看状态。

项目	内容
定位	scrcpy 图形外壳（设备管理 + 参数面板）
技术栈	Rust + Tauri 2，前端 Svelte + Vite + TypeScript
平台	Windows 10/11（x64 与 ARM64）、Linux（AppImage/deb）、macOS 11+（dmg）
投屏内核	scrcpy 与 adb 按需下载，多通道回退并核对官方校验值
许可证	MIT

主要功能

• 设备清单：每台设备一个别名，映射到 USB 序列号或 IP:端口，在线状态实时可见，支持增删改
• 无线配对与发现：配对码一次配对，点一下列出局域网内已开无线调试的设备，兼容 adb tcpip 5555 老方案
• 参数面板：六组常用选项做成控件，逐项对应 scrcpy 长选项名，每项可点「?」看详情，另有自定义参数框
• 设备参数：单台设备一套参数，优先于全局参数，可整体启用或停用
• 多设备投屏：单台或全部连接、断开，多台设备同时投屏，进程与输出由程序托管
• 命令预览：底部显示将执行的完整 scrcpy 命令，可一键复制
• 应用内更新：「关于」里检查并下载新版本，核对后原地替换，便携版自行重启
• 日志与外观：会话日志按 7 天、30 天或永久保留，深浅色主题、界面与代码字体、中英文界面可切换

快速开始

1. 从 Releases 下载对应平台的包：Windows 按架构选 _windows_x64.exe 或 _windows_arm64.exe，放到任意可写目录双击即用
2. 首次启动到「运行环境」页获取 scrcpy 与 adb（默认下载到应用数据目录，也可改为已有目录）
3. 在「设备」页添加设备：USB 填 adb devices 列出的序列号；无线可选「局域网扫描」「配对码」或手填 IP:端口
4. 在设备卡上点「连接」开始投屏，底部命令预览可确认实际下发的命令

Android 手机需先开启开发者选项与 USB 调试；无线配对（Android 11+）在手机「无线调试」里点「使用配对码配对设备」，把 6 位配对码填进应用即可。

界面与数据

• 四个页面：设备页管清单与连接，参数页配常用选项，运行环境页取 scrcpy 与 adb，设置页管外观、字体、语言、自动更新与日志
• 数据目录：Windows 在 %APPDATA%/FreeControl2，macOS 在 ~/Library/Application Support/FreeControl2；config.json 存设备清单与参数，logs/ 按日期存日志
• 恢复默认：删掉 config.json 再启动即可回到出厂设置
• 退出不断连：退出应用不会结束 adb 服务端，已建立的无线连接下次启动直接复用

系统要求

项目	要求
Windows	10 / 11，x64 或 ARM64，需系统自带 WebView2
Linux	AppImage 或 deb，依赖 webkit2gtk 等系统库
macOS	11 及以上，安装需 Safari 16.2+
Android	开启 USB 调试；无线配对需 Android 11+

注意事项

• 无线端口会变：连接端口随设备重启或重开无线调试而变化，设备离线时点设备卡上的「重新解析端口」
• macOS 首次放行：dmg 未经公证，到「系统设置 → 隐私与安全性」点「仍要打开」，或执行 xattr -dr com.apple.quarantine /Applications/FreeControl.app
• Linux 渲染兜底：虚拟机或软件渲染环境若界面停止刷新，用 WEBKIT_DISABLE_DMABUF_RENDERER=1 启动
• Windows 空白界面：确认已安装 WebView2 运行时（Win10/11 一般自带）