Arduino powered stationary bike computer that uploads cycling sessions to Runkeeper's Healthgraph API
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
Schematics Updated schematics and Runkeeper screenshot to reflect their redesign Jun 12, 2013



This project provides an Arduino sketch that can power an Arduino + Ethernet Shield (or Arduino with built-in ethernet) to make a stationary bike computer that can upload Cycling workout sessions results to Runkeeper's Healthgraph API. This activity get added to the user's activities feed and could then be posted to Twitter or Facebook automatically by Runkeeper.

It doesn't need to be connected to a computer for that purpose, only a wired ethernet connection is required.

It'll also display the current speed and either the total distance or average speed or elapsed time during normal use via a LCD.

The sensor used is the reed switch that was already present in my stationary bike connected to the Arduino with a pulldown resistor.

The elapsed time only counts 15 seconds chunks when there was some activity, otherwise it'll pause automatically.

If the pause last more than 2 minutes, it'll upload to Runkeeper the:

  • Starting Time
  • Total Distance
  • Elapsed Time

for the current session. From this, Runkeeper computes the average speed, pace and total calories burned.


Plug the ethernet cable and the USB/Power cable in. The Arduino will beep once it has obtained the current time and is ready for use.

Pedal away and it'll display the current speed while cycling between the total distance. average speed and elapsed time.

Stop pedaling for ~ 15 seconds and the pause screen will come up. 60 seconds, the lcd's backlight will be switched off. 2 minutes and it'll end the session and upload the result or discard the session if the "valid activity" threshold hasn't been reached.

It'll beep every 5km by default.

To start a new session, just use the bike again, it'll start over.

In action


Device in clear enclosure Prototype during testing Stationary bike's reed switch and magnetic brake

Runkeeper screenshot

Runkeeper screenshot


You'll need:

  • Runkeeper user account
  • create a Runkeeper app to get an access token (See below)
  • Arduino Uno + Ethernet shield or equivalent
  • 16x2 LCD
  • Stationary bike with a reed switch

The reed switch needs to be plugged in Pin2 to use the Arduino's hardware interrupts.


The Fritzing Schema file is available in the Schematics directory. Here is the breadboard view:

Breadboard view


You'll need to modify/provide the MAC address and Healthgraph's access token in the config.h (that you'll copy from config.h-dist) file. You might want to change the number of meters per reed switch activation too.

How to get the access token

First, once you have your Runkeeper account go to:

Fill in the "Application Name", "Description", "Organization", select "Activity Tracking" and "Estimated Date of Publication".

You'll get a "Client ID" and a "Client Secret".

Open in your browser:

Replace XXX with your "Client ID". Authorize your application and it'll try to redirect you to an invalid page but you'll just need the authorization code you'll find in the url bar.

Now, in a shell:

curl \
-d "grant_type=authorization_code" \
-d "client_id=XXX" \
-d "client_secret=XXX" \
-d "redirect_uri=http%3A%2F%2Flocalhost%3A3001%2Fback"

Please note that the 'redirect_uri' needs to the be exact same one as before.

It'll then give you the access token you can use in your Arduino code.