Skip to content

Unofficial Galaxy Buds Manager for Windows and Linux

License

Notifications You must be signed in to change notification settings

VlaK0r/GalaxyBudsClient

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

English | 中文(简体) | 中文(繁體) | Русский | 日本語 | Українська | 한국어 | Česky | Ελληνικά
Attention: readme files are maintained by translators and may become outdated from time to time. For newest info rely on English version.

Galaxy Buds Client

An unofficial manager for the Buds, Buds+, Buds Live and Buds Pro

GitHub downloads count GitHub release (latest by date) License Platform

Key FeaturesDownloadHow it worksContributingCreditsLicense

Screenshot

Screenshot

Key Features

Configure and control any Samsung Galaxy Buds device and integrate them into your desktop.

Aside from standard features known from the official Android app, this project helps you to release the full potential of your earbuds and implements new functionality such as:

  • Detailed battery statistics
  • Diagnostics and factory self-tests
  • Loads of hidden debugging information
  • Customizable long-press touch actions
  • Firmware flashing, downgrading (Buds+, Buds Pro)
  • and much more...

Download

Get binaries for Windows and Linux in the release section. Please read the release notes before installing.

Download

winget

The Windows package is also available to install with Windows Package Manager (winget)

winget install ThePBone.GalaxyBudsClient

AUR package

An AUR package for Arch Linux maintained by @joscdk is also available:

yay -S galaxybudsclient-bin

How it works

To use Bluetooth wireless technology, a device must be able to interpret certain Bluetooth profiles, which are definitions of possible applications and specify general behaviors that Bluetooth-enabled devices use to communicate with other Bluetooth devices.

The Galaxy Buds define two Bluetooth profiles: A2DP (Advanced Audio Distribution Profile) for audio streaming/controlling and SPP (Serial Port Profile) for transmitting a binary stream. Manufacturers often use this profile (which relies on the RFCOMM protocol) to exchange configuration data, perform firmware updates or send other commands to the Bluetooth device.

Even though the A2DP profile is standardized and documented, the format of the actual binary data exchanged by this RFCOMM protocol is usually not documented and proprietary.

In order to reverse-engineer this data format, I started off by analyzing the structure of the binary stream send by the earbuds. Later on, I also disassembled the official Galaxy Buds apps for Android to gain more insight of the inner workings of these devices. While working on this, I wrote my thoughts down into a small scratchpad. Even though they are not that beautiful, I've linked them down below. Keep in mind that I didn't bother to write every single detail down. Check the source code to get more detailed information on the structure of the protocol.

Galaxy Buds (2019) NotesGalaxy Buds Plus Notes

While taking a closer look at the Galaxy Buds Plus, I also noticed some unusual features, such as a firmware debug mode, an unused pairing mode and a Bluetooth key dumper. I documented these findings here:

Galaxy Buds Plus: Unusual features

Currently, I'm looking into modifying and reverse-engineering the firmware for the Buds+. At time of writing I have two tools to fetch and analyse with official firmware binaries. Check them out here:

Firmware DownloaderFirmware Extractor

Stream head-tracking data in realtime from your Buds Pro using this script: ThePBone/BudsPro-Headtracking

Contributing

Feature requests, bug reports, and pull requests of any kind are always welcome.

If you want to report bugs or propose your ideas for this project, you are welcome to open a new issue with a suitable template. Visit our wiki for a detailed explanation.

If you are planning to help us translating this app, refer to the instructions on our wiki. No programming knowledge is required, you can test your custom translations without installing any development tools before submitting a pull request. You can find auto-generated progress reports for existing translations here.

If you want to contribute your own code, you can simply submit a plain pull request explaining you changes. For larger and complex contributions it would be nice if you could open an issue (or message me via Telegram @thepbone) before starting to work on it.

Credits

Contributors

Translators

License

This project is licensed under GPLv3. It is not affiliated with Samsung nor supervised by them in any way.

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.

About

Unofficial Galaxy Buds Manager for Windows and Linux

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 97.3%
  • HTML 2.6%
  • Other 0.1%