Monday, 24 April 2017

Blue Dot - a bluetooth remote for Raspberry Pi

Blue Dot is a really simple way to add Bluetooth remote control to your Raspberry Pi projects.

I created Blue Dot after being asked many times at Picademy “how can I get rid of all these wires?”. 

Blue dot is an android app (client) and really easy to use Python library which allows you to wirelessly control your Python projects, whether that is a light switch, remote camera, robot or anything else you can think of!

See the getting started guide for more info on 'getting started', or follow the tutorial below.

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

You will need a Raspberry Pi with built-in Bluetooth (such as the Pi 3 or Pi Zero W) or a Raspberry Pi and a USB Bluetooth dongle.

Get the app
Download and install the Blue Dot app from the google play store.

If you are wondering why there is no iOS app? Its because iOS doesn't support Bluetooth serial comms; you can only really talk to 'standard devices' (cars, speakers, fitness trackers, etc).

Python library
Open a terminal (Menu > Accessories > Terminal) and type:
sudo apt-get install python3-dbus
sudo pip3 install bluedot
Or if you need to use Python 2 (please dont tho!):
sudo apt-get install python-dbus
sudo pip install bluedot

In order to communicate over Bluetooth securely you need to pair your phone to your Raspberry Pi.

On your Android phone:
  1. Open Settings
  2. Select Bluetooth
  3. This will make your phone Discoverable
Using your Raspberry Pi
  1. Click the bluetooth icon on the taskbar
  2. Turn on Bluetooth (if its off)
  3. Click Make Discoverable
  4. Click Add Device
  5. Your phone will appear in the list, select it and click Pair
  6. Enter a PIN code
On your Android phone
  1. Enter the same PIN code when prompted
  2. Click Ok
The simplest way to use the Blue Dot is as a button:
  1. Open Python 3 (Menu > Programming > Python 3)
  2. Create a new file (File > New File)
  3. The following code, will start up the Blue Dot, and wait for it to be pressed:
  4. from bluedot import BlueDot
    bd = BlueDot()
    print("You pressed the blue dot!")
  5. Save your program (File > Save) as
  6. Run your program (Run > Run Module)
  7. Open the Blue Dot app
  8. Connect to your Raspberry Pi
  9. Press the Blue Dot
As well as waiting for something to happen you can also call functions when the button is pressed, released or the position its pressed moves.
from bluedot import BlueDot
from signal import pause

def say_hello():
    print("Hello World")

def say_goodbye():

bd = BlueDot()
bd.when_pressed = say_hello
bd.when_released = say_goodbye

By using the position of where the button is pressed you can use the Blue Dot like a joystick:
from bluedot import BlueDot
from signal import pause

def dpad(pos):
    elif pos.bottom:
    elif pos.left:
    elif pos.right:
    elif pos.middle:

bd = BlueDot()
bd.when_pressed = dpad

Add to this gpiozero's Robot functions, you can create a Bluetooth controlled robot with very little code.
from bluedot import BlueDot
from gpiozero import Robot
from signal import pause

bd = BlueDot()
robot = Robot(left=(lfpin, lbpin), right=(rfpin, rbpin))

def move(pos):
    elif pos.bottom:
    elif pos.left:
    elif pos.right:

def stop():

bd.when_pressed = move
bd.when_moved = move
bd.when_released = stop

