NeoStumbler

NeoStumbler is an Android application for collecting locations of cell towers, Wi-Fi access points and Bluetooth beacons to geolocation services, which have an API compatible with Ichnaea (i.e. Mozilla Location Services) such as beaconDB.

Downloads

Tip

See the user guide for more details on how to use NeoStumbler

There are three variants available:

• fullDefault - includes all features
• fullGplay - includes all features (except automatic scanning) and complies with Google Play store policies
• fdroidDefault - does not include closed components (i.e. Google Play Services)
  • Features missing:
    • Fused location provider
    • Automatic scanning based on activity recognition
    • Cronet HTTP engine

You can install NeoStumbler either from an app store or by downloading an APK from Releases page. Versions marked as pre-release are release candidates for the next version of NeoStumbler. These versions should generally be usable, but might have some bugs, UI / UX issues and missing translations.

If you install NeoStumbler directly from an APK, you need to check for updates manually or use a tool such as Obtainium

App stores

The fdroid variant is available from F-Droid or alternatively from IzzyOnDroid. Reproducible builds are used for building NeoStumbler on F-Droid, which means that it's possible to upgrade an existing installation to a newer version from an alternative source.

The full variant is available from Accrescent. The advantage of using Accrescent is that only the assets needed for your device are downloaded.

A modified version of the full variant is also available on Google Play. This version does not include the automatic scanning feature and contains some minor quirks to comply with Google Play policies.

Features

• Supports latest Android versions
• Collect data for cell towers, Wi-Fi access points and Bluetooth beacons
  • Data collection can be started automatically while moving (if using the full variant with Google Play Services)
• Scanning can be automatically paused when not moving
• Map showing the areas where data has been collected
• Exporting scan data as CSV files or as a raw SQLite file

Development

The application has three product flavors:

• fdroidDefault - no closed components, features dependent on closed-source components (i.e. Google Play Services) are not included
• fullDefault - includes closed components, no features missing
• fullGplay - based on fullDefault, but has some minor differences to make it compliant with Google Play requirements

Building

• Build debug APK: ./gradlew :app:assembleFullDefaultDebug or ./gradlew :app:assembleFdroidDefaultDebug
• Build release APK: ./gradlew :app:assembleFullDefaultRelease or ./gradlew :app:assembleFdroidDefaultRelease
  • Note that by default this will build a signed APK
    • This needs a Java keystore file named keystore.jks in the project root directory and setting values for environment variables (see app/build.gradle.kts)
    • Alternatively, to build an unsigned APK, remove signingConfigs block from app/build.gradle.kts

Contributing

Contributions from the community are welcome and encouraged. Easiest ways to contribute are to create and update translations and to create bug reports. Requests for new features are welcome as well. If you want to implement a new feature, please create an issue first if there's some design or planning needed

Translations

Weblate is used for translations. If you want to add translations for your language or to update existing translations, you can do that easily from Weblate. If you prefer, you can also update translations via a PR

Note that once you've finished translating a new language, it needs to be enabled in the build configuration. See this commit for an example