1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
|
.. _installing:
Installing PyBluez
==================
PyBluez can be installed on GNU/Linux, Windows and macOS systems and is compatible
with Python 2.7 and 3.
.. 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 <https://www.lfd.uci.edu/~gohlke/pythonlibs/#pybluez>`_)
For experimental Bluetooth Low Energy support (only for Linux platform -
for additional dependencies please take look at:
`ble-dependencies <https://bitbucket.org/OscarAcena/pygattlib/src/45e04060881a20189412681f52d55ff5add9f388/DEPENDS?at=default>`_)
::
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.
+------+------+----------------+
| master.zip_ | master.tar.gz_ |
+------+------+----------------+
.. _master.zip: https://github.com/pybluez/pybluez/archive/master.zip
.. _master.tar.gz: https://github.com/pybluez/pybluez/archive/master.tar.gz
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 2.7 or more recent version
- Python distutils (standard in most Python distros, separate package python-dev in Debian)
- BlueZ libraries and header files
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)
.. note:: Windows 10 users need to download and install the `Windows 10 SDK <https://developer.microsoft.com/en-us/windows/downloads/windows-10-sdk>`_
`More details here <https://wiki.python.org/moin/WindowsCompilers>`_
- Widcomm BTW development kit 5.0 or later (Optional)
macOS Dependencies
""""""""""""""""""
- Xcode
- PyObjc 3.1b or later (https://pythonhosted.org/pyobjc/install.html#manual-installation)
|
