Spinster is an Android application that displays the availability of shared bikes in your city.
It uses the CityBikes API that provides data for more than 400 cities in around 40 countries and displays this data in a list or on an OpenStreetMap layer thanks to the osmdroid library (multiple layers are available).
Translations are managed on Weblate. Please follow these instructions if you want to help.
If you use Android Studio, you can import the project directly from GitHub.
Otherwise you can build it from the command line with
Gradle.
Clone the repo and type:
./gradlew build
(You may need to chmod +x the gradlew script)
The Gradle script will take care of downloading the necessary libraries and will generate the APK's
in app/build/outputs/apk.
The following permissions are needed by Spinster (those are the same that are required by osmdroid):
- ACCESS_COARSE_LOCATION
- ACCESS_FINE_LOCATION
- ACCESS_WIFI_STATE
- ACCESS_NETWORK_STATE
- INTERNET
- WRITE_EXTERNAL_STORAGE
Internet access is needed to download the map tiles and the stations. Location access is only used to locate you on the map. Access to the SD card is required by osmdroid to cache the tiles.