Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mjaakko/NeoStumbler

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

android geolocation mozilla

Last synced: 3 days ago
JSON representation

New stumbler application for contributing data to geolocation services

Awesome Lists containing this project

README

        


Get it on F-Droid

[![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`