1. Installing PyBluez¶
PyBluez can be installed on GNU/Linux, Windows and macOS systems and is compatible with Python 2.7 and 3.
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
Download a stable release from https://github.com/pybluez/pybluez/releases
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\]
1.1. GNU/Linux Dependencies¶
- Python 2.7 or more recent version
- Python distutils (standard in most Python distros, separate package python-dev in Debian)
- BlueZ libraries and header files
1.2. Windows Dependencies¶
- Windows 7/8/8.1/10
- Python 3.5 or more recent version
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)
Windows 10 users need to download and install the Windows 10 SDK
- Widcomm BTW development kit 5.0 or later (Optional)
1.3. macOS Dependencies¶
- PyObjc 3.1b or later (https://pythonhosted.org/pyobjc/install.html#manual-installation)