English | 中文(简体) | 中文(繁體) | Русский | 日本語 | Українська | 한국어 | Česky | Türkçe | Ελληνικά | Português | Tiếng Việt
_{注意：该 README 文档由翻译人员维护，可能会过时，以英文版最新版本为准。}

Galaxy Buds Client

一个非官方的 Galaxy Buds 管理工具

主要功能 • 下载 • 工作原理 • 贡献项目 • 鸣谢 • License

主要功能

配置和控制任何 Galaxy Buds 设备，并整合到你的设备中。

除了官方 Android 程序中已知的功能外，该项目还可以帮助您释放耳机的全部潜力，并实现了新的功能，例如：

• 详细电池统计
• 诊断和工厂自检
• 大量隐藏的调试信息
• 可定制的长按触摸动作
• 固件写入，降级 (Buds+, Buds Pro)
• 以及更多...

下载

目前提供多种 Linux 软件包：

• Flatpak（所有 Linux 发行版）
• AUR 软件包（Arch Linux）

在 release 页面中获取 Windows 的二进制文件。安装前请阅读发行说明。

在此下载桌面版：

在此下载 Android 版（收费）：

Flatpak

适用于所有 Linux 发行版的通用软件包。Flatpak 版本默认不支持开机自启动，除非手动进行配置。你可以使用 galaxybudsclient /StartMinimized，让应用在系统启动时静默启动。

可从 FlatHub 下载: https://flathub.org/apps/me.timschneeberger.GalaxyBudsClient

flatpak install me.timschneeberger.GalaxyBudsClient

注意: Flatpak 应用运行在沙盒环境中。默认情况下，本应用只能访问 ~/.var/app/me.timschneeberger.GalaxyBudsClient/

AUR 软件包

@joscdk 维护的 Arch Linux 平台的 AUR 包 也可供下载：

yay -S galaxybudsclient-bin

winget

Windows 版本也可以通过 Windows Package Manager (winget) 安装

winget install ThePBone.GalaxyBudsClient

工作原理

为了使用蓝牙无线技术，设备必须能够解析特定的蓝牙配置文件，从而使蓝牙设备之间能够高效通信。

Galaxy Buds 定义了两种蓝牙配置文件：用于音频流传输与控制的 A2DP（高级音频分发配置文件）；以及用于传输二进制数据流的 SPP（串行端口配置文件）。制造商通常使用该配置文件（其基于 RFCOMM 协议）来交换配置数据、执行固件更新或向蓝牙设备发送其他命令。

尽管 A2DP 配置文件已标准化并有公开文档，但通过 RFCOMM 协议交换的二进制数据格式通常为专有格式。

为了逆向分析该数据格式，我首先分析了耳塞发送的二进制数据流结构。随后，我还反编译了官方的 Android 版 Galaxy Buds 应用，以深入了解这些设备的内部工作机制。以下是我整理的部分（不完整的）笔记。有关协议结构的更详细信息，请参阅源代码。

Galaxy Buds (2019) Notes • Galaxy Buds Plus Notes

在进一步研究 Galaxy Buds Plus 的时候，我还注意到了一些不寻常的特性，比如固件调试模式、未使用的配对模式和蓝牙密钥转储程序。我在这里记录了这些发现：

Galaxy Buds Plus: Unusual features

目前，我正在研究对 Buds+ 的固件进行修改和逆向工程。在撰写本文时，我已经创建了两个工具，用于获取和分析官方固件二进制文件。请在此处查看：

Firmware Downloader • Firmware Extractor

使用这个脚本，实时查看流式的 Buds Pro 头部追踪数据：ThePBone/BudsPro-Headtracking

贡献项目

我们始终欢迎任何形式的功能请求、错误报告和 PR。

如果你想报告错误或提出你对这个项目的想法，欢迎你使用模板开启一个新的 Issues。查看 wiki 以获得更详细的信息。

如果您打算帮助我们翻译此应用程序，请参阅 Wiki 上的说明。您可以在提交 PR 前测试自定义翻译，这无需编程知识，也不需要安装任何开发工具。 你可以找到现有翻译的自动生成的进度报告在此处。

如果您想贡献自己的代码，只需提交一个简单的 PR 来解释您的更改。对于更复杂的代码，我希望能够在提交请求之前通过 Telegram @thepbone 与我交流。

鸣谢

贡献人员

• @nift4 - macOS 支持与错误修复
• @ArthurWolfhound - Issue 模板、wiki 和翻译
• @AndriesK - Buds Live bug 修正
• @TheLastFrame - Buds Pro 的图标设计
• @githubcatw - 基础连接会话
• @GaryGadget9 - WinGet 包维护
• @joscdk - AUR 包维护

翻译人员

• @ArthurWolfhound - 俄语和乌克兰语翻译
• @PlasticBrain - 韩语和日语翻译
• @cozyplanes - 韩语翻译
• @corydalis10 - 韩语翻译
• @erenbektas 和 @Eta06 - 土耳其语翻译
• @kakkk、@KevinZonda、@ssenkrad、@pseudor 和 @YexuanXiao - 简体中文翻译
• @YiJhu - 繁体中文翻译
• @efrenbg1 和 Andrew Gonza - 西班牙语翻译
• @giovankabisano - 印度尼西亚语翻译
• @lucasskluser 和 @JuanFariasDev - 葡萄牙语翻译
• @alb-p、@mario-donnarumma - 意大利语翻译
• @Buashei - 波兰语翻译
• @KatJillianne 和 @thelegendaryjohn - 越南语翻译
• @joskaja 和 @Joedmin - 捷克语翻译
• @Benni0109、@TheLastFrame、@timschneeb - 德语翻译
• @nikossyr - 希腊语翻译
• @grigorem - 罗马尼亚语翻译
• @tretre91 - 法语翻译
• @Sigarya - 希伯来语翻译
• @domroaft - 匈牙利语翻译
• @lampi8426 - 荷兰语翻译

License

本项目使用 GPLv3 许可。它既不属于三星，也不受三星的任何监管。

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
THE USE OR OTHER DEALINGS IN THE SOFTWARE.