From d41ea366e7c2e51c9f7e68092d89e3f0be580362 Mon Sep 17 00:00:00 2001 From: Ruben Undheim Date: Fri, 21 Dec 2018 21:01:06 +0100 Subject: Import python-netdisco_2.2.0.orig.tar.gz [dgit import orig python-netdisco_2.2.0.orig.tar.gz] --- README.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..264c440 --- /dev/null +++ b/README.md @@ -0,0 +1,52 @@ +# NetDisco + +NetDisco is a Python 3 library to discover local devices and services. It allows to scan on demand or offer a service that will scan the network in the background in a set interval. + +Current methods of scanning: + + - mDNS (includes Chromecast, Homekit) + - uPnP + - Plex Media Server using Good Day Mate protocol + - Logitech Media Server discovery protocol + - Daikin discovery protocol + - Web OS discovery protocol + +It is the library that powers the device discovery within [Home Assistant](https://home-assistant.io/). + +## Installation + +Netdisco is available on PyPi. Install using `pip3 install netdisco`. + +## Example + +From command-line: + +```bash +python3 -m netdisco +# To see all raw data: +python3 -m netdisco dump +``` + +In your script: + +```python +from netdisco.discovery import NetworkDiscovery + +netdis = NetworkDiscovery() + +netdis.scan() + +for dev in netdis.discover(): + print(dev, netdis.get_info(dev)) + +netdis.stop() +``` + +Will result in a list of discovered devices and their most important information: + +``` +DLNA ['http://192.168.1.1:8200/rootDesc.xml', 'http://192.168.1.150:32469/DeviceDescription.xml'] +google_cast [('Living Room.local.', 8009)] +philips_hue ['http://192.168.1.2:80/description.xml'] +belkin_wemo ['http://192.168.1.10:49153/setup.xml'] +``` -- cgit v1.2.3