# Galaxy Buds Client：基于三星耳机协议的非官方管理器

> 在跨平台桌面与 Android 管理器中，通过三星 Galaxy Buds 专有的 RFCOMM 串口协议重新实现耳机控制。作者称通过分析耳机发出的二进制数据流并反汇编三星官方 Android 应用来恢复报文格式，并公开了 2019 款 Buds 和 Buds+ 的部分数据包笔记。除官方应用的设置外，它还提供电池统计、诊断、出厂自检、隐藏调试信息，以及适用型号的固件刷写。

- 类型：案例
- 目标：应用 · 协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-10-19
- 收录于：2026-10-19
- 原始资源：<https://github.com/timschneeb/GalaxyBudsClient>
- 一手来源：<https://github.com/timschneeb/GalaxyBudsClient/blob/754b6fdfb1c151b022cece775c8aaad4eb185afa/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/galaxy-buds-client-protocol-case/>
- 记录 JSON：<https://awesomerea.org/resources/galaxy-buds-client-protocol-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/galaxy-buds-client-protocol-case/index.md)

## 使用条件与局限

- **前提条件：**需要用户自己通过蓝牙配对的 Galaxy Buds；耳机固件和三星官方应用都不在仓库中。固件刷写和降级会从作者的固件服务下载版本，应用内先显示免责声明，并做型号兼容性检查以避免设备变砖。发布说明称，应用可通过按需启用的众包功能共享协议数据，用于支持作者没有的型号，并会把崩溃转储发送到 Sentry；两者都可在设置中关闭。
- **前提条件：**使用 .NET 10 SDK（global.json 固定为 10.0.300）和 Avalonia 从同一解决方案构建，面向 Windows 10 build 19041+、macOS 12+、Linux 及 Android 7.0+（API 24）；Linux 蓝牙通过仓库自带的 BlueZ D-Bus 库实现。5.2.1 版附带未签名的 Windows 与 macOS 安装包以及 Linux x64/ARM 便携版；README 还列出 Flatpak、AUR 和 winget 软件包，Android 版在 Google Play 付费提供。
- **范围：**审阅对象为 2026-10-01 的 master 最新提交，比 5.2.1 版（2026-06-07）多 72 个提交。源码中的设备规格覆盖从 2019 款初代 Buds 到 Buds4 系列的 Galaxy Buds 型号。协议笔记自称并不完整，细节需参考源码；这是独立客户端，并非恢复出的三星源码，功能因型号而异。
- **测试证据：**NUnit 测试项目解码七个型号的已捕获扩展状态数据包，并检查报文和空间音频解析；所审阅的 CI 工作流只构建并发布二进制文件，不运行这些测试。协议与功能在真实耳机上的表现仍属作者报告。
- **许可：**采用 GPLv3（LICENSE）；README 声明项目与三星无关，也不受其监管。三星固件、应用和商标保留各自权利。

## 一手来源

1. <https://github.com/timschneeb/GalaxyBudsClient/blob/754b6fdfb1c151b022cece775c8aaad4eb185afa/README.md>
2. <https://github.com/timschneeb/GalaxyBudsClient/blob/754b6fdfb1c151b022cece775c8aaad4eb185afa/GalaxyBudsRFCommProtocol.md>
3. <https://github.com/timschneeb/GalaxyBudsClient/blob/754b6fdfb1c151b022cece775c8aaad4eb185afa/Galaxy%20Buds%20Plus%20RFComm%20Protocol%20Notes.md>
4. <https://github.com/timschneeb/GalaxyBudsClient/blob/754b6fdfb1c151b022cece775c8aaad4eb185afa/GalaxyBudsClient/GalaxyBudsClient.csproj>
5. <https://github.com/timschneeb/GalaxyBudsClient/blob/754b6fdfb1c151b022cece775c8aaad4eb185afa/GalaxyBudsClient.Android/GalaxyBudsClient.Android.csproj>
6. <https://github.com/timschneeb/GalaxyBudsClient/blob/754b6fdfb1c151b022cece775c8aaad4eb185afa/global.json>
7. <https://github.com/timschneeb/GalaxyBudsClient/tree/754b6fdfb1c151b022cece775c8aaad4eb185afa/GalaxyBudsClient/Model/Specifications>
8. <https://github.com/timschneeb/GalaxyBudsClient/blob/754b6fdfb1c151b022cece775c8aaad4eb185afa/GalaxyBudsClient/Model/Firmware/FirmwareRemoteClient.cs>
9. <https://github.com/timschneeb/GalaxyBudsClient/blob/754b6fdfb1c151b022cece775c8aaad4eb185afa/GalaxyBudsClient/Interface/ViewModels/Pages/FirmwarePageViewModel.cs>
10. <https://github.com/timschneeb/GalaxyBudsClient/blob/754b6fdfb1c151b022cece775c8aaad4eb185afa/GalaxyBudsClient.Tests/GalaxyBudsClient.Tests.csproj>
11. <https://github.com/timschneeb/GalaxyBudsClient/blob/754b6fdfb1c151b022cece775c8aaad4eb185afa/GalaxyBudsClient.Tests/Buds2Pro/ExtendedStatusUpdateTests.cs>
12. <https://github.com/timschneeb/GalaxyBudsClient/blob/754b6fdfb1c151b022cece775c8aaad4eb185afa/.github/workflows/compile-linux.yml>
13. <https://github.com/timschneeb/GalaxyBudsClient/blob/754b6fdfb1c151b022cece775c8aaad4eb185afa/LICENSE>
14. <https://github.com/timschneeb/GalaxyBudsClient/releases/tag/5.2.1>

## 同分区更多条目：应用

- [Wino Mail：重建 Windows 邮件与日历体验](https://awesomerea.org/zh/resources/wino-mail-case/index.md) · 案例
- [ScooterLink：重建 Honda RoadSync 车把按键协议](https://awesomerea.org/zh/resources/scooterlink-honda-roadsync-case/index.md) · 案例
- [iX500 Scan：基于逆向 ScanSnap Wi-Fi 协议的 macOS 客户端](https://awesomerea.org/zh/resources/ix500-scan-scansnap-wifi-case/index.md) · 案例
- [WristBeam：为 Mac 配套应用重建佳明手表协议](https://awesomerea.org/zh/resources/wristbeam-garmin-watch-protocol-case/index.md) · 案例
- [usque：Cloudflare WARP MASQUE 模式的开源再实现](https://awesomerea.org/zh/resources/usque-warp-masque-client-case/index.md) · 案例
- [Webamp：在浏览器中重新实现 Winamp 2](https://awesomerea.org/zh/resources/webamp-winamp-reimplementation-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。