WaveDigger: Dig into wireless signals to discover their physical locations

原始链接: https://github.com/christianrowlands/wavedigger

**WaveDigger** is an interactive web tool that enables users to pinpoint the physical locations of Wi-Fi access points (via BSSID) and cellular towers (LTE/5G NR). Built with Next.js, TypeScript, and deck.gl, the application provides a responsive, map-based interface for visualizing network infrastructure. The platform functions by querying Apple’s real-time location services (WLOC API), utilizing research and protobuf definitions from the *apple-corelocation-experiments* project. Users can search for access points using various BSSID formats or look up specific cell towers using standard network parameters (MCC, MNC, TAC, and Cell ID/NCI). **Key features include:** * **Interactive Visualization:** Real-time mapping of search results. * **Search Management:** Features include automatic input validation, search history tracking, and the ability to export results as JSON or CSV. * **Regional Support:** Includes options for default and China-specific API endpoints. WaveDigger is an open-source project licensed under the GNU AGPL v3.0. You can explore the tool live at [wavedigger.networksurvey.app](https://wavedigger.networksurvey.app).

抱歉。

原文

Dig into wireless signals to discover their physical locations. WaveDigger helps you find Wi-Fi access points by their BSSID (MAC address) and cell towers (LTE and 5G NR) by their network parameters. Built with Next.js, TypeScript, and deck.gl for interactive map visualization.

A hosted version can be found at https://wavedigger.networksurvey.app.

BSSID Search: Enter a BSSID to find its approximate location
Input Validation: Automatic formatting and validation of BSSID input
- Supports formats: AA:BB:CC:DD:EE:FF, AA-BB-CC-DD-EE-FF, AABBCCDDEEFF
Cell Tower Search: Look up LTE towers (MCC, MNC, TAC, Cell ID) or 5G NR towers (MCC, MNC, TAC, NCI). NR searches return the target cell plus surrounding NR cells in the same cluster.
Interactive Map: Visualize results on a deck.gl-powered map
Search History: Track recent searches for quick access
Responsive Design: Works on desktop and mobile devices

🙏 This project would not be possible without the incredible work done by the apple-corelocation-experiments team.

WaveDigger is built upon their research and reverse engineering of Apple's location services API. Specifically, we use:

Their protobuf definitions for Apple's WLOC API
Documentation of the API endpoints and request/response formats
Understanding of coordinate encoding and API behavior
The initial bytes prefix required for valid requests

Their work in understanding and documenting Apple's undocumented location services has made it possible for projects like WaveDigger to exist. Please check out their repository for the original research and additional tools for working with Apple's location services.

Install dependencies:

(Optional) Add a Mapbox token for enhanced map tiles:
- Get a token from Mapbox
- Add it to .env.local:
```
NEXT_PUBLIC_MAPBOX_TOKEN=your_token_here
```

Running the Development Server

Open http://localhost:3000 to view the application.

Frontend: Next.js 15 with TypeScript
Map Visualization: deck.gl with react-map-gl
Styling: Tailwind CSS
API: Next.js API routes

The application uses Apple's real WLOC API to query BSSID locations. This implementation is based on the research and protobuf definitions from the apple-corelocation-experiments project.

The API implementation:

Uses protobuf for communication with Apple's servers
Sends requests to https://gs-loc.apple.com/clls/wloc
Handles coordinate conversion (Apple uses int64 with 8 decimal places)
Supports both default and China region endpoints

To test the app:

Find a real Wi-Fi BSSID (MAC address) from your router or access point
Enter it in any supported format
The app will query Apple's database and show the location if found

Note: Not all BSSIDs are in Apple's database. Newly deployed or private access points may not have location data.

Export Results: Download search results as JSON/CSV
TAC-cluster view: Browse every tower in a TAC without needing a specific Cell ID or NCI

WaveDigger is licensed under the GNU Affero General Public License v3.0. If you run a modified version of this software as a network service, the AGPL requires you to make your modified source code available to users of that service.