Skip to content
kDolphinPublic

About

Quick Network Scanner for macOS — native LAN host discovery with MAC, vendor, hostname, and port scan

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

QNS

QNS

Quick Network Scanner for macOS

English · 简体中文

A small native Mac app for people who need a device list, not a science project.

Point it at a subnet, hit Scan, and watch a table fill in — online hosts first, then MAC, vendor, hostname, and open ports as each row gets richer. Built for hotel floors, office VLANs, and lab nets you come back to often.

Why QNS

One scan, a complete row.
You get more than “is it up?”. Each device can show IP, MAC, vendor, hostname, how it was found, and common open ports — in one place, updating live. No piping three terminal commands into a spreadsheet.

Sessions that match how you work.
Keep multiple ranges (192.168.x, 10.x, 172.x) with notes, history, and per-network gateway settings. Switch between sites without losing yesterday’s results.

MACs when you’re not on the same VLAN.
The annoying case: you can reach hosts, but your Mac’s ARP table doesn’t have their MAC. QNS tries to pull ARP from a gateway or core switch automatically, and lets you pin manual settings when you already know what works.

Honest port results.
If Surge, Clash TUN, or similar is intercepting traffic, QNS tells you — instead of printing a wall of bogus “open” ports.

Copy and export in vendor MAC formats.
Right-click any row to copy a MAC as Cisco, Windows, Unix/Linux, or Huawei — the four formats you paste into switch ACLs, DHCP, and tickets every day. Export CSV uses the same four formats for the whole scan (pick one in the sheet before saving).

Lightweight by design. Single window, Apple Silicon native, English / 简体中文 UI, offline vendor lookup, no account, no cloud. Optional Homebrew tools make it faster; they’re not required on your own subnet.

Download

Get QNS.zip from Releases → unzip → drag QNS.app to Applications.

First launch: right-click → Open (not notarized).
Allow Local Network when macOS asks.

Build

git clone https://github.com/kDolphin/QNS.git
cd QNS
bash build.sh
open build/QNS.app

Requirements

  • Apple Silicon Mac
  • macOS 14 (Sonoma) or later

In the table

Column What you see
IP Online address
MAC Hardware address when available
Vendor Manufacturer from MAC
Hostname Resolved name when available
Method How the host was found
Open ports Common ports, or a proxy warning

Plus: filter and right-click copy (IP, vendor, hostname, and MAC in four formats).

Copy & export — four MAC formats

Same address, four vendor-native spellings (example a4:5e:60:1b:2c:3d):

Format Example Typical use
Cisco a45e.601b.2c3d IOS/NX-OS ACLs, show mac
Windows a4-5e-60-1b-2c-3d DHCP reservations, AD
Unix/Linux a4:5e:60:1b:2c:3d ip neigh, scripts, Wireshark
Huawei a45e-601b-2c3d VRP MAC tables, port security
  • One device — right-click a row → Copy MAC Address → pick a format (preview shown in the menu).
  • Whole scan — Export CSV → choose the same four formats; every MAC column in the file matches.

Usage

  1. + → enter a range (e.g. 192.168.1.0/24).
  2. Scan → wait for the table to populate.
  3. Filter, right-click to copy (MAC / IP / vendor / hostname), or Export CSV with your MAC format.

Cross-VLAN MACs: right-click session → SNMP Configuration, or rely on auto-discovery.

Optional tools

brew install fping net-snmp

Quicker sweeps and stronger cross-segment MAC fill. Skip if you only scan the subnet your Mac is on.

Notes

Topic Detail
SNMP v2c auto-discovery; manual v1/v2c per session. v3 not yet.
Privacy Scans stay on your machine.

License

MIT

About

Quick Network Scanner for macOS — native LAN host discovery with MAC, vendor, hostname, and port scan

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages