|pypibadge| |docsbadge|
.. raw:: html
<iframe allowtransparency="true" style="background-color: white;" src="https://github.com/sponsors/martinohanlon/button" title="Sponsor martinohanlon" height="35" width="116" style="border: 0;"></iframe>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.
|bluedotfeature|
|bluedotapp| |bluedotmanybuttons| |bluedotpython|
Created by Martin O'Hanlon (@martinohanlon, stuffaboutco.de_).
Install and usage_ is really simple:
Install the Python library::
sudo pip3 install bluedot
Get the Android Blue Dot app or use the Python Blue Dot app
Pair your Raspberry Pi
Write some code::
from bluedot import BlueDot bd = BlueDot() bd.wait_for_press() print("You pressed the blue dot!")
Press the Blue Dot
See the getting started_ guide to 'get started'!
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.
|bluedotjoypad|
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!
The online documentation describes how to use Blue Dot and the Python library including Recipes_ and ideas.
Production - under active development. Be sure to raise an issue_ if you have a feature request or experience problems.
.. _Martin O'Hanlon: https://github.com/martinohanlon .. stuffaboutco.de: http://stuffaboutco.de .. @martinohanlon: https://twitter.com/martinohanlon .. _getting started: http://bluedot.readthedocs.io/en/latest/gettingstarted.html .. _Install and usage: http://bluedot.readthedocs.io/en/latest/gettingstarted.html .. _online documentation: http://bluedot.readthedocs.io/en/latest/ .. _Python library: http://bluedot.readthedocs.io/en/latest/dotapi.html .. _examples: https://github.com/martinohanlon/BlueDot/tree/master/examples .. _Recipes: http://bluedot.readthedocs.io/en/latest/recipes.html .. _Android Blue Dot app: http://play.google.com/store/apps/details?id=com.stuffaboutcode.bluedot .. _Python Blue Dot app: http://bluedot.readthedocs.io/en/latest/bluedotpythonapp.html .. _issue: https://github.com/martinohanlon/bluedot/issues .. _BlueDot controlled Robot: https://youtu.be/eW9oEPySF58 .. _joystick: http://bluedot.readthedocs.io/en/latest/recipes.html#joystick .. _button: http://bluedot.readthedocs.io/en/latest/recipes.html#button .. _slide it: http://bluedot.readthedocs.io/en/latest/recipes.html#slider .. _swipe it: http://bluedot.readthedocs.io/en/latest/recipes.html#swiping .. _rotate it: http://bluedot.readthedocs.io/en/latest/recipes.html#rotating
.. |bluedotapp| image:: https://raw.githubusercontent.com/martinohanlon/BlueDot/master/docs/images/bluedotandroid_small.png :height: 270 px :width: 144 px :scale: 100 % :alt: blue dot app
.. |bluedotpython| image:: https://raw.githubusercontent.com/martinohanlon/BlueDot/master/docs/images/bluedotpython.png :height: 247 px :width: 294 px :scale: 100 % :alt: blue dot python app
.. |bluedotjoypad| image:: https://raw.githubusercontent.com/martinohanlon/BlueDot/master/docs/images/layout_joypad_smaller.png :height: 147 px :width: 294 px :scale: 100 % :alt: blue dot app as a joy pad controller
.. |bluedotmanybuttons| image:: https://raw.githubusercontent.com/martinohanlon/BlueDot/master/docs/images/layout_many_buttons_smaller.png :height: 270 px :width: 144 px :scale: 100 % :alt: blue dot app with 10 buttons in a 2x5 grid
.. |bluedotfeature| image:: https://raw.githubusercontent.com/martinohanlon/BlueDot/master/docs/images/blue_dot_feature_small.png :height: 247 px :width: 506 px :scale: 100 % :alt: blue dot feature
.. |pypibadge| image:: https://badge.fury.io/py/bluedot.svg :target: https://badge.fury.io/py/bluedot :alt: Latest Version
.. |docsbadge| image:: https://readthedocs.org/projects/bluedot/badge/ :target: https://readthedocs.org/projects/bluedot/ :alt: Docs