Metadata-Version: 2.1
Name: bluetooth-battery
Version: 1.3.1
Summary: A python script to get battery level from Bluetooth headsets
Home-page: https://github.com/TheWeirdDev/Bluetooth_Headset_Battery_Level
Author: TheWeirdDev
Author-email: alireza6677@gmail.com
License: GPL-3.0
Download-URL: https://github.com/TheWeirdDev/Bluetooth_Headset_Battery_Level/archive/v1.3.1.zip
Keywords: bluetooth,bluetooth-headsets,bluetooth-devices,battery-level,battery-percentage,battery,headset,linux,socket,python,at-command,bluetooth-socket,bluetooth-speaker,bluez,headphones,bluetooth-headphones,python-script
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3 :: Only
Description-Content-Type: text/markdown

# 🔋🎧 Bluetooth Headset Battery Level

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.

# ▶️ How to run

```bash
pip3 install bluetooth_battery

bluetooth_battery BT_MAC_ADDRESS_1 ...
```

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

### It didn't work?

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.

### Still doesn't work?

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.

## Tested on

- [x] Linux (ArchLinux 5.6.14)

# 📜 License

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


