Desktop application to manage wireless headphones from HUAWEI/Honor
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