An Android app for viewing and managing your Nextcloud Maps geofavorites (location bookmarks) on your mobile device.
This is a maintained fork of the original Nextcloud Maps Geofavorites app by penguin86. The original project has not received updates in several years, so this fork provides continued maintenance, bug fixes, and new features.
Key differences from the original:
- Active maintenance - Regular bug fixes and updates to keep the app working with modern Android versions
- Additional map app support - Now supports opening locations in OpenStreetMap and Apple Maps apps, not just Google Maps
- Google's Material 3 Design - Now utilizes Material 3 components for a more modern feel on Android and to eventually use for dynamic system colors and Nextcloud instance colors (both not yet implemented)
- Automated builds - GitHub Actions automatically builds and signs releases on every commit to the main branch, making it easy to install and update via Obtainium
- Updated package name - Uses
com.nickgirga.nextcloudmapsgeofavoritesinstead of the original package name
This app connects to your Nextcloud server and allows you to:
- View your geofavorites - See all location bookmarks you've saved in Nextcloud Maps, displayed either as a scrollable list or on an interactive map
- Create new geofavorites - Save new location bookmarks in three ways:
- From your current GPS location
- By manually selecting a point on the map
- By sharing a geographic link (geo: URI) from another app to Nextcloud Maps Geofavorites
- Open locations in map apps - Tap any geofavorite to open it in your preferred navigation or mapping app (Google Maps, Organic Maps, OpenStreetMap, Apple Maps, etc.)
- Manage your bookmarks - Edit, delete, and organize your saved locations
Requirements:
- A Nextcloud server with the Maps app installed
- An Android device running Android 5.0 (API level 21) or higher
Obtainium is an app that allows you to install and update apps directly from their source repositories.
- Install Obtainium from F-Droid or GitHub
- In Obtainium, add this app using the repository URL:
https://github.com/nickgirga/nextcloud-maps-geofavorites-android(if using GitHub actions, enable prereleases) - Obtainium will automatically notify you of and install new releases
Every commit to the main branch of this repository triggers an automatic build, so you'll receive updates frequently if using prereleases.
- Go to the Releases page
- Download the latest APK file
- Install the APK on your Android device (you may need to enable "Install from Unknown Sources" in your device settings)
- Check the Releases page periodically for new versions
If you want to build the app yourself:
-
Clone this repository:
git clone https://github.com/nickgirga/nextcloud-maps-geofavorites-android.git cd nextcloud-maps-geofavorites-android -
Build using Android Studio (recommended) or Gradle command line:
./gradlew assembleRelease
-
The built APK will be in
app/build/outputs/apk/release/
This app's codebase is based on:
- The original Nextcloud Maps Geofavorites app by tfederico - Provided the initial app implementation
- matiasdelellis's Nextcloud SSO example - Demonstrated how to implement Nextcloud Single Sign-On authentication
- The forked Nextcloud Maps Geofavorite app by penguin86 - Implemented Single Sign-On; maintained until bd8a0d7 on Feb 29, 2024
This project is licensed under the same license as the original project. See the LICENSE file for details.
Contributions are welcome!
- Bug reports: Open an issue describing the problem and steps to reproduce it
- Feature requests: Open an issue explaining what you'd like to see added and why
- Code contributions: Fork the repository, make your changes, and submit a pull request
For questions or issues, please use the GitHub Issues page.