{"id":43235235,"url":"https://github.com/hwipl/listnd","last_synced_at":"2026-02-01T10:37:43.314Z","repository":{"id":43410214,"uuid":"213178530","full_name":"hwipl/listnd","owner":"hwipl","description":"Passive discovery and listing of devices on a network","archived":false,"fork":false,"pushed_at":"2025-04-21T09:26:59.000Z","size":195,"stargazers_count":9,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-21T10:29:55.343Z","etag":null,"topics":["command-line-tool","golang","network","network-analyzer","network-devices","network-discovery","packet-analyzer","packet-capture"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hwipl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-10-06T13:59:51.000Z","updated_at":"2025-04-21T09:25:26.000Z","dependencies_parsed_at":"2022-09-16T04:01:14.149Z","dependency_job_id":"5f67a67a-4b06-4a71-9c7a-e84b342b1c6a","html_url":"https://github.com/hwipl/listnd","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hwipl/listnd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hwipl%2Flistnd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hwipl%2Flistnd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hwipl%2Flistnd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hwipl%2Flistnd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hwipl","download_url":"https://codeload.github.com/hwipl/listnd/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hwipl%2Flistnd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28976334,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T09:57:52.632Z","status":"ssl_error","status_checked_at":"2026-02-01T09:57:49.143Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["command-line-tool","golang","network","network-analyzer","network-devices","network-discovery","packet-analyzer","packet-capture"],"created_at":"2026-02-01T10:37:43.240Z","updated_at":"2026-02-01T10:37:43.301Z","avatar_url":"https://github.com/hwipl.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# listnd\n\nlistnd is a command line tool for discovery of devices on a network and listing\nthem. The discovery process is passive in the sense that listnd does not send\nany packets to discover devices on the network. Instead, it only captures\npackets on a network interface and analyses them.\n\n## Installation\n\nlistnd requires libpcap to capture packets from network interfaces. So, make\nsure you have libpcap installed. For example on a debian-based distribution:\n\n```console\n$ sudo apt install libpcap-dev\n```\n\nAfter installing dependencies you can download, build and install listnd with\nits other dependencies to your GOPATH or GOBIN (usually `~/go/bin/`) with the\ngo tool:\n\n```console\n$ go install github.com/hwipl/listnd/cmd/listnd\n```\n\n## Usage\n\nYou can run listnd with\n\n```console\n$ listnd\n```\n\nMake sure your user has the permission to capture traffic on the network\ninterface.\n\nYou can specify the network interface with the option `-i`. For example, you\ncan specify the interface `eth3` with:\n\n```console\n$ listnd -i eth3\n```\n\nCommand line options of the `listnd` command:\n\n```\n  -debug\n        set debugging mode\n  -f file\n        set the pcap file to read packets from\n  -http address\n        use http server and set the listen address (e.g.: :8000)\n  -i interface\n        set the interface to listen on\n  -interval seconds\n        set output interval to seconds (default 5)\n  -pcap-filter filter\n        set pcap packet filtering to filter\n  -pcap-promisc\n        set pcap promiscuous parameter (default true)\n  -pcap-snaplen bytes\n        set pcap snapshot length parameter to bytes (default 1024)\n  -pcap-timeout seconds\n        set pcap timeout parameter to seconds (default 1)\n  -peers\n        show peers\n```\n\nWhen listnd is running, it periodically prints the discovered devices and\ninformation it was able to gather about them to the console.\n\n## Examples\n\nRunning listnd on a small home network for a short period:\n\n```console\n$ sudo ./listnd -i eth3\n[...]\n======================================================================\nDevices: 2                                       (pkts: 5246)\n======================================================================\nMAC: 5c:49:79:fe:dc:ba                           (age: 1, pkts: 3317)\n  Properties:\n    Router: true                                 (age: 122)\n    Powerline: true                              (age: 2)\n  Unicast Addresses:\n    IP: 2001:c0ff:eec0:ffee:5e49:79ff:fefe:dcba  (age: 93, pkts: 1)\n    IP: fe80::5e49:79ff:fefe:dcba                (age: 52, pkts: 1)\n    IP: 192.168.1.1                              (age: 87, pkts: 12)\n  Multicast Addresses:\n    IP: 224.0.0.251                              (age: -1, pkts: 0)\n    IP: 224.0.0.22                               (age: -1, pkts: 0)\n    IP: 224.0.0.2                                (age: -1, pkts: 0)\n    IP: 239.255.255.250                          (age: -1, pkts: 0)\n    IP: 224.0.0.252                              (age: -1, pkts: 0)\n\nMAC: 70:85:c2:ab:cd:ef                           (age: 1, pkts: 1929)\n  Unicast Addresses:\n    IP: 192.168.1.23                             (age: 1, pkts: 1842)\n    IP: fe80::7285:c2ff:feab:cdef                (age: 52, pkts: 5)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhwipl%2Flistnd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhwipl%2Flistnd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhwipl%2Flistnd/lists"}