GalaxyBudsClient Versions Save

Unofficial Galaxy Buds Manager for Windows, macOS, and Linux

4.6.0

1 month ago

SmartScreen & Gatekeeper notice

The current Windows installer may trigger a SmartScreen ('unrecognized developer') warning on some systems, because I'm publishing these installers as unsigned binaries. The macOS installer warns you that "macOS cannot verify that this app is free from malware" because there is no Apple Developer ID associated with the project, and hence there is no code signing certificate.

Unfortunately, using a proper code signing certificate for Windows or macOS is not an option since I cannot afford recurring monthly payments for an open-source app with zero budget.

What's new

macOS port

Thanks to @nift4, the macOS port has been finalized and is available for download below. Both Intel and newer ARM macOS devices are supported.

Hotkey support for Linux

The Linux version now supports global hotkey actions on X11.

This feature has no effect on Wayland, as their protocols do not support global hotkeys by design. As a workaround, you could manually set-up hotkeys in your desktop environment using the new command-line interface.

Basic command-line interface and D-Bus IPC

The app can now be controlled by CLI operations which allows for scripting possibilities. At the moment, only basic operations are available, such as:

  • Trigger actions such as toggling the ANC/ambient mode, the 'find my buds' feature, and more.
  • List device properties, such as battery levels, wear states, version information and more.
  • Trigger the battery info popup
  • Bring the application window to the foreground
Example commands (click to expand)

Print current device status as JSON: ./GalaxyBudsClient device --get-all --json

{
  "Name": "Galaxy Buds Pro (2B00)",
  "Address": "64:03:7F:2E:00:00",
  "Model": "BudsPro",
  "BatteryLeft": 67,
  "BatteryRight": 76,
  "BatteryCase": 101,
  "VoltageLeft": 3.86,
  "VoltageRight": 3.9,
  "ThermistorLeftCelsius": 34.1,
  "ThermistorRightCelsius": 36.0,
  "WearStateLeft": "Wearing",
  "WearStateRight": "Wearing",
  "FirmwareVersion": "R190XXU0AVF1",
  "HardwareVersion": "rev0.2",
  "SkuLeft": "SM-R190NZKAEUD",
  "SkuRight": "SM-R190NZKAEUD"
}

Toggle ANC: ./GalaxyBudsClient action -e AncToggle

You can invoke the CLI usage help by adding the --help parameter.

D-Bus IPC

Third-party scripts and apps can also connect to the D-Bus IPC service (me.timschneeberger.galaxybudsclient), which provides similar integrations.

On Linux, the service is registered on the system's session bus. On other platforms, a custom D-Bus server will be hosted on the TCP port 54533.

You can use introspection tools such as qdbusviewer or d-spy if you want to experiment with the exposed APIs.

Other new features

  • Galaxy Buds FE support (although mostly untested)
  • Implemented new Buds2 features, including the earbud fit test by @nift4 in https://github.com/ThePBone/GalaxyBudsClient/pull/465
  • Dynamic tray icons
  • Connection popup: show the real device name in the title
  • Added additional safeguards to the firmware installer to prevent users from installing firmware for the wrong device model
  • Localization support for RTL languages
  • Linux: auto-start support (except flatpak packages)

Bug fixes

Other changes

Translation updates

New Contributors


Note to Linux users

  • x86_64-musl binaries are only compatible with libc-musl based distributions (e.g., Alpine Linux).
  • You need to give the binary execute permissions before launching it: chmod +x GalaxyBudsClient

Privacy

  • This application collects crash dumps in case of fatal application crashes and sends them to my sentry.io dashboard (can be disabled in settings).
  • To help me support Buds models I don't own, this app includes a crowdsourcing feature to share data about Samsung's proprietary Bluetooth serial protocol on demand. You can disable this permanently by navigating to 'Settings > Crowdsourcing'.

Q: How to fix connection issues (on Windows)

A: If you experience issues while connecting or using the Galaxy Buds with this app, you can do the following:

  1. Unregister your earbuds in the app if not already done, like this: Options > Unregister device
  2. Proceed to the device selection page
  3. Disable the switch with the label 'Use alternative Bluetooth backend' (Windows only)
  4. Select your earbuds from the list and continue

