Skip to content


Repository files navigation

⛔️ This project is not under development

Consider some alternatives:

  • Bleak: Cross-platform Bluetooth Low Energy client library
  • Bless: Cross-platform Bluetooth Low Energy server library
  • PyQt: Python bindings for cross-platform QtBluetooth API


Build Status

The PyBluez module allows Python code to access the host machine's Bluetooth resources.

Platform Support

Linux Raspberry Pi macOS Windows
✔️ ✔️ ✔️ ✔️

Python Version Support

Python 2 Python 3 (min 3.5)
Till Version 0.22 Version 0.23 and newer


# simple inquiry example
import bluetooth

nearby_devices = bluetooth.discover_devices(lookup_names=True)
print("Found {} devices.".format(len(nearby_devices)))

for addr, name in nearby_devices:
    print("  {} - {}".format(addr, name))
# bluetooth low energy scan
from bluetooth.ble import DiscoveryService

service = DiscoveryService()
devices =

for address, name in devices.items():
    print("name: {}, address: {}".format(name, address))

GNU/Linux and Windows XP examples:

GNU/Linux only examples:

GNU/Linux experimental BLE support:


Please file bugs to the issue tracker. Questions can be asked on the mailing list hosted on Google Groups, but unfortunately it is not very active.


Please refer to the installation instructions.


PyBluez is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

PyBluez is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with PyBluez; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA