Metadata-Version: 2.1
Name: pi-internet-webthing
Version: 0.0.19
Summary: A web connected local internet speed and connectivity monitor
Home-page: https://github.com/grro/pi_internet_webthing
Author: Gregor Roth
Author-email: gregor.roth@web.de
License: MIT
Description: # pi_internet_webthing
        A web connected local internet speed and connectivity monitor 
        
        This project implements an internet monitor agent providing a speed monitor [webthing API](https://iot.mozilla.org/wot/) as well as a connectivity monitor [webthing API](https://iot.mozilla.org/wot/).
        
        The pi_internet_webthing package exposes an http webthing endpoint which supports reading the internet speed results 
        as well as an endpoint to read the internet connectivity results via http 
        E.g. 
        ```
        # webthing has been started on host 192.168.0.23
        
        # internet speed
        curl http://192.168.0.23:8433/0/properties
        {
           "test_period": 900,
           "downloadspeed": 215.2,
           "uploadspeed": 11,
           "ping": 17.763,
           "testdate": "2020-10-11T13:44:51.346706",
           "speedtest_server": "Mobile Breitbandnetze GmbH/Freisbach",
           "speedtest_report_uri": "http://www.speedtest.net/result/10231336474.png"
        }
        
        # connectivity 
        curl http://192.168.0.23:8433/1/properties
        {
           "test_url": "http://google.com",
           "test_period": 5,
           "connected": true,
           "ip_address": "95.88.57.72"
        }
        ```
        
        To install this software you may use [PIP](https://realpython.com/what-is-pip/) package manager such as shown below
        ```
        sudo pip install pi_internet_webthing
        ```
        
        After this installation you may start the webthing http endpoint inside your python code or via command line using
        ```
        sudo netmonitor --command listen --hostname 192.168.0.23 --port 8433 --speedtest_period 900 --connecttest_period 5 
        ```
        Here, the webthing API will be bind to hostname 192.168.0.23 running on port 8433. The internet speed monitor as well as the connectivity monitor will be started by performing the *listen* command above.
        The speed test will be executed each 15 min (900 sec), the connectivity test will be executed each 5 sec. THe WebThing server provides [mDNS](https://en.wikipedia.org/wiki/Multicast_DNS) to enable clients discovering the WebThing interfaces.   
        
        Alternatively to the *listen* command, you can use the *register* command to register and start the webthing service as systemd unit. 
        By doing this the webthing service will be started automatically on boot. Starting the server manually using the *listen* command is no longer necessary. 
        ```
        sudo netmonitor --command register --hostname 192.168.0.23 --port 8433 --speedtest_period 900 --connecttest_period 5 
        ```  
        
        To start the speedtest monitor only just omit the --connecttest_period parameter
        ```
        sudo netmonitor --command listen --hostname 192.168.0.23 --port 8433 --speedtest_period 900
        ```
        
Keywords: webthings,home automation,speedtest,internet,local,raspberry,pi
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Description-Content-Type: text/markdown
