NetScope - Nearby Wi-Fi monitoring, analysis & defensive secu

项目说明

<di="center">

<img src="assets/icon.png" width="96" alt="NetScope icon" />

NetScope

Nearby Wi-Fi monitoring, analysis & defensi — for Windows desktop.

A fast, dark-first PySide6 app that scans the Wi-Fi around you, charts it over
time, maps the devices on your own network, flags security risks, and keeps a
searchable history you can export.

!Networks view

</div>

---

> Scope & ethics. NetScope is a defensi tool. It passively
> obser access points in range (like any Wi-Fi analyzer) and performs
> acti (ping sweep, port scan) **only on the network you're
> connected to / authorized to test. It does not** crack passwords, capture
> handshakes, deauth/jam, or intercept anyone else's traffic — and never will.

Features

Networks — li list with real RSSI (dBm) via the native

Windows WLAN API, color-coded security, painted signal bars, search, band and
"weak only" filters, and a per-network detail panel with a li sparkline.

Analytics — multi-network signal-o chart, per-band channel

congestion leaderboard with a recommended channel, band distribution, and an
airspace security score.

LAN — disco on your own subnet (ping sweep + ARP), real

names from the full IEEE OUI registry, on-demand TCP port/service scan, a
topology map, and a li readout.

Security — e / rogue-AP detection, per-network security scoring with

anomaly badges (Open / WEP / Hidden / Randomized-MAC / Unknown-), and a
li timeline (new / lost / encryption-changed / e).

History — persistent SQLite store across runs, lifetime stats, and one-click

CSV / PDF report export.

Settings — theme, start view, scan interval, alert behaviour, data retention —

saved to ~/.netscope/config.json.

Light and dark themes throughout. Locale-resilient (works on a Turkish Windows, etc.).

Screenshots

| Analytics | LAN / Devices |
|---|---|
| !Analytics | !LAN |

| Security | History |
|---|---|
| !Security | !History |

Run from source

> The real scanner is Windows-only (native WLAN API + netsh fallback). On other
> platforms the app runs against realistic mock data, so the UI and analysis
> are fully usable for de.

Build a Windows executable

NetScope ships as a single .exe (no Python needed to run it):

This produces dist\NetScope.exe (bundling the IEEE OUI database
and icon) and, if Inno Setup is installed,
dist\NetScope-Setup.exe. See packaging/README.md.

Tests

The architecture is deliberately layered — scanners, models, analysis, persistence
and reporting are all UI-independent and pure where possible, which is what keeps
them unit-testable without Wi-Fi hardware or a network.

Project layout

Tech

Python 3.10+ · PySide6 (Qt) · SQLite (stdlib) · ctypes (native WLAN API) ·
optional psutil for instant bandwidth · PyInstaller for packaging.

License

MIT © 2026 Berk Aslan

项目信息

开发语言：Python

Star 数：1

技术要点

该项目属于防护思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Nearby Wi-Fi monitoring, analysis & defensive security — for Windows desktop.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。