PhoneBox
PhoneBox 将旧安卓手机变成 Windows、Linux 和 macOS 电脑的桌面面板与触控台,提供 120 多个小组件、30 套模板,可查看系统状态、AI 编程额度、音乐并实现自动化,支持 USB 或 Wi-Fi 配对,无需账号或云服务。
访问 ersinkoc/phonebox项目简介
PhoneBox 由一个全屏 Android 应用和一个小型桌面代理组成,可把旧安卓手机变成 Windows、Linux 和 macOS 上可定制的桌面面板与触控台。它支持 USB 或 Wi-Fi 连接、在浏览器中编辑布局,并可在没有 PhoneBox 账号或云服务的情况下本地运行。
核心功能
- 提供可视化布局编辑器,支持 120 多个小组件、30 套模板、12×6 网格、多页面、横竖屏布局和 Smart Stack。
- 可监控 CPU、GPU、内存、磁盘、网络、延迟和进程,并显示图表与 GPU 详情。
- 可查看 Claude、Codex 和 Antigravity 的额度、重置时间、消耗速率预测、本地会话、GitHub 评审和 CI 状态,并可在手机上处理 Claude Code 权限提示。
- Control Deck 提供应用、网址快捷方式、组合键、宏、应用音频、麦克风、媒体、OBS、任务、开发服务器和显示亮度等触控操作。
- 支持 USB 或 Wi-Fi/Tailscale 连接,使用固定证书和配对密钥;PhoneBox 没有账号和遥测,也不要求云服务。
- 可通过 Webhook 推送数值和通知,配合 Home Assistant 控件和规则,根据电脑活动切换页面。
适用场景
- 把旧安卓手机改作电脑旁的副屏,持续查看系统、网络和进程状态。
- 编程时随时查看 AI 编程额度、会话、GitHub 评审和 Claude Code 权限提示。
- 把手机当作媒体、OBS、应用、快捷方式、音量、麦克风和显示亮度的触控控制台。
- 通过 Webhook 接收 CI、脚本或 Home Assistant 的数值和通知,并用规则自动切换页面。
快速开始
- 在 Windows 上运行 PowerShell 安装脚本,或在 Linux/macOS 上运行 shell 安装脚本;安装过程会检查下载、在缺少 adb 时安装 adb,并可将手机应用安装到手机。
- 使用启用 USB 调试的 Android 5 及以上手机通过 USB 连接,或在设置中启用 Wi-Fi 后扫描二维码配对手机。
- 打开本地设置页面,在页面中选择模板,拖动并调整小组件大小后保存;实时预览可用实时数据显示未保存的修改。
部署与要求
- 发布版支持 Windows 10/11 x64、使用 glibc 的 Linux x64 或 ARM64,以及 Apple 芯片或 Intel 的 macOS。
- 需要 Android 5 及以上手机,推荐 Android 6 或更新版本;没有 iOS 版本。
- USB 连接需要数据线和 USB 调试;Wi-Fi 配对不需要这两者。发布版代理已包含 .NET,无需单独安装运行时。
- 小组件取决于主机硬件、已安装工具和权限;高级 Control Deck 功能有各自的平台要求;Windows ARM 和 musl Linux(如 Alpine)没有发布版。
采用前须知
- 许可证:MIT。在使用、修改或分发项目前,请确认其具体条款。