LightBlue python module that compiles successful on OS X 10.8 (Mountain Lion)
Python Objective-C C C++ Other
Latest commit 35580e3 Oct 22, 2014 @0-1-0 Merge pull request #3 from hans/master
Add dummy implementations to satisfy new IOBluetoothDeviceInquiryDelegate protocol in 10.8
Failed to load latest commit information.
build/lib/lightblue init Sep 24, 2012
doc init Sep 24, 2012
examples init Sep 24, 2012
src Add dummy implementations to satisfy new IOBluetoothDeviceInquiryDele… Apr 11, 2013
CHANGELOG init Sep 24, 2012
COPYING init Sep 24, 2012
PKG-INFO init Sep 24, 2012
README.txt Update README.txt Jan 15, 2013 init Sep 24, 2012



LightBlue is a cross-platform Bluetooth API for Python which provides simple access to Bluetooth operations. It is available for Mac OS X, GNU/Linux and Nokia's Python for Series 60 platform for mobile phones.

LightBlue provides simple access to:

    * Device and service discovery (with and without end-user GUIs)
    * Standard socket interface for RFCOMM and L2CAP sockets (currently L2CAP client sockets only, and not on PyS60)
    * Sending and receiving files over OBEX
    * Advertising of RFCOMM and OBEX services
    * Local device information

LightBlue is released under the GPL License.

See the home page at for more information.


Mac OS X:
    Python 2.3 or later
    PyObjC (
    Xcode 2.1 or later to build LightAquaBlue framework (but you could build from a separate .xcode project for older versions)
    (Mac OS X 10.4 or later is required to do device discovery without a GUI)
    Python 2.3 or later (with Tkinter if using selectdevice() or selectservice())
    PyBluez 0.9 or later (
    OpenOBEX 1.0.1 or later (
Python for Series 60:
    Python for Series 60 1.3.1 or later (

Mac OS X and GNU/Linux:
    Just open up a shell/terminal and run the command:

        python install

Or you might need to run with root access, i.e.

	sudo python install

    On Mac OS X, the script also installs the LightAquaBlue framework into /Library/Frameworks.
Python for Series 60: 
    Download the appropriate SIS file for your phone from the LightBlue home page ( Send the file to your phone, and open and install. Or, use the Nokia PC Suite to install the SIS file.

Installation for Xcode 1.5 / Mac OS X 10.3

The LightAquaBlue framework for the Mac OS X installation is in a .xcodeproj package which can only be opened by Xcode 2.1 and later, and Xcode 2.1 does not run on Mac OS X 10.3. So to build LightBlue on Mac OS X 10.3, just create a .xcode package yourself:

- Open Xcode and choose File -> New Project. Choose "Cocoa Framework" (under the "Frameworks" drop-down list) and save the project as "LightAquaBlue". Save the project anywhere as long as it's not replacing the existing LightBlue src/mac/LightAquaBlue directory.
- Go to Project -> Add files... and add all the .h and .m files from LightBlue's src/mac/LightAquaBlue folder. Also add the OBEXFileTransferDictionary.plist, OBEXObjectPushDictionary.plist and SerialPortDictionary.plist files.
- Go to Project -> Add framework... and add IOBluetooth.framework (found at /System/Library/Frameworks/IOBluetooth.framework).
- Click on the "Targets" item in the left-hand column of the Xcode window. This should show all the .h and .m files you've added as well as a few other files. In the "Role" column, all the .h files currently have "project" roles. Click on each drop-down menu item to change all of them to "public".
- Now go to the Finder and locate the xcode project you've just created. Copy the LightAquaBlue.xcode file for the project and paste it in LightBlue's src/mac/LightAquaBlue directory.

Now go to LightBlue's root directory and run the command

	sudo python install

You should see the output of the build of the xcode project.