An open API service indexing awesome lists of open source software.

https://github.com/crambl/mdns-scanner

Scan a network and create a list of IPs and associated hostnames, including mDNS hostnames and other aliases.
https://github.com/crambl/mdns-scanner

dns mdns-network-scanner network-scanning tui

Last synced: about 1 month ago
JSON representation

Scan a network and create a list of IPs and associated hostnames, including mDNS hostnames and other aliases.

Awesome Lists containing this project

README

        

Table of Contents↗️

MDNS Scanner

mdns-scanner



GitHub release


CI status


codecov



Windows
Linux
macOS

## Purpose

Scan a network and create a list of IPs and associated hostnames, including DNS-SD service instances, mDNS hostnames and other aliases.

## Demo

> [!NOTE]
> The DNS-SD services are resolved at the end of the gif, about 30 seconds in.

![demo](https://github.com/user-attachments/assets/710311d5-5aaa-4404-a6c9-2708e5dbba11)

## Install

### Prebuilt binaries

Prebuilt binaries for Linux, MacOS, and Windows can be found on [the releases page](https://github.com/CramBL/mdns-scanner/releases).

```console
curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/CramBL/mdns-scanner/trunk/scripts/install.sh \
| bash -s -- --to ~/bin
```

### With `cargo`

```console
cargo install mdns-scanner
```

### Quickstart

Simply run it.

`mdns-scanner` will start scanning any non-loopback network interfaces for IPs with a host on the other end, and resolve the hostnames for those IPs.

> [!TIP]
> Inform your resident sys admin that you're about to run hundreds of IP scans per second.

### Runtime dependencies

#### Windows

[Npcap](https://npcap.com/)

#### Unix

None.

## Architecture

![architecture](/docs/architecture.svg)