{"id":15039488,"url":"https://github.com/timschneeb/galaxybudsclient","last_synced_at":"2025-05-13T19:16:56.514Z","repository":{"id":37012032,"uuid":"271116132","full_name":"timschneeb/GalaxyBudsClient","owner":"timschneeb","description":"Unofficial Galaxy Buds Manager for Windows, macOS, Linux, and Android","archived":false,"fork":false,"pushed_at":"2025-04-25T12:38:03.000Z","size":32708,"stargazers_count":4063,"open_issues_count":59,"forks_count":211,"subscribers_count":44,"default_branch":"master","last_synced_at":"2025-04-25T13:49:37.879Z","etag":null,"topics":["bluetooth","buds-live","buds-plus","buds-pro","earbuds","firmware","galaxy-buds","manager","reverse-engineering","rfcomm","samsung"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/timschneeb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":"FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"ko_fi":"thepbone","github":"thepbone","custom":"https://paypal.me/timschneeberger"}},"created_at":"2020-06-09T21:44:20.000Z","updated_at":"2025-04-25T12:38:07.000Z","dependencies_parsed_at":"2024-03-13T14:47:28.840Z","dependency_job_id":"5af32ebc-60af-4365-b6ca-8c0a11b834dc","html_url":"https://github.com/timschneeb/GalaxyBudsClient","commit_stats":{"total_commits":1680,"total_committers":69,"mean_commits":"24.347826086956523","dds":"0.36964285714285716","last_synced_commit":"73c9f79235d2ed1f3052d243abd335459cabfe64"},"previous_names":["timschneeb/galaxybudsclient","thepbone/galaxybudsclient"],"tags_count":41,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timschneeb%2FGalaxyBudsClient","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timschneeb%2FGalaxyBudsClient/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timschneeb%2FGalaxyBudsClient/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timschneeb%2FGalaxyBudsClient/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timschneeb","download_url":"https://codeload.github.com/timschneeb/GalaxyBudsClient/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251296571,"owners_count":21566630,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bluetooth","buds-live","buds-plus","buds-pro","earbuds","firmware","galaxy-buds","manager","reverse-engineering","rfcomm","samsung"],"created_at":"2024-09-24T20:43:01.182Z","updated_at":"2025-04-28T10:38:37.640Z","avatar_url":"https://github.com/timschneeb.png","language":"C#","funding_links":["https://ko-fi.com/thepbone","https://github.com/sponsors/thepbone","https://paypal.me/timschneeberger","https://ko-fi.com/H2H83E5J3"],"categories":[],"sub_categories":[],"readme":"\n\u003cp align=\"center\"\u003e\n  English | \u003ca href=\"/docs/README_chs.md\"\u003e中文(简体)\u003c/a\u003e | \u003ca href=\"/docs/README_cht.md\"\u003e中文(繁體)\u003c/a\u003e | \u003ca href=\"/docs/README_rus.md\"\u003eРусский\u003c/a\u003e | \u003ca href=\"/docs/README_jpn.md\"\u003e日本語\u003c/a\u003e | \u003ca href=\"/docs/README_ukr.md\"\u003eУкраїнська\u003c/a\u003e | \u003ca href=\"/docs/README_kor.md\"\u003e한국어\u003c/a\u003e | \u003ca href=\"/docs/README_cze.md\"\u003eČesky\u003c/a\u003e | \u003ca href=\"/docs/README_tr.md\"\u003eTürkçe\u003c/a\u003e | \u003ca href=\"/docs/README_gr.md\"\u003eΕλληνικά\u003c/a\u003e | \u003ca href=\"/docs/README_pt.md\"\u003ePortuguês\u003c/a\u003e | \u003ca href=\"/docs/README_vnm.md\"\u003eTiếng Việt\u003c/a\u003e \u003cbr\u003e\n    \u003csub\u003eAttention: readme files are maintained by translators and may become outdated from time to time. For the newest info rely on the English version.\u003c/sub\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\"\u003e\n  Galaxy Buds Client\n  \u003cbr\u003e\n\u003c/h1\u003e\n\u003ch4 align=\"center\"\u003eAn unofficial manager for Galaxy Buds devices\u003c/h4\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/timschneeb/GalaxyBudsClient/releases\"\u003e\n    \u003cimg alt=\"GitHub downloads count\" src=\"https://img.shields.io/github/downloads/thepbone/galaxybudsclient/total\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/timschneeb/GalaxyBudsClient/releases\"\u003e\n   \u003cimg alt=\"GitHub release (latest by date)\" src=\"https://img.shields.io/github/v/release/thepbone/galaxybudsclient\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/timschneeb/GalaxyBudsClient/blob/master/LICENSE\"\u003e\n      \u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/thepbone/galaxybudsclient\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/timschneeb/GalaxyBudsClient/releases\"\u003e\n    \u003cimg alt=\"Platform\" src=\"https://img.shields.io/badge/platform-Windows/macOS/Linux/Android-yellowgreen\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#key-features\"\u003eKey Features\u003c/a\u003e •\n  \u003ca href=\"#download\"\u003eDownload\u003c/a\u003e •\n  \u003ca href=\"#how-it-works\"\u003eHow it works\u003c/a\u003e •\n  \u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e •\n  \u003ca href=\"#credits\"\u003eCredits\u003c/a\u003e •\n  \u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cspan\u003e\u003ca href=\"https://ko-fi.com/H2H83E5J3\"\u003e\u003cimg alt=\"Screenshot\" src=\"https://ko-fi.com/img/githubbutton_sm.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"#\"\u003e\u003cimg alt=\"Screenshot\" src=\"https://github.com/timschneeb/GalaxyBudsClient/raw/master/screenshots/app_dark.png\"\u003e\u003c/a\u003e\u003c/span\u003e\n\u003c/p\u003e\n\n## Key Features\n\nConfigure and control any Samsung Galaxy Buds device and integrate them into your desktop.\n\nAside 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:\n\n* Detailed battery statistics\n* Diagnostics and factory self-tests\n* Loads of hidden debugging information\n* Customizable long-press touch actions\n* Firmware flashing, downgrading (Buds+, Buds Pro)\n* and much more...\n\nIf you're looking for older firmware binaries, have a look here: [https://github.com/timschneeb/galaxy-buds-firmware-archive](https://github.com/timschneeb/galaxy-buds-firmware-archive#galaxy-buds-firmware-archive)\n\n## Download\n\nThere are several Linux packages available:\n* [Flatpak (All Linux distros)](#flatpak)\n* [AUR package (Arch Linux)](#aur-package)\n\nGet binaries for Windows in the [release](https://github.com/timschneeb/GalaxyBudsClient/releases) section. Please read the release notes before installation.\n\nDownload the desktop version here:\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/timschneeb/GalaxyBudsClient/releases\"\u003e\u003cimg alt=\"Download\" src=\"https://github.com/timschneeb/GalaxyBudsClient/raw/master/screenshots/download.png\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nDownload the Android mobile version here (paid):\n\u003cp align=\"center\"\u003e\n  \u003ca href='https://play.google.com/store/apps/details?id=me.timschneeberger.galaxybudsclient\u0026utm_source=github\u0026pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1'\u003e\n    \u003cimg width=\"300\" alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png'/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n### Flatpak\n\nUniversal binary packages for all Linux distributions. The Flatpak version does not support autostart unless it is set up manually. You can use `galaxybudsclient /StartMinimized` to launch the app silently during startup.\n\nAvailable for download on FlatHub: https://flathub.org/apps/me.timschneeberger.GalaxyBudsClient\n```\nflatpak install me.timschneeberger.GalaxyBudsClient\n```\n\n\u003ca href='https://flathub.org/apps/me.timschneeberger.GalaxyBudsClient'\u003e\u003cimg width='240' alt='Download on Flathub' src='https://dl.flathub.org/assets/badges/flathub-badge-en.png'/\u003e\u003c/a\u003e\n\n\u003e **Note**: Flatpaks are sandboxed. This application can only access `~/.var/app/me.timschneeberger.GalaxyBudsClient/` by default.\n\n### AUR package\n\nAn [AUR package](https://aur.archlinux.org/packages/galaxybudsclient-bin/) for Arch Linux maintained by @joscdk is also available:\n```\nyay -S galaxybudsclient-bin\n```\n\n### winget\n\nThe Windows package is also available to install with Windows Package Manager (winget)\n\n```\nwinget install timschneeb.GalaxyBudsClient\n```\n\n## How it works\n\nIn order to use Bluetooth wireless technology, a device must be able to interpret specific Bluetooth profiles that enable Bluetooth devices to communicate efficiently with each other.\n\nThe Galaxy Buds define two Bluetooth profiles: A2DP (Advanced Audio Distribution Profile) for audio streaming/controlling and SPP (Serial Port Profile) for transmitting binary streams. 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.\n\nEven though the A2DP profile is standardized and documented, the format of the binary data exchanged by this RFCOMM protocol is usually proprietary.\n\nTo reverse-engineer this data format, I started by analyzing the structure of the binary stream sent by the earbuds. Later on, I also disassembled the official Galaxy Buds apps for Android to gain more insight into these devices' inner workings. You can find some (incomplete) notes I took down below. Check the source code to get more detailed information on the structure of the protocol.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/timschneeb/GalaxyBudsClient/blob/master/GalaxyBudsRFCommProtocol.md\"\u003eGalaxy Buds (2019) Notes\u003c/a\u003e •\n  \u003ca href=\"https://github.com/timschneeb/GalaxyBudsClient/blob/master/Galaxy%20Buds%20Plus%20RFComm%20Protocol%20Notes.md\"\u003eGalaxy Buds Plus Notes\u003c/a\u003e\n\u003c/p\u003e\n\nWhile 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:\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/timschneeb/GalaxyBudsClient/blob/master/GalaxyBudsPlus_HiddenDebugFeatures.md\"\u003eGalaxy Buds Plus: Unusual features\u003c/a\u003e\n\u003c/p\u003e\n\nCurrently, I'm looking into modifying and reverse-engineering the firmware for the Buds+. At time of writing I have created two tools to fetch and analyze official firmware binaries. Check them out here:\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/timschneeb/GalaxyBudsFirmwareDownloader\"\u003eFirmware Downloader\u003c/a\u003e •\n  \u003ca href=\"https://github.com/timschneeb/GalaxyBudsFirmwareExtractor\"\u003eFirmware Extractor\u003c/a\u003e\n\u003c/p\u003e\n\nStream head-tracking data in realtime from your Buds Pro using this script: [timschneeb/BudsPro-Headtracking](https://github.com/timschneeb/BudsPro-Headtracking)\n\n## Contributing\n\nFeature requests, bug reports, and pull requests of any kind are always welcome.\n\nIf you want to report bugs or propose your ideas for this project, you are welcome to [open a new issue](https://github.com/timschneeb/GalaxyBudsClient/issues/new/choose) with a suitable template. [Visit our wiki](https://github.com/timschneeb/GalaxyBudsClient/wiki/2.-How-to-submit-issues) for a detailed explanation.\n\nIf you are planning to help us translate this app, [refer to the instructions on our wiki](https://github.com/timschneeb/GalaxyBudsClient/wiki/3.-How-to-help-with-translations). No programming knowledge is required, you can test your custom translations without installing any development tools before submitting a pull request.\nYou can find auto-generated progress reports for existing translations [here](https://github.com/timschneeb/GalaxyBudsClient/blob/master/meta/translations.md).\n\nIf 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](https://t.me/thepbone)) before starting to work on it.\n\n## Credits\n\n### Contributors\n\n* [@nift4](https://github.com/nift4) - macOS support and bug fixes\n* [@ArthurWolfhound](https://github.com/ArthurWolfhound) - Issue templates, wiki and translations\n* [@AndriesK](https://github.com/AndriesK) - Buds Live bug fix\n* [@TheLastFrame](https://github.com/TheLastFrame) - Buds Pro icons\n* [@githubcatw](https://github.com/githubcatw) - Connection dialog base\n* [@GaryGadget9](https://github.com/GaryGadget9) - WinGet package\n* [@joscdk](https://github.com/joscdk) - AUR package\n\n### Translators\n\n* [@ArthurWolfhound](https://github.com/ArthurWolfhound) - Russian and Ukrainian translation\n* [@PlasticBrain](https://github.com/fhalfkg) - Korean and Japanese translation\n* [@cozyplanes](https://github.com/cozyplanes) - Korean translation\n* [@corydalis10](https://github.com/corydalis10) - Korean translation\n* [@erenbektas](https://github.com/erenbektas) and [@Eta06](https://github.com/Eta06)  - Turkish translation\n* [@kakkk](https://github.com/kakkk), [@KevinZonda](https://github.com/KevinZonda), * [@JuanFariasDev](https://github.com/juanfariasdev), [@ssenkrad](https://github.com/ssenkrad), [@pseudor](https://github.com/pseudor) and [@YexuanXiao](https://github.com/YexuanXiao) - Chinese translation\n* [@YiJhu](https://github.com/YiJhu) - Chinese-Traditional translation\n* [@efrenbg1](https://github.com/efrenbg1) and Andrew Gonza - Spanish translation\n* [@giovankabisano](https://github.com/giovankabisano) - Indonesian translation\n* [@lucasskluser](https://github.com/lucasskluser) and [@JuanFariasDev](https://github.com/juanfariasdev) - Portuguese translation\n* [@alb-p](https://github.com/alb-p), [@mario-donnarumma](https://github.com/mario-donnarumma) - Italian translation\n* [@Buashei](https://github.com/Buashei) - Polish translation\n* [@KatJillianne](https://github.com/KatJillianne) and [@thelegendaryjohn](https://github.com/thelegendaryjohn) - Vietnamese translation\n* [@joskaja](https://github.com/joskaja) and [@Joedmin](https://github.com/Joedmin) - Czech translation\n* [@Benni0109](https://github.com/Benni0109), [@TheLastFrame](https://github.com/TheLastFrame), [@timschneeb](https://github.com/timschneeb) - German translation\n* [@nikossyr](https://github.com/nikossyr) - Greek translation\n* [@grigorem](https://github.com/grigorem) - Romanian translation\n* [@tretre91](https://github.com/tretre91) - French translation\n* [@Sigarya](https://github.com/Sigarya) - Hebrew translation\n* [@domroaft](https://github.com/domroaft) - Hungarian translation\n* [@lampi8426](https://github.com/lampi8426) - Dutch translation\n\n### Services\n\n* [Cloudflare](https://www.cloudflare.com/) - Secures the backend APIs of GalaxyBudsClient and provided a Pro license\n\n### Assets\n* Earbud asset used in the Android icon created by [Archival](https://www.flaticon.com/authors/archival) from [Flaticon](https://www.flaticon.com/)\n\n## License\n\nThis project is licensed under [GPLv3](https://github.com/timschneeb/GalaxyBudsClient/blob/master/LICENSE). It is not affiliated with Samsung nor supervised by them in any way.\n\n```\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,\nINCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.\nIN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\nWHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR\nTHE USE OR OTHER DEALINGS IN THE SOFTWARE.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimschneeb%2Fgalaxybudsclient","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimschneeb%2Fgalaxybudsclient","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimschneeb%2Fgalaxybudsclient/lists"}