Installing PyBluez

PyBluez can be installed on GNU/Linux, Windows and macOS systems.

Note

Before you install PyBluez please install the dependencies required for your system as described in the sections below.

Installing PyBluez using pip

Open a terminal (command prompt on Windows) and enter

pip install pybluez

(there are also binaries for Windows platform on PyPI or here - Unofficial Windows Binaries for Python Extension Packages)

For experimental Bluetooth Low Energy support (only for Linux platform - for additional dependencies please take look at: ble-dependencies)

pip install pybluez[ble]

Installing PyBluez from source

or download the latest version using the links below.

Extract the zip or tar and cd to the extracted file directory, then:

python setup.py install

for Bluetooth Low Energy support (GNU/Linux only):

pip install -e .[ble]

GNU/Linux Dependencies

Python 3.5 or newer
Python distutils (standard in most Python distros, separate package python-dev in Debian)
BlueZ libraries and header files

PyBluez requires a C++ compiler installed on your system to build CPython modules.

For Python 3.5 or higher

Microsoft Visual C++ 14.0 standalone: Build Tools for Visual Studio 2017 (x86, x64, ARM, ARM64)
Microsoft Visual C++ 14.0 with Visual Studio 2017 (x86, x64, ARM, ARM64)
Microsoft Visual C++ 14.0 standalone: Visual C++ Build Tools 2015 (x86, x64, ARM)
Microsoft Visual C++ 14.0 with Visual Studio 2015 (x86, x64, ARM)

Note

Windows 10 users need to download and install the Windows 10 SDK