This is a python script to fetch the battery charge level of some Bluetooth headsets.

You need python 3.6 or newer to run the script.

Please ensure you have the BlueZ and python libraries and header files if you are using Ubuntu/Debian based distros:

sudo apt install libbluetooth-dev python3-dev

Then, install with pip:

pip3 install bluetooth_battery

bluetooth_battery BT_MAC_ADDRESS_1 ...

the dependency pybluez should be installed automatically, but if not, you may need to install it manually

chmod +x bluetooth_battery.py

./bluetooth_battery.py BT_MAC_ADDRESS_1 ...

make sure you have python-pybluez or python3-pybluez or python3-bluez installed on your system.

You can input addresses for as many devices as you want separated by space.

You can set the port number manually by adding a dot at the end of mac address, like this: 00:00:00:00:00:00.3

Try port numbers 1 to 30 to find the one that works for your device. (wait a few seconds between each try)

If that didn't work, disconnect your device first, and then try again.

Please consider that this script doesn't guarantee to support every bluetooth device.

You can open a new issue for discussion or check the existing ones for more information.

• Linux (ArchLinux 5.6.14)

You can donate if you like this project :)

BTC: 1KXJPJSmXUocieC3neRZEDakpzfcyumLqS

BCH: qzzmzegfy76r5glpj26jzq2xly2cczsmfyrn66ax8q

ETH: 0xb6178080c8f0792e6370959909199647e26b8457

Thank you!

Special thanks to:

@clst: For spreading the word!

@bhepple: For his research on fixing the ultimate bug

@balsoft: For thinking outside the box (finding my big mistake)

@martin-beran: For making it easy to set the port number

@Bobo1239: For adding support for Samsung galaxy buds

@keystroke3: For adding multiple device support to the script

❤️ And everyone else that pointed out the issues or helped me with writing the code or testing it.

This project is a free software licensed under GPL-3.0 or newer.