/wigle-wifi-wardriving

Nethugging client for Android, from wigle.net

Primary LanguageJavaBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

WiGLE Wireless Wardriving

ci badge

Nethugging client for Android, from wigle.net.

This client provides geolocated detection and logging for WiFi, Bluetooth, and cellular signals using Android devices.

As of December 2022, this application supports Android SDK versions 19 (KitKat) and up. For older versions, see the 2.67 release tag to build your own copy or side-load the compiled artifact.

Features

  • View and map local RF signals including WiFi, Blueooth, and Cell
  • Accumulate a database of wireless signal observations
  • Search and export observed data
  • Integrate with a WiGLE.net account for competition, statistics, and online aggregation and visualization
  • See your standings and accomplishments per the WiGLE.net server

Data Export

The client offers numerous data export formats including:

  • CSV (current run, full DB, previous runs for WiGLE.net uploaders)
  • KML (current run and full DB, previous runs for WiGLE.net uploaders)
  • SQLite database (full DB)
  • GPX route data (current and previous routes)
  • Magic Eight Ball networkless geolocation artifacts

Issues and feature requests

Please use github issue tracking to report bugs and request features.

Please note: this is primarly a data collection tool - as such we aim to support the widest range of devices possible, and so advanced visualization and data management feature requests that would limit low-end device support will probably not be prioritized.

Device Support

Currently Android versions from KitKat (Android 4.4.3 / API 19) to Android 12 (API 31) are supported. Android 9 fundamentally throttled WiFi scanning support without a reliable remediation (see our forums for some possible fixes), but as of Android 10 and above, disabling WiFi scan throttling was added to the Developer Options settings menu. If you're using a modern Android OS, you should disable WiFi Scan Throttling to maximize the effectiveness of this application.

We receive various bug reports from forks/ports of Android to non-standard devices, but cannot address or test all possible variations. While we do our best to support the widest range of devices possible, the best way to get support for your device is to help us debug or to submit a pull request!

Contributing

You can submit fixes and changes for inclusion by forking this repository, working in a branch, and issuing a pull request. Langauge help and translations are VERY welcome.

We don't have a lot of contribution guidelines, but please:

  • Make sure to test your changes
  • Make sure that exporting data is the result of a direct, intentional user action, or via the Android Broadcast Intent system - don't send data off-device without user permission!
  • Please be mindful of the need for multi-language support if adding text to the UI. Google translate is enough to get people started, but please add an attempt!

Where to get it

Available on Google Play and Amazon App Store.

F-Droid (externally maintained build of the foss-master branch: https://f-droid.org/en/packages/net.wigle.wigleandroid/

How to use it

There aren't presently any official how-to guides, but a youtube search will provide tutorials. For detail on settings in the application, see https://wigle.net/wiwi_settings.

Attributions

Icon source from SVG:

This project is maintained by the WiGLE.net team