Thank you for 3000+ stars on GitHub!

Full Changelog: https://github.com/ThePBone/GalaxyBudsClient/compare/4.5.4...4.6.0

4.5.4

5 months ago

SmartScreen notice

The current Windows installer seems to trigger a SmartScreen ('unrecognized developer') warning on some systems, most likely because I'm publishing these installers as unsigned binaries. Unfortunately, using a proper code signing certificate is not an option since I cannot afford recurring monthly payments for an open-source app with zero budget.

What's Changed

Translations


Note to Linux users

  • x86_64-musl binaries are only compatible with libc-musl based distributions (e.g., Alpine Linux).
  • You need to give the binary execute permissions before launching it: chmod +x GalaxyBudsClient
  • If your system language is set to a language that has non-Latin characters (Korean, Japanese, Chinese), you need to start the app like this: LC_ALL=C ./GalaxyBudsClient (temporary workaround)

Privacy

  • This application collects crash dumps in case of fatal application crashes and sends them to my sentry.io dashboard (can be disabled in settings).
  • To help me support Buds models I don't own, this app includes a crowdsourcing feature to share data about Samsung's proprietary Bluetooth serial protocol on demand. You can disable this permanently by navigating to 'Settings > Crowdsourcing'.

Q: How to fix connection issues (on Windows)

A: If you experience issues while connecting or using the Galaxy Buds with this app, you can do the following:

  1. Unregister your earbuds in the app if not already done, like this: Options > Unregister device
  2. Proceed to the device selection page
  3. Disable the switch with the label 'Use alternative Bluetooth backend' (Windows only)
  4. Select your earbuds from the list and continue

Thank you for 2800+ stars on GitHub!

4.5.3

1 year ago

All Galaxy Buds models are supported!

SmartScreen notice

The current Windows installer seems to trigger a SmartScreen ('unrecognized developer') warning on some systems, most likely because I'm publishing these installers as unsigned binaries. Unfortunately, using a proper code signing certificate is not an option since I cannot afford recurring monthly payments for an open-source app with zero budget.

What's Changed (v4.5.3-beta)

  • Support for Buds Pro 2

Note: This is a beta release; downgrade to v4.5.2 if you notice any breaking bugs

What's Changed (v4.5.2)

  • Hotfix: Support for devices with personalized names

What's Changed (v4.5.1)

  • Linux: Native tray icon support
  • Hotfix: Accidentally leftover debug code in v4.5.0 suppressed all disconnect/error events and made it impossible to reconnect once disconnected
  • Upgrade to .NET 6
  • DevTools: Auto-scroll binary dump and message list
  • Linux: Override Bluetooth adapter using an environment variable (e.g. BT_ADAPTER=hci0)
  • Fixed crash in WelcomePage

Translation updates


Note to Linux users

  • x86_64-musl binaries are only compatible with libc-musl based distributions (e.g., Alpine Linux).
  • You need to give the binary execute permissions before launching it: chmod +x GalaxyBudsClient
  • If your system language is set to a language that has non-Latin characters (Korean, Japanese, Chinese), you need to start the app like this: LC_ALL=C ./GalaxyBudsClient (temporary workaround)

Privacy

  • This application collects crash dumps in case of fatal application crashes and sends them to my sentry.io dashboard (can be disabled in settings).
  • To help me support Buds models I don't own, this app includes a crowdsourcing feature to share data about Samsung's proprietary Bluetooth serial protocol on demand. You can disable this permanently by navigating to 'Settings > Developer options'.

Q: How to fix connection issues

A: If you experience issues while connecting or using the Galaxy Buds with this app, you can do the following:

  1. Unregister your earbuds in the app if not already done, like this: Options > Unregister device
  2. Proceed to the device selection page
  3. Disable the switch with the label 'Use alternative Bluetooth backend' (Windows only)
  4. Select your earbuds from the list and continue

Thank you for 2400+ stars on GitHub!

4.5.2

1 year ago

All Galaxy Buds models are supported!

SmartScreen notice

