Skip to main content

Discover devices on your local network

Project description

This library is deprecated. We will no longer release new versions, fix bugs or accept pull requests. If you are looking to make your Home Assistant integration discoverable, use the zeroconf and SSDP manifest options.

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.

We are no longer accepting PRs that implement custom discovery protocols. Only PRs that use mDNS or uPnP are supported. See this issue

Installation

Netdisco is available on PyPi. Install using pip3 install netdisco.

Example

From command-line:

python3 -m netdisco
# To see all raw data:
python3 -m netdisco dump

In your script:

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']

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

netdisco-2.9.0.tar.gz (31.0 kB view details)

Uploaded Source

Built Distribution

netdisco-2.9.0-py3-none-any.whl (51.2 kB view details)

Uploaded Python 3

File details

Details for the file netdisco-2.9.0.tar.gz.

File metadata

  • Download URL: netdisco-2.9.0.tar.gz
  • Upload date:
  • Size: 31.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.5

File hashes

Hashes for netdisco-2.9.0.tar.gz
Algorithm Hash digest
SHA256 3a92c533ed199a18202754ae2e848efaa58b70a7294bae6c77bbb6ce4ccfcace
MD5 db7bf02f5fd38bb51e50266c0597f1e6
BLAKE2b-256 64ec07a78d7704abcdd2e8aca70595375f29dfb76b32aa281f529b7806479c97

See more details on using hashes here.

File details

Details for the file netdisco-2.9.0-py3-none-any.whl.

File metadata

  • Download URL: netdisco-2.9.0-py3-none-any.whl
  • Upload date:
  • Size: 51.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.5

File hashes

Hashes for netdisco-2.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 062e084b684afe2f5f6da377020eeb5e81e5ae291b13beb9fe7ae948a913d245
MD5 a3a7b285537561b370f149873e479e9a
BLAKE2b-256 ad0b4fefbc46f79a54ca0991fc8c8421f5ef4b23945bda73d6d28ad631c93e70

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page