OpenFreebuds

Desktop application to manage wireless headphones from HUAWEI/Honor

💿 Download binaries | ❓ FAQ | 🌍 Suggest translation

This application allows to control HUAWEI FreeBuds earphone settings from PC. Check exact battery level, toggle noise cancellation, control built-in equalizer, change gestures, and all other in-device settings and features are now available without official mobile application.

• Dynamic system tray icon that shows current active noise cancellation mode and battery level;
• Tray menu with battery levels and active noise cancellation settings;
• Ability to change voice language (not all devices supported);
• Device settings dialog, eg. change equalizer preset, gesture actions, etc;
• Built-in HTTP-server for remote control & scripting;
• Built-in global hotkeys support (for Windows and Xorg-Linux)

See device page to get information about supported features. If your device isn't listed here, you could try to use it with profile for other model.

• HUAWEI FreeBuds 4i
  • HONOR Earbuds 2 is same
• HUAWEI FreeBuds 5i
• HUAWEI FreeBuds Pro
• HUAWEI FreeBuds Pro 2
• HUAWEI FreeBuds Pro 3
• HUAWEI FreeBuds SE
• HUAWEI FreeLace Pro
• HUAWEI FreeLace Pro 2

May also work with newer/older devices in same series. If you want to get better compatibility of some model, you could create Bluetooth traffic dump to help making OpenFreebuds better.

• Windows: Download here.
• Debian/Ubuntu:

curl -s https://deb.mmk.pw/setup | sudo bash -
sudo apt install openfreebuds

• Arch Linux: openfreebuds available in AUR.
• Flatpak: Coming soon

Most recent dev-binaries can be found in GitHub Actions build artifacts.

Requirements:

• Windows 10/11, or enough modern Linux;
• Qt 6.0 development tools, at least Linguist's lrelease;
• Python (3.11 ), Poetry (1.8 );
• (Windows, optional) NSIS, UPX;
• (Linux, optional) Build essentials and some libraries.

Also, some dev-scripts may have their own requirements, like python3-polib for ./scripts/sync_translations.sh. Setup poetry env and dependencies before continue:

poetry install

# Compile Qt Designer & Linguist sources
./scripts/make_qt_parts.sh

# Launch
poetry run python -m openfreebuds_qt -vcs

# use --help for options description

If everything above is installed & added to PATH, just run:

.\scripts\build_win32\make.cmd

Output binaries will be located in scripts\build_win32\dist

Install all packaging dependencies automated way: apt install build-essentials && ./scripts/install_dpkg_dependencies.sh.

Go to scripts/build_debian and run build script:

cd scripts/build_debian
./build.sh