The current Windows installer seems to trigger a SmartScreen ('unrecognized developer') warning on some systems, most likely because I'm publishing these installers as unsigned binaries. Unfortunately, using a proper code signing certificate is not an option since I cannot afford recurring monthly payments for an open-source app with zero budget.

What's Changed (v4.5.2)

  • Hotfix: Support for devices with personalized names

What's Changed (v4.5.1)

  • Linux: Native tray icon support
  • Hotfix: Accidentally leftover debug code in v4.5.0 suppressed all disconnect/error events and made it impossible to reconnect once disconnected
  • Upgrade to .NET 6
  • DevTools: Auto-scroll binary dump and message list
  • Linux: Override Bluetooth adapter using an environment variable (e.g. BT_ADAPTER=hci0)
  • Fixed crash in WelcomePage

Translation updates


Note to Linux users

  • x86_64-musl binaries are only compatible with libc-musl based distributions (e.g., Alpine Linux).
  • You need to give the binary execute permissions before launching it: chmod +x GalaxyBudsClient
  • If your system language is set to a language that has non-Latin characters (Korean, Japanese, Chinese), you need to start the app like this: LC_ALL=C ./GalaxyBudsClient (temporary workaround)

Privacy

  • This application collects crash dumps in case of fatal application crashes and sends them to my sentry.io dashboard (can be disabled in settings).
  • To help me support Buds models I don't own, this app includes a crowdsourcing feature to share data about Samsung's proprietary Bluetooth serial protocol on demand. You can disable this permanently by navigating to 'Settings > Developer options'.

Q: How to fix connection issues

A: If you experience issues while connecting or using the Galaxy Buds with this app, you can do the following:

  1. Unregister your earbuds in the app if not already done, like this: Options > Unregister device
  2. Proceed to the device selection page
  3. Disable the switch with the label 'Use alternative Bluetooth backend' (Windows only)
  4. Select your earbuds from the list and continue

Thank you for 1800+ stars on GitHub!

4.5.1

1 year ago

All Galaxy Buds models are supported!

SmartScreen notice

The current Windows installer seems to trigger a SmartScreen ('unrecognized developer') warning on some systems, most likely because I'm publishing these installers as unsigned binaries. Unfortunately, using a proper code signing certificate is not an option since I cannot afford recurring monthly payments for an open-source app with zero budget.

What's Changed

  • Linux: Native tray icon support
  • Hotfix: Accidentally leftover debug code in v4.5.0 suppressed all disconnect/error events and made it impossible to reconnect once disconnected
  • Upgrade to .NET 6
  • DevTools: Auto-scroll binary dump and message list
  • Linux: Override Bluetooth adapter using an environment variable (e.g. BT_ADAPTER=hci0)
  • Fixed crash in WelcomePage

Translation updates


Note to Linux users

  • x86_64-musl binaries are only compatible with libc-musl based distributions (e.g., Alpine Linux).
  • You need to give the binary execute permissions before launching it: chmod +x GalaxyBudsClient
  • If your system language is set to a language that has non-Latin characters (Korean, Japanese, Chinese), you need to start the app like this: LC_ALL=C ./GalaxyBudsClient (temporary workaround)

Privacy

  • This application collects crash dumps in case of fatal application crashes and sends them to my sentry.io dashboard (can be disabled in settings).
  • To help me support Buds models I don't own, this app includes a crowdsourcing feature to share data about Samsung's proprietary Bluetooth serial protocol on demand. You can disable this permanently by navigating to 'Settings > Developer options'.

Q: How to fix connection issues

A: If you experience issues while connecting or using the Galaxy Buds with this app, you can do the following:

  1. Unregister your earbuds in the app if not already done, like this: Options > Unregister device
  2. Proceed to the device selection page
  3. Disable the switch with the label 'Use alternative Bluetooth backend' (Windows only)
  4. Select your earbuds from the list and continue

Thank you for 1700+ stars on GitHub!

4.4.1

2 years ago

All Galaxy Buds models are supported!

SmartScreen notice: The current Windows installer seems to trigger a SmartScreen ('unrecognized developer') warning on some systems, most likely because I'm publishing these installers as unsigned binaries. Unfortunately, using a proper code signing certificate is not an option since I cannot afford recurring monthly payments for an open-source app with zero budget.

