https://github.com/mjaakko/NeoStumbler

New stumbler application for contributing data to geolocation services
https://github.com/mjaakko/NeoStumbler

android geolocation mozilla

Last synced: about 2 months ago
JSON representation

New stumbler application for contributing data to geolocation services

• Host: GitHub
• URL: https://github.com/mjaakko/NeoStumbler
• Owner: mjaakko
• License: mit
• Created: 2023-10-10T03:59:49.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2024-11-03T18:59:31.000Z (about 2 months ago)
• Last Synced: 2024-11-03T19:29:54.118Z (about 2 months ago)
• Topics: android, geolocation, mozilla
• Language: Kotlin
• Homepage:
• Size: 4.18 MB
• Stars: 125
• Watchers: 7
• Forks: 11
• Open Issues: 38
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


    



[![Build status](https://github.com/mjaakko/NeoStumbler/actions/workflows/build.yml/badge.svg)](https://github.com/mjaakko/NeoStumbler/actions/workflows/build.yml) [![License](https://img.shields.io/github/license/mjaakko/NeoStumbler)](./LICENSE) [![Latest release](https://img.shields.io/github/v/release/mjaakko/NeoStumbler)](https://github.com/mjaakko/NeoStumbler/releases/latest)

# 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](https://ichnaea.readthedocs.io/en/latest/api/geosubmit2.html) (i.e. Mozilla Location Services).

## Downloads

There are two variants available:

* *full* - includes all features

* *fdroid* - does not include closed components (i.e. Google Play Services)

  * Features missing: fused location provider and automatic scanning

APKs of the application can be downloaded from [Releases](https://github.com/mjaakko/NeoStumbler/releases) page.

The *fdroid* variant is also available from [F-Droid](https://f-droid.org/packages/xyz.malkki.neostumbler.fdroid/) or alternatively from [IzzyOnDroid](https://android.izzysoft.de/repo/apk/xyz.malkki.neostumbler.fdroid). 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.

Updates for the *full* variant have to be manually checked and downloaded from the Releases page. The *fdroid* variant can be automatically updated by the F-Droid application

## Features

* Supports latest Android versions

* Collect data for cell towers, Wi-Fi access points and Bluetooth beacons

* Service for collecting data

  * Can be started automatically while moving (if using the *full* variant and Google Play Services are available)

* Map showing the areas where data has been collected

* Exporting scan data as a .zip

## Development

The application has two product flavors:

* `full` - includes all features

* `fdroid` - features dependent on closed-source components (i.e. Google Play Services) are removed

### Building

 * Build debug APK: `./gradlew buildFull` or `./gradlew buildFdroid`

 * Build unsigned release APK: `./gradlew buildFullRelease` or `./gradlew buildFdroidRelease`