Skip to content


Repository files navigation


Open Source Love Build Status PyPI Operating System Python Versions
Contributors Slack PyPI

Python package for scanning and advertising Eddystone-URL and Eddystone-UID.

Note: Please read before making any kind of contribution.


  • Python 3.x (Scanning will not work on Python 2.x)
  • Bluez
    • sudo apt-get install bluez bluez-hcidump
  • Pip Packages
    • pip install enum34


sudo pip install PyBeacon


sudo pip install PyBeacon --upgrade


PyBeacon [-h] [-u [URL]] [-s] [-t] [-o] [-v] [-V]

optional arguments:
	-h, --help            show this help message and exit
	-u [URL], --url [URL] URL to advertise.
	-i [UID], --uid [UID] UID to advertise.
	-s, --scan            Scan for URLs.
	-t, --terminate       Stop advertising URL.
	-o, --one             Scan one URL only.
	-v, --version         Version of PyBeacon.
	-V, --Verbose         Print lots of debug output.

Projects using PyBeacon

Please add your projects here if you are using PyBeacon's code so that similar projects can be accessed easily.