Using RunKeeper with RunGap

Connecting your RunKeeper Account

To connect your RunKeeper account, select "Accounts & Settings" from the upper left menu and then "RunKeeper." 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 RunKeeper 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 or Google to connect to RunKeeper, you may not remember your password. You can reset your password by clicking the "forgot password?" link at this page: http://https://runkeeper.com/login/.

Importing your activities from RunKeeper

Unless you decided to disable importing, 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 RunKeeper by dragging the list down or tapping the refresh button in the upper right corner in the "Activities" or "Friend Feed" lists.

If you decided to disable importing when connecting the account, you must first go back to the "RunKeeper" page under "Accounts & Settings" and enable "Update Activities".

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

Viewing friends' activities on RunKeeper

Unless you decided to disable importing, RunGap will automatically start fetching a list of RunKeeper 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.

If you decided to disable importing when connecting the account, you must first go back to the "RunKeeper" page under "Accounts & Settings" and enable "Update Friend Feed".

Sharing your activities on RunKeeper

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

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

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 RunKeeper.

Exporting your RunKeeper activities to other services

Similar to sharing your activities to RunKeeper, you can share activities imported from RunKeeper directly to other services such as Garmin Connect, Endomondo, 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 RunKeeper Account

To disconnect your RunKeeper account, select "Accounts & Settings" from the upper left menu and then "RunKeeper." 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 RunKeeper.

Troubleshooting

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

The message "RunKeeper login failed!" means that RunGap is unable to login to the RunKeeper service. This is most likely a problem with your credentials or a problem with the RunKeeper service itself. If you have changed your password you will need to "Forget" and then "Login" again from the "RunKeeper" page under "Accounts & Settings." If you have lost your password you can reset it by clicking the "forgot password?" link at this page: http://https://runkeeper.com/login/.

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

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

RunKeeper scores an OK "4" for enabling users to bulk export all activity data as a ZIP file with GPX and CSV data as well as offering the "Health Graph API" to developers. The downloaded GPX files are known to contain both formatting errors as well as timezone problems. More importantly the "Policy" and "Terms of Service" for the API is very restrictive. As an example, apps that have features similar to those offered via RunKeeper's paid memberships are not allowed to use the API. Restrictions likes this makes the API less attractive and leaves plenty of room for improvement.

[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.

3 Comments

Hi
I have a situation where I was tracking a run with Runkeeper on my Apple Watch 2 ios4 . Unfortunately the data didn’t get uploaded to Runkeeper on my phone although I can see the data in Activities and Health data - is there anyway to pull this into rungap - at the moment it doesn’t import it. Thanks Nick

Hi
I have a situation where I was tracking a run with Runkeeper on my Apple Watch 2 ios4 . Unfortunately the data didn’t get uploaded to Runkeeper on my phone although I can see the data in Activities and Health data - is there anyway to pull this into rungap - at the moment it doesn’t import it. Thanks Nick