Daniel Doubrovkine bio photo

Daniel Doubrovkine

aka dB., CTO at artsy.net, fun at playplay.io, NYC

Email Twitter LinkedIn Github Strava

I always hated running. And now I have a open-source running blog. Most entries are automatically generated from runs recorded in Strava - I’m just too lazy to do it by hand :)

Update: if you’re going to want to copy code from here, you might want to check out slack-strava, which was inspired by this post and has a much cleaner implementation of activities and maps.

These are the implementation details.

Jekyll and Github Pages

I started with a basic Jekyll + Github Pages blog like the one you’re looking at now. You can read about the basic setup in this post. I copied everything from this blog to the new one, deleted all content and customized some logos and colors, mostly in _config.yml.

That is run.dblock.org@6e33b125.

Getting Data from Strava

I used the strava-api-v3 gem that talks to Strava’s Open API. To make this work I had to create an app on Strava and copy-paste the “public access” token from strava.com/settings/api.

client = Strava::Api::V3::Client.new(access_token: ENV['STRAVA_API_TOKEN'])

page = 1
loop do
  activities = client.list_athlete_activities(page: page, per_page: 10)
  break unless activites.any?
  activities.each do |activity|
    start_date_local = DateTime.parse(activity['start_date_local'])
    distance_in_miles = '%.2fmi' % (activity['distance'] * 0.00062137)
    time_in_hours = '%dh%02dm%02ds' % [
    average_speed = '%.2fmph' % (activity['average_speed'] * 2.23694)
    pace_per_mile = Time.at((60*60)/(activity['average_speed'] * 2.23694)).utc.strftime("%M:%S")

    # etc.

  page += 1

A lot of this “math” belongs in strava-api-v3 - maybe a good opportunity to contribute, so I opened strava-api-v3#36.

The above code is run.dblock.org@1927f128 with pagination fixed in run.dblock.org@f3eac93b.

Plotting Runs with Google Maps

Each activity comes with an encoded summary polyline in activity['map']['summary_polyline'], which can be passed directly to Google Static Maps API with the enc: prefix to render a nice image.

<img src='https://maps.googleapis.com/maps/api/staticmap?maptype=roadmap&path=enc:#{activity['map']['summary_polyline']}&key=...&size=800x800'>

Google Static Maps API requires a key that you can get from the console.

Adding Start and Finish Markers

Strava API does not unfortunately return precise-enough coordinates to plot start and finish of the runs, but we can pluck these out from the decoded polyline using the polylines gem.

require 'polylines'

summary_polyline = activity['map']['summary_polyline']
decoded_polyline = Polylines::Decoder.decode_polyline(summary_polyline)
start_latlng = decoded_polyline[0]
end_latlng = decoded_polyline[-1]

These markers are added to the map with &markers=color:yellow|label:S|#{start_latlng[0]},#{start_latlng[1]} and &markers=color:green|label:F|#{end_latlng[0]},#{end_latlng[1]} in run.dblock.org@7b25c263.

Getting Photos

By default Strava API only returns the primary photo. Call list_activity_photos to get all of them and specify size for anything other than thumbnails.

client.list_activity_photos(activity['id'], size: '600').each do |photo|
  url = photo['urls']['600']
  # ...

This is run.dblock.org@84d67788.

Generating Jekyll Pages

I wrote a Rake task that iterates over Strava activities and outputs a .md file for each run.

filename = [
].join('-') + '.md'

FileUtils::mkdir_p "_posts/#{start_date_local.year}"

File.open filename, "w" do |file|
  file.write <<-EOS
layout: post
title: "#{activity['name']}"
date: "#{start_date_local.strftime('%F %T')}"
 <li>Distance: #{distance_in_miles}</li>
 <li>Time: #{time_in_hours}</li>
 <li>Pace: #{pace_per_mile}</li>

For example, 2018/2018-01-21-run-13.34mi-1h47m18s.md is generated for a post titled #FLMH.

You can see the complete Rake task here.

Update Script

I wrote a bash script that runs rake strava:update and commits changes, if any, to Github.

To commit to Github you need a public_repo permission token. Create one in github.com/settings/tokens. Set it as GH_TOKEN.


set -e
set -o pipefail

bundle exec rake strava:update


if [ -z "$gh_token" ]
  echo "GH_TOKEN is not set. Cannot proceed." >&2
  exit 1

git config --global user.name "Run Buildbot"
git config --global user.email "dblock+run@dblock.org"
git add .
if ! git diff --quiet --staged
    git commit -m "Updated from Strava, `date +%Y/%m/%d`."
    git push "https://${GH_TOKEN}@github.com/${TRAVIS_REPO_SLUG}.git" HEAD:gh-pages
   echo "Nothing has changed! I hope that's what you expected." >&2

And configured Travis-CI to run the script in .travis.yml.

language: ruby

  - 2.4.1

  - bash ./_scripts/update.sh

    - gh-pages

This is run.dblock.org@2a08d5ec.

Travis-CI Cron

I added STRAVA_API_TOKEN and GH_TOKEN values to Travis-CI UI, then added a daily Cron job. This is because we want Travis to run an update both when code (eg. stylesheet) changes are pushed to Github and when new runs are posted to Strava.


Find my running blog at run.dblock.org, the latest code for this post at github.com/dblock/run.dblock.org and read about why I run here.