#dns-client #mdns #dns #multicast #discovery #chromecast

viam-mdns

A multicast DNS client library. Supports discovery of any mDNS device on a LAN

1 stable release

3.0.1 May 5, 2023

#4 in #chromecast

Download history 3/week @ 2024-07-24 5/week @ 2024-07-31 8/week @ 2024-08-07 10/week @ 2024-08-14 1/week @ 2024-08-21 9/week @ 2024-09-18 23/week @ 2024-09-25 91/week @ 2024-10-02 22/week @ 2024-10-09

102 downloads per month
Used in viam-rust-utils

MIT license

23KB
464 lines

mdns

Build Status crates.io MIT license

Documentation

An multicast DNS client in Rust.

Error logging is handled with the log library.

Wikipedia

Example

Find IP addresses for all Chromecasts on the local network.

use futures_util::{pin_mut, stream::StreamExt};
use mdns::{Error, Record, RecordKind};
use std::{net::IpAddr, time::Duration};


const SERVICE_NAME: &'static str = "_googlecast._tcp.local";

#[async_std::main]
async fn main() -> Result<(), Error> {
    // Iterate through responses from each Cast device, asking for new devices every 15s
    let stream = mdns::discover::all(SERVICE_NAME, Duration::from_secs(15))?.listen();
    pin_mut!(stream);

    while let Some(Ok(response)) = stream.next().await {
        let addr = response.records()
                           .filter_map(self::to_ip_addr)
                           .next();

        if let Some(addr) = addr {
            println!("found cast device at {}", addr);
        } else {
            println!("cast device does not advertise address");
        }
    }

    Ok(())
}

fn to_ip_addr(record: &Record) -> Option<IpAddr> {
    match record.kind {
        RecordKind::A(addr) => Some(addr.into()),
        RecordKind::AAAA(addr) => Some(addr.into()),
        _ => None,
    }
}

Dependencies

~7–16MB
~227K SLoC