WiFi Lens

The complete Mac Wi-Fi troubleshooting workflow.

WiFi Lens Pro combines live Wi-Fi analysis, network diagnostics, continuous monitoring, Timeline history, Statistics, and Insights in one native macOS app.

Get WiFi Lens Pro  ·  Official Website

macOS 14+  ·  Apple Silicon & Intel  ·  No telemetry

🔒 Local-first privacy — No accounts, no cloud, no telemetry
🩺 Evidence-based diagnostics — Explainable path, DNS, HTTPS, and proxy checks
🤖 MCP for AI workflows — Connect compatible clients to live Wi-Fi data on your Mac

_{This repository hosts the open-source edition of WiFi Lens for live local analysis, development, source inspection, and community contributions.}

🇺🇸 English · 🇩🇪 Deutsch · 🇪🇸 Español · 🇫🇷 Français · 🇨🇳 简体中文 · 🇯🇵 日本語

Why WiFi Lens Pro · Core Capabilities · Editions · AI / MCP · Open-source edition · Privacy · Get WiFi Lens · Development · Contributing · License

Live diagnostics tell you what is happening now. WiFi Lens Pro keeps the story going when a problem is intermittent: it observes, records, preserves history, and helps you investigate what happened later.

WiFi Lens Pro is the complete edition. It connects the live analyzer with monitoring, history, and investigation instead of treating them as separate tools.

Network Self-Check

Event Timeline (Pro)

Wi-Fi problems often disappear before you can inspect them. WiFi Lens Pro helps you keep evidence across a drop, roam, or signal change so you can review the event and the surrounding network conditions later.

Get WiFi Lens Pro →

WiFi Lens brings the essential tools for understanding a local Wi-Fi environment into one native Mac app.

WiFi Lens Pro is the complete edition. It is a one-time purchase from the Mac App Store for users who need continuous observation, recording, history, and investigation.

The open-source edition provides a substantial subset of live analysis capabilities for users who prefer GitHub distribution or want to inspect and contribute to the codebase. Get it from GitHub Releases.

Both editions are local-first. The difference is the workflow around the live analyzer: Pro adds the context needed to monitor, preserve, and investigate problems over time.

WiFi Lens includes an embedded MCP server that lets compatible AI assistants read your local Wi-Fi data. Enable it in Settings, choose Copy AI setup prompt, and paste the prompt into an MCP-compatible desktop client such as Codex Desktop or Claude Desktop.

{
  "mcpServers": {
    "wifi-lens": {
      "url": "http://127.0.0.1:19840"
    }
  }
}

For manual setup, use the format your client expects:

# Codex: ~/.codex/config.toml
[mcp_servers.wifi-lens]
url = "http://127.0.0.1:19840/"

// Claude Desktop and other JSON-based clients
{
  "mcpServers": {
    "wifi-lens": {
      "url": "http://127.0.0.1:19840/"
    }
  }
}

Once connected, ask your assistant things like "What channels are congested near me?" or "Which nearby networks support WPA3?". The server binds to 127.0.0.1 only — nothing leaves your machine unless you deliberately route it elsewhere.

See the AI Workflows guide for more examples.

The open-source edition is available for local analysis, development, source inspection, and community contributions.

• GitHub Releases — Download the latest release
• Homebrew — brew tap ShiinaLabs/apps && brew install --cask ShiinaLabs/apps/wifi-lens
• Source code and documentation — Browse the repository and architecture docs

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 GPS position.
• Region detection: Uses system locale, hardware-reported channel list, and nearby AP country codes on-device.
• Network Self-Check: Resolves public endpoints (www.apple.com, www.msftconnecttest.com) and may test reachability of configured proxy endpoints.
• MCP server: Binds to 127.0.0.1 only. Local tools access data only after you enable it.
• Update checks: The GitHub edition contacts GitHub when you request an update check or enable automatic checks.

📋 Security Policy · 📝 Changelog · ❓ FAQ · 🌐 Full privacy policy

Requires macOS 14 (Sonoma) or later. Works on both Intel and Apple Silicon. 6 GHz scanning requires Wi-Fi 6E/7 hardware.

The complete edition for continuous monitoring, recording, history, and investigation. Get it from the Mac App Store.

For GitHub distribution and community development:

• GitHub Releases
• Homebrew: brew tap ShiinaLabs/apps && brew install --cask ShiinaLabs/apps/wifi-lens
• Source code: this repository

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 unit tests
xcodebuild -project WiFiLens.xcodeproj -scheme "WiFi Lens" \
  -configuration Debug -destination 'platform=macOS' \
  -skipPackageUpdates test -only-testing:WiFiLensTests

Architecture docs live in docs/.

Questions, bug reports, and feature ideas are welcome. See Contributing Guidelines for setup, pull request conventions, and localization requirements.

Join Rabbit Hole, a small community for WiFi Lens and other projects.

Contact: @WiFiLens on X · wifi-lens@shiinalabs.com

Forked from tiny-wifi-analyzer. MAC vendor data from the IEEE Registration Authority — see Third-Party Notices.

Apache License 2.0 © 2020 nolze, 2026 SHIINASAMA — see LICENSE.