Please keep your firmware updated. Concerning the Buds, Buds+, and Buds Live: very old firmware versions such as R175XXU0ASLE can cause crashes and are not properly supported. However, this app will support all Buds Pro firmware versions available to end users from launch.

Changelog v4.4.1

  • Emergency patch for Buds2 users

Changelog v4.4

  • Better Buds2 support
    • Enable/disable single/double/triple/long touch actions
  • Buds2 and Pro: Support for ambient sound customization feature
  • Inform user about possible Bluetooth connection conflicts if the official app is installed (@githubcatw)

Bug fixes

  • Fixed various issues with the Buds2

Translation updates

  • Added Chinese-Traditional translation (@YiJhu )
  • Updated Chinese translation (@YexuanXiao)

Note to Linux users

  • x86_64-musl binaries are only compatible with libc-musl based distributions (e.g., Alpine Linux).
  • You need to give the binary execute permissions before launching it: chmod +x GalaxyBudsClient
  • Proprietary NVIDIA drivers may cause crashes on some Linux systems (feel free to open an issue, I need to collect information)
  • If your system language is set to a language that has non-Latin characters (Korean, Japanese, Chinese), you need to start the app like this: LC_ALL=C ./GalaxyBudsClient (temporary workaround)

Privacy

  • This application collects crash dumps in case of fatal application crashes and sends them to my sentry.io dashboard.
  • To help me support Buds models I don't own, this app includes a crowdsourcing feature to share data about Samsung's proprietary Bluetooth serial protocol on demand. You can disable this permanently by navigating to 'Settings > Developer options'.

Other notes

  • The first launch (or after updating) always takes a few seconds longer.

Q: How to fix connection issues

A: If you experience issues while connecting or using the Galaxy Buds with this app, you can do the following:

  1. Unregister your earbuds in the app if not already done, like this: Options > Unregister device
  2. Proceed to the device selection page
  3. Disable the switch with the label 'Use alternative Bluetooth backend'
  4. Select your earbuds from the list and continue

Q: The app does not launch

A: If you are on Windows, please (re-)install the latest version of the Microsoft .NET Framework Runtime.


Thank you for 1300+ stars on GitHub!

4.4

2 years ago

All Galaxy Buds models are supported!

SmartScreen notice: The current Windows installer seems to trigger a SmartScreen ('unrecognized developer') warning on some systems, most likely because I'm publishing these installers as unsigned binaries. Unfortunately, using a proper code signing certificate is not an option since I cannot afford recurring monthly payments for an open-source app with zero budget.

Please keep your firmware updated. Concerning the Buds, Buds+, and Buds Live: very old firmware versions such as R175XXU0ASLE can cause crashes and are not properly supported. However, this app will support all Buds Pro firmware versions available to end users from launch.

Changelog v4.4

  • Better Buds2 support
    • Enable/disable single/double/triple/long touch actions
  • Buds2 and Pro: Support for ambient sound customization feature
  • Inform user about possible Bluetooth connection conflicts if the official app is installed (@githubcatw)

Bug fixes

  • Fixed various issues with the Buds2

Translation updates

  • Added Chinese-Traditional translation (@YiJhu )
  • Updated Chinese translation (@YexuanXiao)

Note to Linux users

  • x86_64-musl binaries are only compatible with libc-musl based distributions (e.g., Alpine Linux).
  • You need to give the binary execute permissions before launching it: chmod +x GalaxyBudsClient
  • Proprietary NVIDIA drivers may cause crashes on some Linux systems (feel free to open an issue, I need to collect information)
  • If your system language is set to a language that has non-Latin characters (Korean, Japanese, Chinese), you need to start the app like this: LC_ALL=C ./GalaxyBudsClient (temporary workaround)

Privacy

  • This application collects crash dumps in case of fatal application crashes and sends them to my sentry.io dashboard.
  • To help me support Buds models I don't own, this app includes a crowdsourcing feature to share data about Samsung's proprietary Bluetooth serial protocol on demand. You can disable this permanently by navigating to 'Settings > Developer options'.

