LightBlue python module that compiles successful on OS X 10.8 (Mountain Lion)
Clone or download
#7 Compare This branch is 26 commits ahead, 2 commits behind 0-1-0:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



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.