快速开始

CarpeCast (拾音) 是一个在局域网内将 Android 或 macOS 设备的媒体播放状态同步到 Windows 的应用。Windows 端显示正在播放的歌曲和进度，并可远程控制发送端上的播放、暂停、上一首和下一首。

下载

Windows: GitHub Releases | Microsoft Store
Android: GitHub Releases
Mac (实验性): GitHub Releases

功能

自动发现同一局域网中的 Windows 接收端
同步标题、艺术家、专辑、播放状态和进度
在 Windows 端控制 Android 和 macOS 媒体会话：播放/暂停、上一首、下一首
支持从 Windows 系统媒体传输控制（SMTC）操作播放控制
Windows 端支持最小化至系统托盘，后台静默运行
Android 端可选择允许同步的媒体应用
两端均支持设备名称、端口、主题和语言等设置

工作方式

Windows 端每两秒通过 UDP 广播自身信息。
Android 或 macOS 发送端发现接收端后，读取媒体会话并发送播放状态。
Windows 端接收并展示媒体状态；用户的控制操作再通过 UDP 发回发送端。

所有通信仅在本地网络中进行，不依赖云服务。

使用

将 Android 设备和 Windows 电脑连接到同一局域网。
启动 Windows 端 CarpeCast，保持其处于运行状态。
在 Android 端安装并打开 CarpeCast。
按提示前往系统设置，为 CarpeCast 开启通知访问权限。
在 Android 应用的“设备”页面选择发现的电脑；开始播放媒体后，Windows 端即可显示状态并控制播放。

若设备未被发现，请确认两端的发现端口一致，并允许 Windows 防火墙放行 CarpeCast 的专用网络通信。

默认端口

用途	默认端口	说明
设备发现	UDP 5001	Windows 广播、发送端监听
媒体状态	UDP 5000	发送端向 Windows 发送播放状态
播放控制	动态分配	Windows 向发送端发送控制命令（端口动态分配）

Windows 端的“发现端口”和“媒体数据端口”可在设置中修改；Android 端的发现端口也可在设置中修改。为确保设备正常发现，请让两端的发现端口保持一致。

开发与构建

Android

要求： Android Studio（或 Gradle 8.7）、JDK 17，以及 Android SDK 35。应用最低支持 Android 8.0（API 26）。

在 Android Studio 中打开 Android 目录后即可运行或构建。命令行构建：

powershell

cd Android
gradle assembleDebug

调试 APK 位于 Android\app\build\outputs\apk\debug\app-debug.apk。

Windows

要求： Windows 10 1809 或更高版本、.NET 10 SDK，以及安装了 Windows App SDK 工作负载的 Visual Studio 2022。

使用 Visual Studio 打开 Windows\CarpeCast.slnx 并运行；或使用命令行：

powershell

dotnet build Windows\CarpeCast.csproj
dotnet run --project Windows\CarpeCast.csproj

Mac (实验性)

要求: GitHub 账号（用于云端自动打包），或拥有安装了 swiftc 和 Python 3 的本地 macOS 环境。

Mac 发送端拥有完整的图形界面（GUI），支持配置持久化，并采用 双引擎抓取策略（Dual-Engine），即使在运行 Parallels 等虚拟机导致焦点丢失的情况下，依然能强力抓取媒体数据并同步给 Windows：

底层引擎 (MediaRemote API)：通过 Swift 编译的后台辅助程序，全局抓取任意播放器（如 Chrome 网页播放、网易云等）的曲目信息。
直连引擎 (AppleScript 自动化)：当虚拟机或系统原因导致底层焦点被抢占时，Python 主程序会自动降级采用 AppleScript 直接与 Apple Music / Spotify 进程通信，强行提取当前播放曲目与精准的毫秒级进度。

你可以直接从 Releases 页面下载已打包好的 CarpeCast-Mac.zip，解压即可得到 CarpeCast.app。

如果你希望自行通过云端编译打包：

将 Mac 目录及 .github 工作流文件 Push 到你的 GitHub 仓库中。
GitHub Actions 会自动触发编译，利用原生的 swiftc 编译 Swift 辅助程序，随后通过 pyinstaller 将 Python UI 脚本与官方 Logo 打包成 macOS 原生的 .app 包结构。
编译完成后，在 GitHub 仓库的 Actions 标签页下载生成的 CarpeCast-Mac.zip。

测试注意事项：

Mac 端启动后会自动通过 UDP 5001 端口发现局域网内的 Windows 接收端，无需手动配置 IP。
如果触发了 AppleScript 降级引擎，macOS 会弹出自动化控制请求，请务必在“系统设置 -> 隐私与安全性 -> 自动化”中允许 CarpeCast 控制 Music/Spotify。
初次运行可能需要在“隐私与安全性”中点击“仍要打开”以允许未签名的应用运行。

项目结构

text

Android/    Android 发送端，负责发现设备、读取媒体会话并执行远程命令
Mac/        macOS 发送端 (实验性)，基于 Python (Tkinter) + Swift，双引擎全局抓取媒体状态
Windows/    WinUI 3 接收端，负责显示媒体状态并发送播放控制命令

注意事项

Android 端必须授予通知访问权限，否则无法读取其他应用的媒体会话。
部分媒体应用可能不提供完整的标题、封面或播放控制能力。
避免与其他应用占用相同的 UDP 端口；修改端口后需同步更新另一端设置。

许可证

CarpeCast 采用 GNU General Public License v3.0 许可证。

快速开始 ​

下载 ​

功能 ​

工作方式 ​

使用 ​

默认端口 ​

开发与构建 ​

Android ​

Windows ​

Mac (实验性) ​

项目结构 ​

注意事项 ​

许可证 ​