Other notes

  • The first launch (or after updating) always takes a few seconds longer.

Q: How to fix connection issues

A: If you experience issues while connecting or using the Galaxy Buds with this app, you can do the following:

  1. Unregister your earbuds in the app if not already done, like this: Options > Unregister device
  2. Proceed to the device selection page
  3. Disable the switch with the label 'Use alternative Bluetooth backend'
  4. Select your earbuds from the list and continue

Q: The app does not launch

A: If you are on Windows, please (re-)install the latest version of the Microsoft .NET Framework Runtime.


Thank you for 1300+ stars on GitHub!

4.3.1

2 years ago

All Galaxy Buds models are supported!

SmartScreen notice: The current Windows installer seems to trigger a SmartScreen ('unrecognized developer') warning on some systems, most likely because I'm publishing these installers as unsigned binaries. Unfortunately, using a proper code signing certificate is not an option since I cannot afford recurring monthly payments for an open-source app with zero budget.

Please keep your firmware updated. Concerning the Buds, Buds+, and Buds Live: very old firmware versions such as R175XXU0ASLE can cause crashes and are not properly supported. However, this app will support all Buds Pro firmware versions available to end users from launch.

Changelog v4.3.1

  • Bugfix: Hide terminal debug window

Changelog v4.3

  • Buds2 support

Bug fixes

  • Firmware update transfer with very slow Bluetooth hardware doesn't timeout anymore
  • Fixed various graphical glitches

Translation updates

  • Added Hebrew translation (@Sigarya)
  • Updated Czech translation (@Joedmin)

Note to Linux users

  • x86_64-musl binaries are only compatible with libc-musl based distributions (e.g., Alpine Linux).
  • You need to give the binary execute permissions before launching it: chmod +x GalaxyBudsClient
  • Proprietary NVIDIA drivers may cause crashes on some Linux systems (feel free to open an issue, I need to collect information)
  • If your system language is set to a language that has non-Latin characters (Korean, Japanese, Chinese), you need to start the app like this: LC_ALL=C ./GalaxyBudsClient (temporary workaround)

Privacy

  • This application collects crash dumps in case of fatal application crashes and sends them to my sentry.io dashboard.
  • To help me support Buds models I don't own, this app includes a crowdsourcing feature to share data about Samsung's proprietary Bluetooth serial protocol on demand. You can disable this permanently by navigating to 'Settings > Developer options'.

Other notes

  • The first launch (or after updating) always takes a few seconds longer.

Q: How to fix connection issues

A: If you experience issues while connecting or using the Galaxy Buds with this app, you can do the following:

  1. Unregister your earbuds in the app if not already done, like this: Options > Unregister device
  2. Proceed to the device selection page
  3. Disable the switch with the label 'Use alternative Bluetooth backend'
  4. Select your earbuds from the list and continue

Q: The app does not launch

A: If you are on Windows, please (re-)install the latest version of the Microsoft .NET Framework Runtime.


Thank you for 1200+ stars on GitHub!

4.3

2 years ago

All Galaxy Buds models are supported!

SmartScreen notice: The current Windows installer seems to trigger a SmartScreen ('unrecognized developer') warning on some systems, most likely because I'm publishing these installers as unsigned binaries. Unfortunately, using a proper code signing certificate is not an option since I cannot afford recurring monthly payments for an open-source app with zero budget.

Please keep your firmware updated. Concerning the Buds, Buds+, and Buds Live: very old firmware versions such as R175XXU0ASLE can cause crashes and are not properly supported. However, this app will support all Buds Pro firmware versions available to end users from launch.

Changelog v4.3

  • Experimental Buds2 support

Bug fixes

  • Firmware update transfer with very slow Bluetooth hardware doesn't timeout anymore
  • Fixed various graphical glitches

Translation updates

  • Added Hebrew translation (@Sigarya)
  • Updated Czech translation (@Joedmin)

