Professional Wi-Fi diagnostics, network analysis, coverage mapping, and Help Desk reporting for macOS.
WiFi Diag Report is a free macOS application designed for Wi-Fi and network diagnostics, system information retrieval, coverage analysis, and technical troubleshooting.
Built for IT professionals, Help Desk teams, students, and power users, the application can analyze a Mac's connectivity, scan surrounding wireless networks, monitor signal quality, test network performance, map Wi-Fi coverage, and generate detailed diagnostic reports.
System Requirement: macOS 13.0 (Ventura) or newer.
WiFi Diag Report enables IT staff to perform Wi-Fi tests and export detailed reports that can help identify interference, weak coverage, performance problems, configuration issues, and other potential causes of connectivity problems.
In my current environment at a small college, we use a customized version of WiFi Diag Report designed specifically for student troubleshooting.
Advanced IT-level tools can be hidden while still allowing students or other end users to:
- Run approved Wi-Fi and network diagnostics.
- Collect device and connection information.
- Generate a standardized diagnostic report.
- Email the report to the Help Desk.
The report gives IT staff a useful technical baseline before dispatching a technician or an IT-managed computer to the reported location for comparison testing.
This helps determine whether a problem is related to:
- The student's device
- Wi-Fi signal strength
- Access point coverage
- Network performance
- Wireless interference
- Device hardware capabilities
- Configuration
- The surrounding RF environment
Feature visibility can be controlled through the application's Configuration.plist, allowing organizations to create simplified deployments without maintaining a separate application build.
WiFi Diag Report is part of a larger collection of Wi-Fi diagnostic tools I have developed for PowerShell, Windows, macOS, and iOS/iPadOS.
The goal is to provide similar Wi-Fi troubleshooting and reporting capabilities across platforms while taking advantage of the networking APIs available on each operating system.
| Platform | Project | Access |
|---|---|---|
| 🖥️ PowerShell | PS Wi-Fi Analyzer | GitHub |
| 🪟 Windows | WinWiFiAnalyzer | GitHub |
| 📱 iOS / iPadOS | Wi-Fi Analyzer Beta | Apple TestFlight |
| 🍎 macOS | Wi-Fi Analyzer — Windows-style UI | Download DMG |
| 🍎 macOS | WiFi Diag Report | This Project |
PS_WI-FI_Analyzer provides Wi-Fi diagnostics and reporting directly through Windows PowerShell.
It is designed for administrators and technicians who want a lightweight script-based diagnostic tool without requiring a full graphical application.
Repository: https://github.com/hov172/PS_WI-FI_Analyzer
WinWiFiAnalyzer provides a graphical Windows application for Wi-Fi diagnostics, network analysis, troubleshooting, and reporting.
Repository: https://github.com/hov172/WinWiFiAnalyzer
The iOS/iPadOS version is currently available for beta testing through Apple TestFlight.
Join the Beta: https://testflight.apple.com/join/hDPGsHzd
Because Apple restricts access to certain low-level Wi-Fi information on iOS/iPadOS, some diagnostics available on Windows and macOS cannot be implemented identically on iPhone or iPad.
A separate macOS Wi-Fi Analyzer is available that follows the layout and workflow of WinWiFiAnalyzer, providing a more consistent interface for users moving between Windows and macOS.
Download DMG: https://github.com/hov172/WinWiFiAnalyzer/releases/download/Windows_Wifi_Report/Wi.Fi.Analyzer.dmg
An IT team member can survey an area with reported Wi-Fi problems and generate a coverage-map report containing collected measurements and visual coverage information.
Example WiFi Coverage Map Report
Students or other non-IT users can generate a simplified diagnostic report and send it directly to the Help Desk.
-
Multi-AP Capture — Every measurement point can perform a background scan and store all visible APs, including:
- SSID
- BSSID
- RSSI
- Channel
- Band
-
Heatmap Layers — Switch between:
- Connected network
- Individual access points
- AP overlap zones
-
Overlap Visualization
- 1 usable AP
- 2 usable APs
- 3+ usable APs
- Uses a ≥ −70 dBm usable-signal threshold
-
Band Filtering — Analyze AP overlap independently for:
- 2.4 GHz
- 5 GHz
- 6 GHz
-
Sticky Point Selection — Selected survey points remain highlighted across map views.
-
Layer-Aware Reports — Coverage-map PDF and print reports follow the currently selected heatmap layer.
-
Full-Screen Quick Add — Add measurement points directly from the full-screen map.
- Correct macOS App Sandbox entitlements
- Outgoing network access
- Location support
- User-selected file access
- Correct Info.plist processing
- Improved App Store validation compatibility
- Sandbox-safe scanner CSV exports
- Removed unnecessary ATS arbitrary-load exceptions
When ICMP testing is unavailable because of App Sandbox restrictions, WiFi Diag Report can fall back to UDP DNS round-trip measurements.
Tests clearly identify UDP-based measurements instead of presenting them as ICMP results.
If no valid measurement can be collected, the application reports:
Test Failed
rather than generating misleading packet-loss results.
Scan surrounding wireless networks and analyze:
- SSID
- BSSID
- RSSI
- Signal quality
- Channel
- Band
- Security
- Nearby networks
- Channel congestion
- Multi-AP environments
- Potential roaming conditions
Scan information can also be exported for additional analysis.
Monitor the active Wi-Fi connection continuously.
Metrics include:
- RSSI
- Noise
- SNR
- TX rate
- Signal quality
- MCS Index
- Spatial Streams / NSS
- Channel width
- PHY mode
Measurements update approximately every 1 second.
Up to 300 measurements / 5 minutes of recent data can be retained for visualization.
Available views include:
- Last 1 minute
- Last 5 minutes
- All collected data
Monitoring sessions can be exported to CSV.
Upload a floor plan and perform an interactive Wi-Fi site survey.
Supported floor-plan formats include:
- PNG
- JPEG
- SVG
- TIFF
Measurement points can collect:
- RSSI
- Noise
- SNR
- Channel
- Band
- MCS Index
- Spatial Streams / NSS
- Channel width
- PHY mode
- Timestamp
- Location information
- Visible AP information
Coverage points can be created using:
- Manual coordinates
- Click-to-select
- Live mouse tracking
- Grid Assistant
Maps support:
- Zoom
- Pan
- Rotation
- Point selection
- Point renaming
- Point details
- AP information
- Measurement deletion
- Saved map state
Saved projects preserve map positioning and measurement information.
WiFi Diag Report can generate interpolated signal heatmaps from collected measurement points.
Heatmaps use measured RSSI information to visualize wireless coverage across a floor plan.
Available visualization layers include:
Displays signal coverage for the currently connected network.
Select a specific BSSID/AP and visualize its measured coverage.
Visualize areas where multiple usable APs overlap.
Band filtering allows overlap analysis to be restricted to:
- 2.4 GHz
- 5 GHz
- 6 GHz
This prevents multiple radios from the same multi-band deployment from artificially inflating AP overlap counts.
Heatmaps can also be included in exported coverage-map reports.
WiFi Diag Report performs real network measurements rather than simulated results.
HTTP throughput measurements can be performed using multiple concurrent network streams.
Latency testing measures network round-trip performance and can report:
- Average latency
- Jitter
- Test method
Packet-loss testing evaluates whether expected responses are successfully received.
When sandbox restrictions prevent ICMP measurements, supported tests can use UDP-based network measurements instead.
Failed tests are reported as failures rather than generating fabricated results.
The IT Analysis Engine converts collected technical information into structured diagnostic findings.
It is designed specifically for:
- Help Desk technicians
- Desktop support
- Network administrators
- IT managers
- Higher-education IT environments
Provides:
- Overall network health assessment
- High-level findings
- Major problems
- Positive observations
- Risk assessment
Evaluates:
- RSSI
- Signal quality
- SNR
- Signal stability
- Coverage
- Potential roaming readiness
Evaluates:
- Download performance
- Upload performance
- Latency
- Jitter
- Packet loss
- Connection reliability
Evaluates:
- Nearby networks
- Channel congestion
- Wireless interference
- Security
- Band utilization
- Optimization opportunities
Evaluates:
- Wi-Fi standard
- MCS capability
- Spatial streams
- Channel width
- Device limitations
- Hardware efficiency
- Potential upgrade opportunities
Diagnostic findings can generate prioritized recommendations.
Problems requiring immediate attention.
Important problems likely to have a significant effect on connectivity or performance.
Recommended optimizations that may improve reliability or performance.
Optional improvements and best-practice recommendations.
Recommendations can include:
- Technical details
- Measurements
- Explanation
- Troubleshooting actions
- Suggested remediation
Categories include:
- Signal
- Security
- Performance
- Hardware
- Environment
- Configuration
Modulation and Coding Scheme (MCS) provides information about the modulation, coding rate, spatial streams, and potential data rate of a Wi-Fi connection.
Supported analysis includes Wi-Fi 4, Wi-Fi 5, and Wi-Fi 6 environments.
The Number of Spatial Streams helps identify the MIMO capabilities being used by the connection.
More spatial streams can provide greater potential throughput when supported by both the client and access point.
WiFi Diag Report can identify common channel widths including:
- 20 MHz
- 40 MHz
- 80 MHz
- 160 MHz
The application can identify supported/current Wi-Fi PHY information including:
- 802.11n / Wi-Fi 4
- 802.11ac / Wi-Fi 5
- 802.11ax / Wi-Fi 6
WiFi Diag Report can export diagnostic information in multiple formats for different audiences.
Reports can include:
- Device information
- Network configuration
- Wi-Fi connection information
- Signal measurements
- Nearby network scans
- Speed-test results
- Latency
- Packet loss
- Advanced Wi-Fi metrics
- Coverage-map measurements
- Heatmaps
- IT Analysis findings
- Recommendations
End-User / Student Report
Designed to provide Help Desk technicians with the information needed to begin troubleshooting.
IT Technical Report
Provides detailed measurements and technical findings.
Executive Summary
Provides higher-level network-health information and major findings.
Coverage Map Report
Combines floor plans, survey points, signal information, statistics, and optional heatmaps.
The automated diagnostic workflow can run multiple tests and collect information in a single operation.
The interface provides:
- Confirmation before starting
- Full-screen progress display
- Concurrent network testing
- Real-time progress
- Result summaries
- Export options after completion
WiFi Diag Report can be customized for different types of users without creating separate builds.
The application reads:
WifiDialogReport/Configuration.plist
Feature visibility is controlled using HideXXXX configuration keys.
For example:
<key>HideAdvancedTools</key>
<true/>A value of:
<true/>hides the associated feature.
A value of:
<false/>makes the feature available.
This allows organizations to create different experiences for:
- Students
- Faculty
- Staff
- Help Desk technicians
- Network administrators
- IT administrators
while maintaining the same application.
- macOS 13 Ventura or newer
- Wi-Fi enabled
- Location permission for Wi-Fi scanning
- Network access for performance testing
- Additional permissions where required by macOS
- Launch WiFi Diag Report.
- Review the Dashboard.
- Verify device and network information.
- Scan surrounding Wi-Fi networks.
- Start real-time signal monitoring.
- Run network performance tests.
- Run the automated diagnostic workflow.
- Review IT Analysis findings.
- Generate a diagnostic report.
- Open Coverage Mapping.
- Import a floor plan.
- Select a measurement method.
- Move to the first physical survey location.
- Add a measurement point.
- Allow WiFi Diag Report to collect Wi-Fi/AP information.
- Continue through the survey area.
- Enable the signal heatmap.
- Select the desired AP or overlap layer.
- Review coverage and overlap.
- Generate the coverage-map report.
If Wi-Fi scanning does not work:
- Verify Wi-Fi is enabled.
- Verify Location Services are enabled.
- Grant requested permissions.
- Restart the application after changing permissions if necessary.
If surrounding networks are not detected:
- Verify Wi-Fi is active.
- Refresh the scan.
- Check macOS privacy permissions.
- Check for VPN or security restrictions.
If a floor plan cannot be loaded:
- Verify the file format.
- Check file permissions.
- Verify sufficient available disk space.
If an export fails:
- Verify the destination is writable.
- Check available disk space.
- Select another destination.
- Try another supported export format.
Some network tests may behave differently when the application is running inside the macOS App Sandbox.
When ICMP access is unavailable, supported diagnostics can automatically use an alternate UDP-based measurement.
The application identifies the measurement method in the results.
WiFi Diag Report is built using native macOS technologies including:
- Swift
- SwiftUI
- CoreWLAN
- Apple networking frameworks
- Swift Charts
- macOS system information interfaces
The application uses background processing where appropriate to avoid blocking the user interface during network collection and diagnostic operations.
- macOS 13+
- Xcode
- Swift / SwiftUI development environment
- Clone the repository.
- Open
Wifi Diagnostics Report.xcodeprojin Xcode. - Configure signing if required.
- Build and run.
Contributions are welcome.
Areas of interest include:
- Wi-Fi analysis
- Coverage mapping
- Network diagnostics
- Additional reporting formats
- Performance improvements
- UI/UX improvements
- Accessibility
- Help Desk integration
- Cross-platform feature parity
Bug reports, feature requests, documentation improvements, and code contributions are welcome through GitHub.
- GitHub
- PowerShell Gallery
- 📨 Slack: @Hov172
- 🕹️ Discord: Jay172_
- Twitter / X — @AyalaSolutions
- Bluesky — @AyalaSolutions
- Buy Me a Coffee
For questions, issues, and feature requests, please use the project's GitHub Issues or Discussions.
If you find these tools useful, consider giving the repositories a ⭐ on GitHub.
It helps support continued development of the PowerShell, Windows, macOS, and iOS/iPadOS Wi-Fi diagnostic tools.