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.7.0.tar.gz (28.7 kB view details)

Uploaded Source

Built Distribution

netdisco-2.7.0-py3-none-any.whl (46.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: netdisco-2.7.0.tar.gz
  • Upload date:
  • Size: 28.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.7.7

File hashes

Hashes for netdisco-2.7.0.tar.gz
Algorithm Hash digest
SHA256 46839e47c57554241971fbf3ba7e0077cadd22dd2bcf7eec4f72b243de2e062d
MD5 f870261ad092d5cf0222d5036d1dc521
BLAKE2b-256 327c0d386af022c16e4fb10935b77f5a66dd64661240285249b99bde9c89ef6e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: netdisco-2.7.0-py3-none-any.whl
  • Upload date:
  • Size: 46.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.7.7

File hashes

Hashes for netdisco-2.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ee7865f3a084b56ea90ce7892b27d7eccebdffb92f1d426f45babc5f4bfb1447
MD5 0acd36d64e060154e29909f65766f12f
BLAKE2b-256 003bc601fa2f54626f94c1c18483a095feb78b6be50d557115f7c39eed6b5a9e

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