Skip to content

Latest commit

 

History

History
124 lines (87 loc) · 4.61 KB

README.rst

File metadata and controls

124 lines (87 loc) · 4.61 KB

Blue Dot

Latest Version Docs

Blue Dot allows you to control your Raspberry Pi projects wirelessly - it's a Bluetooth remote and zero boiler plate (super simple to use :) Python library.

blue dot feature

blue dot app blue dot app with 10 buttons in a 2x5 grid blue dot python app

Created by Martin O'Hanlon (@martinohanlon, stuffaboutco.de).

Getting Started

Install and usage is really simple:

  1. Install the Python library:

    sudo pip3 install bluedot
    
  2. Get the Android Blue Dot app or use the Python Blue Dot app

  3. Pair your Raspberry Pi

  4. Write some code:

    from bluedot import BlueDot
    bd = BlueDot()
    bd.wait_for_press()
    print("You pressed the blue dot!")
    
  5. Press the Blue Dot

See the getting started guide to 'get started'!

More

Blue Dot is more than just one button_. You can create as many buttons as you want and change their appearance to create your own controller.

blue dot app as a joy pad controller

Every button is also a joystick. You can tell if a button was pressed in the middle, on the top, bottom, left or right. You can easily create a BlueDot controlled Robot.

Why be restricted by such vague positions like top and bottom though: you can get the exact (x, y) position or even the angle and distance from centre where the button was pressed.

Its not all about when the button was pressed either - pressed, released or moved they all work.

A button can be any colour, square, given give or hidden!

You can press it, slide it, swipe it, rotate it - one blue circle can do a lot!

Even more

The online documentation describes how to use Blue Dot and the Python library including Recipes and ideas.

Status

Production - under active development. Be sure to raise an issue if you have a feature request or experience problems.