Check out the Blue Dot documentation for more information and ideas - you really can do a lot with a simple circle :)


  1. brilliant! Will play with this soon

  2. We've been getting stuck into using Blue Dot since seeing you demo it at the Manchester Raspberry Pi Jamboree in May. We're using David Glaude's stuff to control our Unicorn Hat/ Ikea lamp at . Many thanks.

    1. Excellent, I saw David's work and instantly thought of you but I didnt have any contact details for you (and couldn't find you on twitter), so Im glad you found it.

  3. I'm afraid social media has passed me by but obviously some sort of telekinesis got me to enter the right things in Google. Perhaps it just shows how Google tends to constrain discovery ?

  4. Martin, thank you very much for this incredibly brilliant blue dot! Fine documentation, good API, ... very-very well done! Is the Android app source code also available?

  5. Oh, never mind, missed

  6. Hi Martin,

    Exactly what I was looking for.
    Just installed and used your project with my robot. Worked like a dream. Well done, keep up the good work.

  7. This comment has been removed by the author.

  8. Martin,
    I was wondering if it would be a good idea to add couple of circles to the BlueDot to create zones. Only visual. The code to determine which zone is being used/pressed/released can be done using simple distance/angle conditions like so:

    def move(pos):
    ....# outer circle:
    ....if pos.distance > .85:
    ........if -45 < pos.angle <= 45:
    ........elif pos.angle > 135 or pos.angle <= -135:
    ........elif 45 < pos.angle <= 135:
    ........elif -135 < pos.angle <= -45:
    ....# middle circle:
    ....elif .45 < pos.distance <= .85:
    ........if -45 < pos.angle <= 45:
    ........elif pos.angle > 135 or pos.angle <= -135:
    ........elif 45 < pos.angle <= 135:
    ........elif -135 < pos.angle <= -45:
    ....# inner circle:
    ....elif pos.distance <= .45:
    ........if -45 < pos.angle <= 45:
    ........elif pos.angle > 135 or pos.angle <= -135:
    ........elif 45 < pos.angle <= 135:
    ........elif -135 < pos.angle <= -45:

  9. Hi Martin.
    why will my pi and phone pair up but they wont connect! the pi says no usable services. have tried brand new install plus update etc and followed instructions.

    1. Do you get the message "no usable services" when you do the pairing? If so, you can ignore it, you phone and Pi are still paired, it basically telling you that there are no registered services running on the Pi (yet).

      Run Blue Dot and it should connect.

    2. I have put a small note on the getting started guide. I had already put it on the pairing Pi to Pi instructions, but not the Pi to Android instructions!

  10. Hi Martin!

    This is really good stuff. Thanks a lot. I have a quick question. In the BT Comm code sample you provide, is there a way to terminate the server side at some point? I've tried "s.stop()", but that did not work.

    Thanks in advance.

    1. There is a s.stop() method.

      When you tried it, what happened, did you receive an error?

    2. This is the return:

      Exception in thread Thread-1:
      Traceback (most recent call last):
      File "/usr/lib/python3.4/", line 920, in _bootstrap_inner
      File "/usr/lib/python3.4/", line 868, in run
      self._target(*self._args, **self._kwargs)
      File "/usr/local/lib/python3.4/dist-packages/bluedot/", line 397, in _wait_for_connection
      File "/usr/local/lib/python3.4/dist-packages/bluedot/", line 418, in _read
      File "/home/pi/Scripts/", line 39, in data_received
      File "/usr/local/lib/python3.4/dist-packages/bluedot/", line 360, in stop
      File "/usr/local/lib/python3.4/dist-packages/bluedot/", line 26, in stop
      File "/usr/local/lib/python3.4/dist-packages/bluedot/", line 29, in join
      super(WrapThread, self).join()
      File "/usr/lib/python3.4/", line 1057, in join
      raise RuntimeError("cannot join current thread")
      RuntimeError: cannot join current thread

    3. Thanks. Could you raise an issue on please. Could you also include your code and I will take a look at it for you.

    4. Just had a quick look at your stack trace. Are you by any chance trying to stop the server within your data_received function? i.e. you code looks a bit like this:

      |def data_received(data):
      | # do stuff
      | s.stop()
      |s = BluetoothServer(data_received)

      if so I can understand why you are getting an error. In summary, you cant stop the server because the thread you are trying to stop is the one running the data_received function i.e. you cant stop yourself!

      If you could raise an issue I'll have a think about how that might be resolved, but in the mean time, call stop outside the data_received function, something like this:

      |run_server = False
      |def data_received(data):
      | # do stuff
      | stop_server = True
      |s = BluetoothServer(data_received)
      |while stop_server == False:
      | time.sleep(0.1)