Note to Linux users

  • x86_64-musl binaries are only compatible with libc-musl based distributions (e.g., Alpine Linux).
  • You need to give the binary execute permissions before launching it: chmod +x GalaxyBudsClient
  • Proprietary NVIDIA drivers may cause crashes on some Linux systems (feel free to open an issue, I need to collect information)
  • If your system language is set to a language that has non-Latin characters (Korean, Japanese, Chinese), you need to start the app like this: LC_ALL=C ./GalaxyBudsClient (temporary workaround)

Privacy

  • This application collects crash dumps in case of fatal application crashes and sends them to my sentry.io dashboard.
  • To help me support Buds models I don't own, this app includes a crowdsourcing feature to share data about Samsung's proprietary Bluetooth serial protocol on demand. You can disable this permanently by navigating to 'Settings > Developer options'.

Other notes

  • The first launch (or after updating) always takes a few seconds longer.

Q: How to fix connection issues

A: If you experience issues while connecting or using the Galaxy Buds with this app, you can do the following:

  1. Unregister your earbuds in the app if not already done, like this: Options > Unregister device
  2. Proceed to the device selection page
  3. Disable the switch with the label 'Use alternative Bluetooth backend'
  4. Select your earbuds from the list and continue

Q: The app does not launch

A: If you are on Windows, please (re-)install the latest version of the Microsoft .NET Framework Runtime.


Thank you for 1200+ stars on GitHub!

4.2.1

2 years ago

All Galaxy Buds models are supported!

SmartScreen notice: The current Windows installer seems to trigger a SmartScreen ('unrecognized developer') warning on some systems, most likely because I'm publishing these installers as unsigned binaries. Unfortunately, using a proper code signing certificate is not an option since I cannot afford recurring monthly payments for an open-source app with zero budget.

Please keep your firmware updated. Concerning the Buds, Buds+, and Buds Live: very old firmware versions such as R175XXU0ASLE can cause crashes and are not properly supported. However, this app will support all Buds Pro firmware versions available to end users from launch.

Changelog v4.2.1

  • Buds Live: Enable firmware flashing tool (advanced users only; confirmed working by testers)
  • Optimized 'three-way switch' touch action behavior for noise control (Buds Pro)
  • New styling option 'Use different color when in case' for the connection popup

Bug fixes

  • Firmware flasher: detect and warn about internal beta firmware images (BCOM-header)
  • Fixed text-overflow in context-menus
  • Fixed high CPU usage on some Linux systems
  • Fixed installer issues

Translation updates

  • Added French translation (@tretre91)
  • Added Romanian translation (@grigorem)
  • Added Chinese translation (@YexuanXiao)
  • Updated Korean translation (@cozyplanes, @MareNectaris)
  • Updated Czech translation (@Joedmin)
  • Updated Russian translation (@ArthurWolfhound, @Braingines )
  • Updated Ukrainian translation (@ArthurWolfhound)

Note to Linux users

  • x86_64-musl binaries are only compatible with libc-musl based distributions (e.g., Alpine Linux).
  • You need to give the binary execute permissions before launching it: chmod +x GalaxyBudsClient
  • Proprietary NVIDIA drivers may cause crashes on some Linux systems (feel free to open an issue, I need to collect information)
  • If your system language is set to a language that has non-Latin characters (Korean, Japanese, Chinese), you need to start the app like this: LC_ALL=C ./GalaxyBudsClient (temporary workaround)

Privacy

  • This application collects crash dumps in case of fatal application crashes and sends them to my sentry.io dashboard.
  • To help me support Buds models I don't own, this app includes a crowdsourcing feature to share data about Samsung's proprietary Bluetooth serial protocol on demand. You can disable this permanently by navigating to 'Settings > Developer options'.

Other notes

  • The first launch (or after updating) always takes a few seconds longer.

Q: How to fix connection issues

A: If you experience issues while connecting or using the Galaxy Buds with this app, you can do the following:

  1. Unregister your earbuds in the app if not already done, like this: Options > Unregister device
  2. Proceed to the device selection page
  3. Disable the switch with the label 'Use alternative Bluetooth backend'
  4. Select your earbuds from the list and continue

Q: The app does not launch

A: If you are on Windows, please (re-)install the latest version of the Microsoft .NET Framework Runtime.


Thank you for 1100+ stars on GitHub!