Using Komoot with RunGap

Connecting your Komoot Account

To connect an existing Komoot account:

1. Select "Accounts & Settings" from the upper left menu. 
2. Select "Komoot."
3. Tap "Connect", enter your username and password and authorise RunGap to access your account.

RunGap will now connect securely to your Komoot account and ask you if you would like to import your completed tours right away. If you choose "Import Now" RunGap will start importing your completed tours right away. You can also choose "Maybe Later" to leave importing disabled in case you need to tweak the settings or simply leave the connection in "Write Only" mode. You can enable and disable importing as you like later.

If you have lost your password you can reset it via the "Forgot your password?" link after entering your email address here: https://www.komoot.com/login.

Importing your activities from Komoot

RunGap will automatically start fetching your completed tours in the background as soon as you connect your account and they will soon start appearing in the "Activities" list (choose "Activities" from the menu). When the initial synchronization is complete, you can fetch new activities from Komoot by dragging the list down or tapping the refresh button in the upper right corner in the "Activities" or "Friend Feed" lists.

Please note that RunGap will automatically skip duplicate activities based on starting time.

Sharing your activities on Komoot

You can upload a single activity directly to Komoot by opening it from the "Activities" list, tapping the "..." button in the upper right corner and choosing "Share." This will bring up a page where you can choose to share the activity to on or more of the most popular services including Komoot along with an optional message. 

Similarly, you can upload all your activities directly to Komoot by choosing "Share & Export" from the upper left menu and then "Komoot." RunGap will then upload all activities missing on Commit. This may take a while the very first time, but RunGap will automatically skip previously uploaded activities which have not been modified and therefore subsequent exports will complete much faster.

If you need to upload a selection of activities, you can set a filter from the upper, right "..." menu to select workouts within a specific date range, with a special type etc.. Next, choose "Use Filter" and then "Share" from the upper, right "..." to share only the workouts matching by the filter

Finally you can use Auto Sharing to share new workouts as they are imported from other services.

Please note that the Swag Bag [1] is required in order to share activities directly to Komoot.

Exporting your Komoot activities to other services

Similar to sharing your activities to Komoot, you can share activities imported from Komoot directly to other services such as Garmin Connect, Endomondo and Strava. You can also export individual or all activities in standard formats such as TCX or GPX and transfer them either directly to other apps or via Dropbox or email. Please note that most export features require the Swag Bag [1].

Disconnecting your Komoot Account

To disconnect your Komoot account, select "Accounts & Settings" from the upper left menu and then "Komoot." Next, choose "Log out" to disconnect the account. Activities, which have already been imported, will be preserved – but new activities will no longer be fetched from Komoot.

Troubleshooting

If you get error messages while fetching or posting workouts from/to Komoot, then please check your Internet connection and try to connect using the Komoot App and the Komoot website to verify your connection and the service.

In case some of your activities are missing or accidentally deleted from RunGap, you can perform a "Resynchronize" operation to restore them.  To resynchronise, select "Accounts & Settings" from the upper left menu and then "Komoot." Next, choose "Resynchronize".

If you have lost your password you can reset it via the "Forgot your password?" link after entering your email address here: https://www.komoot.com/login.

For other problems, please contact [e-mail].

Data Liberation Score

The "Data Liberation Score" is a number in the range 1–5 where 1 is poor and 5 is best. The score indicates how easy it is to access and export your hard-earned workout data from a particular service. Unfortunately it is still common practice that fitness service providers love their users so much that they can't image them leaving and either forget to put handles on the inside of the door or make the door very, very tiny. The Data Liberation Score is meant to bring some attention to this problem

Komoot scores a "4" for offering a basic API to third parties as well as the ability to export individual tours in GPX format directly from their website. 

 [1] The "Swag Bag" contains extra features and special deals reserved for RunGap users who support the development, maintenance and support of RunGap by subscribing. Choose "Swag Bag" from the upper, left main menu to get yours.