Skip to content

A zero boiler plate bluetooth remote

License

Notifications You must be signed in to change notification settings

jmfloyd/BlueDot

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 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 statred'!

More

The Blue Dot is a joystick as well as button. You can tell if the dot 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 dot was pressed.

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

The dot doesn't have to be blue, or a dot, you can change its colour, make it square or give it a border.

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.

About

A zero boiler plate bluetooth remote

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 68.6%
  • Java 31.4%