OpenFreebuds

Desktop application to manage wireless headphones from HUAWEI/Honor

💿 Download binaries | ❓ FAQ

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.

Features

• 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)

Device compatibility

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 6i
• HUAWEI FreeBuds Pro
• HUAWEI FreeBuds Pro 2
• HUAWEI FreeBuds Pro 3
• HUAWEI FreeBuds SE
• HUAWEI FreeBuds Studio
• 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.

Download & install

Debian/Ubuntu

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

Arch Linux

openfreebuds available in AUR.

Test builds

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

Build or start from sources

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

Just launch without installation

./scripts/make.py build_launch

Windows

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

Debian/Ubuntu

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

dpkg-buildpackage -b

Output file will be located in parent folder (../*.deb).