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

Uploaded Source

Built Distribution

netdisco-2.8.0-py3-none-any.whl (50.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: netdisco-2.8.0.tar.gz
  • Upload date:
  • Size: 30.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.8.2

File hashes

Hashes for netdisco-2.8.0.tar.gz
Algorithm Hash digest
SHA256 7754440294153671515b3d643c72b3a2976f1a9750e4a0dde964075c021c31fd
MD5 2faed187ae7d289118d7f58753f9b885
BLAKE2b-256 b48838297c300b480129f5c4dfbe23f56658f37794c931811d4651893d0f6c03

See more details on using hashes here.

File details

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

File metadata

  • Download URL: netdisco-2.8.0-py3-none-any.whl
  • Upload date:
  • Size: 50.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.8.2

File hashes

Hashes for netdisco-2.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 afa7864738c0b432057437f17bc5e0c9f4ae8014147d50cd97a44b7874a28670
MD5 6ab48e78990bf30ba9196f1a859264a8
BLAKE2b-256 6a72c54cb46cd90157857754ed1669efa048827f17f7244ecd7291cd81401422

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