Getting started


In order to use Blue Dot you will need:

  • a Raspberry Pi
    • with built-in Bluetooth (such as the Pi 3 or Pi Zero W)
    • or a USB Bluetooth dongle
  • an Android phone or 2nd Raspberry Pi for the remote
  • an internet connection (for the install)


These instructions assume your Raspberry Pi is running the latest version of Raspbian with Pixel.

android app

If using an Android phone, the Blue Dot app can be installed from the Google Play Store.

python library

Open a terminal, click Menu > Accessories > Terminal:

sudo apt-get install python3-dbus
sudo pip3 install bluedot

If you want to use bluedot with Python 2 (there really is no need though!):

sudo apt-get install python-dbus
sudo pip install bluedot

To upgrade to the latest version:

sudo pip3 install bluedot --upgrade



In order to use Blue Dot you will need to pair the Raspberry Pi to the remote (Android phone or 2nd Raspberry Pi).

write code

  1. Start up Python 3, click Menu > Programming > Python 3

  2. Click File > New File to create a new program

  3. Create your python program:

    from bluedot import BlueDot
    bd = BlueDot()
    print("You pressed the blue dot!")
  4. Save your program, click File > Save As and save as

  5. Run the program, click Run > Run Module or press F5

Warning - do not save your program as as Python will try and import your program rather than the bluedot module and you will get the error ImportError: cannot import name BlueDot.


Start-up the Blue Dot app on your Android phone or run the Blue Dot python app on your 2nd Raspberry Pi:

  1. Select your Raspberry Pi from the list
  2. Press the blue dot

Where next

Check out the Recipes and the API documentation for more ideas on using bluedot.