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;
• Optional separate numeric tray icons for the left earbud, right earbud, and charging case;
• 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)

Battery tray indicators

Enable Application → Tray battery → Show battery percentages in the system tray to display each reported earbud/case level as a separate number, without a % sign. The indicators are disabled by default. Each indicator has independent text and background colors, optional transparency, Normal/Bold font weight (Bold by default), and text size from 50% to 100% of the largest size that fits its tray icon. The preview uses sample battery levels; changes are saved and applied immediately.

Hover over an indicator to identify the earbud or case. Left-click opens the settings window, and right-click opens the existing tray menu. Indicators hide when disconnected, disabled, or when their individual battery level is unavailable. Devices reporting only an aggregate battery level do not get additional indicators.

The desktop controls tray visibility and ordering. On Windows, indicators may initially appear in the hidden-icons (^) menu. The application creates them in left/right/case order, but cannot force their final position in the Windows tray.

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 3
• HUAWEI FreeBuds 4i
  • HONOR Earbuds 2 / 2 SE / 2 Lite is same
• HUAWEI FreeBuds 5i
• HUAWEI FreeBuds 6i
• HUAWEI FreeBuds Pro
• HUAWEI FreeBuds Pro 2
• HUAWEI FreeBuds Pro 3
  • HUAWEI FreeBuds Pro 4 is same
• HUAWEI FreeBuds SE
• HUAWEI FreeBuds SE 2
• HUAWEI FreeBuds SE 4 ANC
• HUAWEI FreeBuds Studio
• HUAWEI FreeClip
• HUAWEI FreeClip 2
• 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

Common installation options:

All installation options:

Platform	Package manager	Command / Link
Windows	Direct install	Website or releases
Windows¹	Winget (preinstalled)	winget install MelianMiko.OpenFreebuds
Windows¹	Scoop	scoop bucket add extras scoop install openfreebuds
Any linux	Flathub	flatpak install pw.mmk.OpenFreebuds
Debian/Ubuntu	APT	curl -s https://st.mmk.pw/debiansetup | sudo bash - sudo apt install openfreebuds
Fedora	DNF	sudo dnf config-manager addrepo \ --from-repofile https://st.mmk.pw/melianmiko.repo sudo dnf install openfreebuds
ArchLinux	Yay for AUR	yay -S openfreebuds
NixOS¹ 25.11+	NixPkgs	openfreebuds

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

¹community-maintained

Build from sources

Build dependencies

Windows 10/11:

• Just;
• Python (3.13+), PDM;
  • Do not Python from Microsoft Store;
• (optional) NSIS, UPX.

Linux:

• Just;
• Python (3.13+), PDM;
• Qt 6.0+ development tools, at least Linguist's lrelease.

macOS (experimental, tested only on Intel-based macOS):

• Python (3.13+), PDM;
  • PDM with python from website can be added via pip3 install -U pipx && python3 -m pipx install pdm && python3 -m pipx ensurepath;
  • For now, if using python from homebrew, you must symlink it to python since scripts doesn't use python3 command;
• Just (brew install just);
• Qt 6.0+ development tools, at least Linguist's lrelease (brew install qttools).

Prepare environment

1. Obtain dependencies: pdm install;
2. Try to run it: just start;
3. Make release binary:

• Windows: just win32;
• Linux: just debian fedora;
• macOS: just macos.