If you want to actively develop this project - use standard github way - i.e. fork the repo and issue pull requests
- if you want to add new functionality - name branch with feature. i.e feature/new-map-handling etc.
- if you want to fix some bug or issue - name branch with fix or issue i.e. fix/dir-not-loading or issue/map-too-big
Always add issue number (if exists for your stuff) in commit message like [Issue #123] your commit description
Etrex-uploader is a software for directly uploading your gps tracks from usb-cable connected Garmin devices, like Etrex etc. It is also a swift Strava activities viewer, which allows you to view your strava activities and gps tracks on selected maps. The application comes with OpenStreetMap support only, but you can place other map-definition files in the maps directory, to use whatever you like best. Application is mostly fully configurable. You need to have a Strava account, obviously ;)
Here's a simple screenshot of the application's main window.
Here's the simple screenshot of configuration options for the user
This software needs configuring your Strava account for API usage. It is not normally used but if you want to use Strava remotely via the API (like this application does) you need to setup your own API application. Go to https://www.strava.com/settings/api, setup your API Application, and use the application client secret and id in the initial etrex-uploader setup dialog. Important: when configuring your api application, for callback domain set localhost, since the app collects the changed autorization token with all your permissions from the callback url via local webserver auth interceptor.
Application should work on Linux, Windows 64bit and MacOSX. I only use Linux during development, and sometime have a chance to run the code on Win and Mac, but it is not very frequent hence I cannot test all variants on a regular basis, so if you find that something does not work on Windows or Mac, file an issue.
This application runs and builds with Java 17 at the moment.
Lower Java versions are not supported anymore, and higher ones are not tested yet.
Use java 17!
To run the application outside the development environment
- mvn clean package in the source dir, this will create target/etrex-uploader.zip file
- Unpack this file to some location on your local computer
- cd to that location
- run it: java -jar etrex-uploader.jar
Binary releases are planned, so you'll just need to download the executable/runnable artifact. No building, no tuning. Download and run.
