Welcome to the segment leaderboard creator, the best tool ever for creating leaderboards during segment challenges. What's that you say? I should be using Strava APIs instead of parsing HTML and copying cookie files from a browser? Sounds great! Let me just check ... oops looks like NO

So yeah, in the absence of doing things in a proper way, I wrote this instead! The goal of this tool is to create a leaderboard for segment challenges. These are events where riders ride a variety of segments. Each rider is given a certain number of points depending on their place on the segment. The total on all segments is then summed to get the total points for each rider. Then we sort by total, and voila, leaderboard.

The tool takes as input a JSON configuration file with a list of segments and configuration options. It allows for multiple runs, that is, different outputs with different options.

Format is as follows. Comments are to describe the fields, but obviously you can't copy them since json doesn't allow comments.

{
    # A list of segment ids that you want to be on the leaderboard. These are strings.
    "segments": ["1", "2"],

    # The number of points assigned to each rank on the leaderboard per segment. So in this example
    # first place gets ten, second five, and third one.
    "points": [ 10, 5, 1],

    # The number of points a participant gets just for doing a segment. This is added to
    # the points they receive for placing. So in this example, first place would receive
    # 10   1 = 11 points.
    "participation_points": 1,

    # The number of points a participant gets just for doing the segment if they don't
    # rank in the points list. That is, if the points list length is 3 and they come in
    # fourth, they get this many points.
    "unmatched_participation_points": 1,

    # The list of run configurations to do. Each one allows for a different set of options
    # and output files.
    "runs": [
      {
        # The name of the file that where you want the data output.
        "output_file": "WomenRankingsThisMonth.txt",

        # The additional URL parameters for this configuration.
        # This one says "Overall list for all women in the past month". This
        # can be a list in which case the results are combined. This is useful if
        # you want to create a category like "masters" which is 40 , but Strava
        # only supports querying in age group buckets of ten.
        "options": ["filter=overall&date_range=this_month&gender=F"]
      },
      {
        "output_file": "OverallToday.txt",
        "options": ["filter=overall&date_range=today"]
      }
    ]
}

Take a look at the august_neighborhood_segment_challenge.txt file in the examples folder for a detailed working example.

The cookie file is in standard netscape/mozilla format. You'll need to install the cookies.txt chrome extension to get this information

This assumes you have the cookies.txt chrome extension and python installed

1. Open strava.com and login if you haven't
2. Open the cookies.txt extension and download the cookies for that page, let's call it "stravacookies.txt"
3. Run the program python leaderboard.py examples/august_neighborhood_segment_challenge.txt stravacookies.txt
4. Bask in the glory of your fully armed and operational leaderboard

The output format is a CSV file with athlete_name, total_points, total_num_segments as the fields