OpenFreebuds Desktop

Desktop application to manage your HUAWEI FreeBuds device. Written in Python, available for Windows and Linux.

• 💿 Download binaries
• 🌍 Translate to your language

Features:

• Toggle noise cancellation mode directly from PC
• Change device settings (like touch reactions)
• Hotkeys, web-server included
• Open source and free forever

Supported devices:

• HUAWEI FreeBuds 4i
• HONOR Earbuds 2 Lite

Installation

Windows, Debian: get binary packages here.

Arch Linux: available in AUR

Ubuntu 22.04-22.10:

sudo add-apt-repository ppa:melianmiko/software
sudo apt update
sudo apt install openfreebuds

Build from source code

Windows

Requirements:

• Windows 10/11, with Microsoft-compatible Bluetooth adapter
• Python 3.10-3.11 (NOT from Microsoft Store, don't forgot to set "Add to PATH" checkbox doing installation)
• NSIS (optional, for installer)
• UPX Packager (optional)

Grab sources from here, if you don't. Open PowerShell or Windows Terminal in this directory. Create venv and install python packages:

python -m venv venv
.\venv\Scripts\activate
pip install -r requirements.txt

Now, run pyinstaller to build an executable:

pyinstaller .\openfreebuds.spec

Optional, make an installer package:

& 'C:\Program Files (x86)\NSIS\Bin\makensis.exe' .\openfreebuds.nsi

Result files will appear in dist directory.

Linux

Install dependencies: Python3, Pip3, Python3 GObject bindings (gi), Python3 Tkinter, Python3 DBus, Python3 Pillow with ImageTk, Appindicator3 or AyatanaAppindicator3, Bluez sources (libbluetooth-dev), UPX (optional), Gtk3, Git, gcc, make

For Debian/Ubuntu:

sudo apt install make git gcc upx-ucl python3 python3-pip python3-wheel \
  python3-gi python3-tk python3-dbus python3-pil python3-pil.imagetk \
  gir1.2-appindicator3-0.1 | gir1.2-ayatanaappindicator3-0.1 \
  libgtk-3-0 libbluetooth-dev

Run from source code

python3-venv and build-essentials are required, also as big part of libraries listed above.

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python src/ofb_launcher.py

Install

Grab sources and run make:

git clone https://github.com/melianmiko/OpenFreebuds
cd OpenFreebuds
make
sudo make install # Install

Build debian package

dpkg-buildpackage -b # binary pkg
dpkg-buildpackage -S # source pkg

That's all.