A native open-source network diagnostics app for macOS with built-in Wi-Fi analysis.
Diagnose connectivity issues, analyze Wi-Fi channel congestion, and validate roaming behavior — with results processed locally on your Mac.
Download Open-Source Edition · Get WiFi Lens Pro · Official Website
macOS 14+ · Intel & Apple Silicon · No telemetry
| Open-Source Edition | WiFi Lens Pro |
|---|---|
| Free, open source — GitHub Releases | One-time paid Mac App Store edition — Mac App Store |
| Tri-band Wi-Fi scanning & spectrum analysis | Professional monitoring workflows built on the same core analysis engine |
| Channel quality, network details, roaming tests | Spectrum session recording — capture & replay over time |
| Network Self-Check, BLE scanner, MCP server | Additional professional workflows |
| Export PNG/CSV · Sparkle updates | Persistent menu bar · Event timeline · Mac App Store updates |
Both editions share the same core Wi-Fi analysis capabilities. Pro adds spectrum recording, persistent menu bar, and event timeline for professional workflows.
🇺🇸 English | 🇩🇪 Deutsch | 🇪🇸 Español | 🇨🇳 简体中文 | 🇯🇵 日本語
WiFi Lens is a native macOS network diagnostics app built with SwiftUI, CoreWLAN, and CoreBluetooth. It helps you troubleshoot connectivity issues through network self-checks, Wi-Fi scanning, channel congestion analysis, and roaming validation. Built-in BLE scanning provides additional visibility into nearby wireless devices.
This repository contains the free, open-source edition. WiFi Lens Pro is a separate paid edition that adds spectrum recording, persistent menu bar, and event timeline features.
Typical use cases:
- 🏠 Home network tuning: Find which channel your neighbors are saturating and move your router to a quieter one.
- 🏢 Office Wi-Fi audit: Scan all three bands (2.4, 5, and 6 GHz) to spot dead zones or misconfigured APs.
- 🚶 Roaming validation: Walk through a building and record every AP handoff with a timeline chart to verify seamless transition.
- 🎧 BLE device troubleshooting: Track RSSI trends of Bluetooth peripherals and identify range or interference issues.
| Category | Capability | Edition |
|---|---|---|
| 📡 Wi-Fi Scanning | Real-time scan across 2.4, 5, and 6 GHz bands with per-network signal strength | OSS & Pro |
| 📊 Spectrum View | Gaussian bell-curve charts showing channel occupancy at a glance | OSS & Pro |
| 🎯 Channel Quality | Congestion scores with regulatory-aware recommendations tuned to your region | OSS & Pro |
| 🔍 Network Details | PHY generation, channel width, 802.11k/r/v roaming, WPA3, hidden SSID | OSS & Pro |
| 📶 Connection Info | IP, gateway, DNS, MAC, channel, Tx rate, and security summary | OSS & Pro |
| 🩺 Network Self-Check | One-click connection diagnostics — path, DNS, HTTPS, and proxy reachability, with evidence-based conclusions | OSS & Pro |
| 📈 Event Timeline | Connection event history — roaming, channel changes, disconnections, and signal drops | Pro only |
| 🔄 Roaming Test | AP handoff monitoring with a timeline chart, range selector, and session save/load | OSS & Pro |
| 🗺️ Channel Heatmap | Per-band occupancy heatmap to spot congestion patterns instantly | OSS & Pro |
| 🎬 Spectrum Recording | Capture and replay spectrum changes over time | Pro only |
| 🎧 BLE Scanner | Bluetooth LE device discovery, RSSI analysis, trend charts, and device tracking | OSS & Pro |
| 🎨 Smart Coloring | Deterministic SSID-based color assignment; the same network keeps the same color | OSS & Pro |
| 📍 Menu Bar | Lives in your menu bar — click the icon to open the analyzer anytime | Pro only |
| 🔒 Privacy First | No telemetry or analytics; Wi-Fi scan data stays on your Mac | OSS & Pro |
| 🌐 MCP Server | Embedded HTTP API on 127.0.0.1:19840 for external tool integration |
OSS & Pro |
| 🔄 Auto-Updates | Sparkle updates in the GitHub edition; Mac App Store updates in Pro | OSS & Pro |
| 📤 Export | Save per-band charts as PNG images or CSV data | OSS & Pro |
| 🌍 Localized | English, German, Spanish, Japanese, and Simplified Chinese | OSS & Pro |
All features are included in the open-source edition unless marked Pro only. Pro includes every open-source feature plus the recording, menu bar, and event timeline tools.
Native macOS UI. CoreWLAN talks directly to Wi-Fi hardware, and SwiftUI provides Mac-native controls and window behavior.
Regulatory-aware recommendations. WiFi Lens infers your regulatory domain from system locale, hardware capability, and nearby AP country codes. It filters recommendations using DFS, indoor-only, and 6 GHz AFC requirements.
Linked views. Select a network in the table to highlight it on each chart. Hover over a bell curve to identify its SSID.
Tools in the open-source edition. Export PNG and CSV files or save and load roaming sessions. The local MCP server connects WiFi Lens to your own tools.
Requires macOS 14 (Sonoma) or later. Works on both Intel and Apple Silicon Macs. 6 GHz band scanning requires Wi-Fi 6E/7 hardware.
- Open-source edition — GitHub Releases (free, with optional Sparkle auto-updates)
- WiFi Lens Pro — Mac App Store (supported regions)
Important
On macOS 14+, Location Services must be enabled for the app to read Wi-Fi SSID names. Go to System Settings → Privacy & Security → Location Services and enable WiFi Lens when prompted.
🌐 Official website: wifi-lens.shiinalabs.com provides screenshots, a feature tour, AI/MCP workflows, and an FAQ.
WiFi Lens does not collect usage analytics, crash telemetry, or Wi-Fi scan data.
- Location Services: macOS requires this permission to expose Wi-Fi SSID names. WiFi Lens does not read your GPS position.
- Region detection: WiFi Lens uses the system locale, hardware-reported channel list, and nearby AP country codes on-device.
- Network Self-Check: When you run it, WiFi Lens resolves
example.comand may test reachability of your configured proxy endpoints. - MCP server: The optional server binds to
127.0.0.1. Local tools can access scan data only after you enable it. - Update checks: The GitHub edition contacts GitHub when you request an update check or enable automatic checks.
git clone https://github.com/SHIINASAMA/wifi-lens
cd wifi-lens
git submodule update --init ChartLens
cd WiFiLens
# Build
xcodebuild -project WiFiLens.xcodeproj -scheme "WiFi Lens" -configuration Debug -destination 'platform=macOS' build
# Run tests
xcodebuild -project WiFiLens.xcodeproj -scheme "WiFi Lens" -configuration Debug -destination 'platform=macOS' -skipPackageUpdates test -only-testing:WiFiLensTests
# Open in Xcode
xed WiFiLens.xcodeprojThe product name is WiFi Lens.app (with space).
Architecture, testing, and roadmap docs live in docs/.
Bug reports and feature ideas are welcome. Open an issue or start a discussion.
Pull requests should follow the conventions in .agents/references/project/ARCHITECTURE.md and include test coverage where practical. See .agents/references/collaboration-rules.md for AI assistant guidelines if you use coding agents.
At their discretion, the maintainer may recognize substantial contributions to WiFi Lens with an Apple-issued promo code for WiFi Lens Pro. See Contributor Recognition for details.
Contact: @WiFiLens on X · wifi-lens@shiinalabs.com
Forked from tiny-wifi-analyzer by nolze, who built the original Python-based Wi-Fi scanner. Since then the app has been fully rewritten in Swift with SwiftUI and CoreWLAN, evolving into the native macOS application it is today.
Apache License 2.0 © 2020 nolze, 2026 SHIINASAMA. See LICENSE for full text.