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.

Android App

If you’re 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), then enter:

sudo apt install python3-dbus
sudo pip3 install bluedot

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

sudo apt 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.


  1. Start up Python 3 (select Menu ‣ Programming ‣ Python 3)

  2. Select File ‣ New File to create a new program

  3. Enter the following code:

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

  5. Run the program, (select Run ‣ Run Module or press F5)


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 Blue Dot API documentation for more ideas on using Blue Dot.