Forums/Tips & Tricks

Using Endomondo with RunGap

Kristian Ottosen
posted this on March 24, 2014, 10:01

endomondo_inout.png

Connecting your Endomondo Account

To connect your Endomondo account, select "Accounts & Settings" from the upper left menu and then "Endomondo." Next, enter your email address and password and choose "Login." RunGap will now connect securely to your account and ask you if you would like to update your activities and friend feed. If you choose "Update" RunGap will start importing your activities and a list of your Endomondo friends’ activities right away. You can also choose "Disable" 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 normally use Facebook to connect to Endomondo, you may not remember your password. You can retrieve your password by entering your email address at this link: https://www.endomondo.com/forgotpassword.

Importing your activities from Endomondo

RunGap will automatically start fetching your activities 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 Endomondo by dragging the list down or tapping the refresh button from the "…" menu 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.

Viewing friends' activities on Endomondo

RunGap will automatically start fetching a list of Endomondo Friends’ activities in the background as soon as you connect your account and they will soon start appearing in the "Friend Feed" list (choose "Friend Feed" from the menu). When the initial synchronization is complete you can update the list by dragging the list down or tapping the refresh button in the upper right corner in the "Friend Feed" or "Activities" lists.

Sharing your activities on Endomondo

You can upload a single activity directly to Endomondo 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 Endomondo along with an optional message. The activity will then be uploaded to Endomondo and you will hear a "swoosh" sound when the upload is complete. If the activity already exists on Endomondo, only the title and activity type is updated.

Similarly, you can upload all your activities directly to Endomondo by choosing "Share & Export" from the upper left menu and then "Endomondo." RunGap will then upload all activities missing on Endomondo and update the titles and activity types for the rest. 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.

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

Exporting your Endomondo activities to other services

Similar to sharing your activities to Endomondo, you can share activities imported from Endomondo directly to other services such as Garmin Connect, Strava and dailymile. 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 some export features require the Swag Bag [1].

Disconnecting your Endomondo Account

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

Troubleshooting

If you see the message "Endomondo service unreachable" it means that RunGap is unable to contact the Endomondo service. This is most likely a communications problem or a problem with the Endomondo service itself. Please check your Internet connection and try to connect using the Endomondo App and the Endomondo website to verify your connection and the service.

The message "Endomondo login failed!" means that RunGap is unable to login to the Endomondo service. This is most likely a problem with your credentials or a problem with the Endomondo service itself. If you have changed your password you will need to "Forget" and then "Login" again from the "Endomondo" page under "Accounts & Settings." If you have lost your password you can retrieve it by entering your email address at this link: https://www.endomondo.com/forgotpassword.

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 "Endomondo." Next, choose "Resynchronize".

For other problems, please contact support@rungap.com.

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

Endomondo scores a poor "2" because there is no open, documented API available for third-party developers and the only approved way to export your activities is to tediously export them one by one from the Endomondo website as TCX or GPX files.

The only way to programmatically interact with your Endomondo data is via Web-scraping techniques and undocumented APIs discovered and published by third parties.

Endomondo is well known for blocking external services that accesses their users’ data – so you might want to keep a copy of your data updated in a safe place.

dataliberation.png

 

 [1] The virtual "VIP Swag Bag" contains extra features and special deals reserved for RunGap users who help pay the bills via small donations. Choose "Swag Bag" from the upper left menu to get one.