{"id":17766737,"url":"https://github.com/martinohanlon/bluedot","last_synced_at":"2025-04-05T19:09:19.229Z","repository":{"id":40831517,"uuid":"86357105","full_name":"martinohanlon/BlueDot","owner":"martinohanlon","description":"A zero boiler plate bluetooth remote","archived":false,"fork":false,"pushed_at":"2024-08-07T15:23:00.000Z","size":37581,"stargazers_count":147,"open_issues_count":21,"forks_count":46,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-03-29T18:05:49.587Z","etag":null,"topics":["bluetooth","python","python-library","raspberry-pi"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/martinohanlon.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["martinohanlon"]}},"created_at":"2017-03-27T16:13:37.000Z","updated_at":"2025-03-19T08:23:20.000Z","dependencies_parsed_at":"2024-10-26T21:10:57.697Z","dependency_job_id":"1166d50b-7b11-48d2-9e04-8d109cc47b31","html_url":"https://github.com/martinohanlon/BlueDot","commit_stats":{"total_commits":272,"total_committers":4,"mean_commits":68.0,"dds":"0.30147058823529416","last_synced_commit":"208163eeeae2887828aaa3a90ab90be7fdbd8fe2"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martinohanlon%2FBlueDot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martinohanlon%2FBlueDot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martinohanlon%2FBlueDot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martinohanlon%2FBlueDot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/martinohanlon","download_url":"https://codeload.github.com/martinohanlon/BlueDot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247386263,"owners_count":20930618,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bluetooth","python","python-library","raspberry-pi"],"created_at":"2024-10-26T20:36:23.854Z","updated_at":"2025-04-05T19:09:19.198Z","avatar_url":"https://github.com/martinohanlon.png","language":"Python","funding_links":["https://github.com/sponsors/martinohanlon","https://github.com/sponsors/martinohanlon/button"],"categories":[],"sub_categories":[],"readme":"Blue Dot\n========\n\n|pypibadge| |docsbadge|\n\n.. raw:: html\n\n    \u003ciframe allowtransparency=\"true\" style=\"background-color: white;\" src=\"https://github.com/sponsors/martinohanlon/button\" title=\"Sponsor martinohanlon\" height=\"35\" width=\"116\" style=\"border: 0;\"\u003e\u003c/iframe\u003e\n\nBlue 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.\n\n|bluedotfeature|\n\n|bluedotapp| |bluedotmanybuttons| |bluedotpython|\n\nCreated by `Martin O'Hanlon`_ (`@martinohanlon`_, `stuffaboutco.de`_).\n\nGetting Started\n---------------\n\n`Install and usage`_ is really simple:\n\n1. Install the Python library::\n\n       sudo pip3 install bluedot\n\n2. Get the `Android Blue Dot app`_ or use the `Python Blue Dot app`_\n\n3. Pair your Raspberry Pi\n\n4. Write some code::\n\n       from bluedot import BlueDot\n       bd = BlueDot()\n       bd.wait_for_press()\n       print(\"You pressed the blue dot!\")\n\n5. Press the Blue Dot\n\nSee the `getting started`_ guide to 'get started'!\n\nMore\n----\n\nBlue 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.\n\n|bluedotjoypad|\n\nEvery `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`_.\n\nWhy 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.\n\nIts not all about when the button was pressed either - pressed, released or moved they all work.\n\nA button can be any colour, square, given give or hidden!\n\nYou can press it, `slide it`_, `swipe it`_, `rotate it`_ - one blue circle can do a lot!\n\nEven more\n---------\n\nThe `online documentation`_ describes how to use Blue Dot and the `Python library`_ including `Recipes`_ and ideas.\n\nStatus\n------\n\nProduction - under active development. Be sure to raise an `issue`_ if you have a feature request or experience problems.\n\n.. _Martin O'Hanlon: https://github.com/martinohanlon\n.. _stuffaboutco.de: http://stuffaboutco.de\n.. _@martinohanlon: https://twitter.com/martinohanlon\n.. _getting started: http://bluedot.readthedocs.io/en/latest/gettingstarted.html\n.. _Install and usage: http://bluedot.readthedocs.io/en/latest/gettingstarted.html\n.. _online documentation: http://bluedot.readthedocs.io/en/latest/\n.. _Python library: http://bluedot.readthedocs.io/en/latest/dotapi.html\n.. _examples: https://github.com/martinohanlon/BlueDot/tree/master/examples\n.. _Recipes: http://bluedot.readthedocs.io/en/latest/recipes.html\n.. _Android Blue Dot app: http://play.google.com/store/apps/details?id=com.stuffaboutcode.bluedot\n.. _Python Blue Dot app: http://bluedot.readthedocs.io/en/latest/bluedotpythonapp.html\n.. _issue: https://github.com/martinohanlon/bluedot/issues\n.. _BlueDot controlled Robot: https://youtu.be/eW9oEPySF58\n.. _joystick: http://bluedot.readthedocs.io/en/latest/recipes.html#joystick\n.. _button: http://bluedot.readthedocs.io/en/latest/recipes.html#button\n.. _slide it: http://bluedot.readthedocs.io/en/latest/recipes.html#slider\n.. _swipe it: http://bluedot.readthedocs.io/en/latest/recipes.html#swiping\n.. _rotate it: http://bluedot.readthedocs.io/en/latest/recipes.html#rotating\n\n.. |bluedotapp| image:: https://raw.githubusercontent.com/martinohanlon/BlueDot/master/docs/images/bluedotandroid_small.png\n   :height: 270 px\n   :width: 144 px\n   :scale: 100 %\n   :alt: blue dot app\n\n.. |bluedotpython| image:: https://raw.githubusercontent.com/martinohanlon/BlueDot/master/docs/images/bluedotpython.png\n   :height: 247 px\n   :width: 294 px\n   :scale: 100 %\n   :alt: blue dot python app\n\n.. |bluedotjoypad| image:: https://raw.githubusercontent.com/martinohanlon/BlueDot/master/docs/images/layout_joypad_smaller.png\n   :height: 147 px\n   :width: 294 px\n   :scale: 100 %\n   :alt: blue dot app as a joy pad controller\n\n.. |bluedotmanybuttons| image:: https://raw.githubusercontent.com/martinohanlon/BlueDot/master/docs/images/layout_many_buttons_smaller.png\n   :height: 270 px\n   :width: 144 px\n   :scale: 100 %\n   :alt: blue dot app with 10 buttons in a 2x5 grid\n\n.. |bluedotfeature| image:: https://raw.githubusercontent.com/martinohanlon/BlueDot/master/docs/images/blue_dot_feature_small.png\n   :height: 247 px\n   :width: 506 px\n   :scale: 100 %\n   :alt: blue dot feature\n\n.. |pypibadge| image:: https://badge.fury.io/py/bluedot.svg\n   :target: https://badge.fury.io/py/bluedot\n   :alt: Latest Version\n\n.. |docsbadge| image:: https://readthedocs.org/projects/bluedot/badge/\n   :target: https://readthedocs.org/projects/bluedot/\n   :alt: Docs\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmartinohanlon%2Fbluedot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmartinohanlon%2Fbluedot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmartinohanlon%2Fbluedot/lists"}