ORG PyBluez

PyBluez

Main
Documentation
Download
Links

Requirements

GNU/Linux:

bluez-libs 2.10 or greater
Python 2.3 or more recent version

Windows XP:

Service Pack 2
Python 2.3 or more recent version
Microsoft Bluetooth stack or Widcomm/Broadcom Bluetooth stack

Installation

Windows users can download and run the executable installer.

Debian/Ubuntu users can apt-get install python-bluetooth

Fedora users can yum install pybluez

Otherwise, check your OS distribution for packages, or download the latest release and untar it.

Then, in a shell, wherever you unpacked the tarball,

# python setup.py install

Examples

There are a few examples included with the source distribution. Most are simple and straightforward. One of them (bluezchat) requires that python gtk2 and glade2 bindings be installed. Here are a few of the simple examples.

inquiry.py - Detecting nearby Bluetooth devices
sdp-browse.py - Browsing SDP services on a Bluetooth device
rfcomm-server.py | rfcomm-client.py - establishing an RFCOMM connection.

API Documentation

API Documentation for PyBluez 0.7

Programming with PyBluez

If you've done any sort of socket programming before at all, you should find it pretty easy to get started with PyBluez, as we tried to stick pretty close to the Python Socket module.

To communicate with another bluetooth device, you simply create a socket and open a connection. You specify the kind of connection you want (e.g. L2CAP, RFCOMM, SCO) as parameters when you create the socket.

There is also An Introduction to Bluetooth programming in GNU/Linux.