birbnetes/iot-ip-beacon
birbnetes/iot-ip-beacon
4
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Simple script that helps identifying birboxes on a wired network
4 Commits 1 Branch 0 Tags 27 KiB
Python 100%
2d691e2bb5
Go to file
marcsello 2d691e2bb5 Added readme
2022-01-31 22:23:14 +01:00
.gitignore Initial commit 2021-07-20 11:59:52 +02:00
main.py Added more info to the fields 2021-07-26 22:24:46 +02:00
README.md Added readme 2022-01-31 22:23:14 +01:00

README.md

IoT IP Beacon

Simple daemon that helps you find your lost IoT device on the open sea of IP addresses.

How it works?

This simple daemon broadcast some basic system information every 10 seconds to the local subnet.

These information are the following:

  • Configured IP address of the sending interface
  • Hostname
  • Birbox software version
  • Uptime

The messages is formed as the following UTF-8 encoded string:

BIRBOX|{ipaddr}|{hostname}|{version}|{uptime}

The messages are broadcast to the 6969 UDP port.

All you need is to listen to such packets on the network, so you can find your lost IoT device in no time.

Usage

Just start the script as a system daemon. You may have to change the interface name.