Skip to content

A little script which runs in Scriptable Widget to display your latest Strava activity. ✌️

Notifications You must be signed in to change notification settings

vmarquar/strava-scriptable-widget

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 

Repository files navigation

Strava Scriptable Widget

A simple script to display your latest Strava activity inside a Scriptable widget. To display your latest activity, you'll need a Strava Developer account. I've created a little Shortcuts workflow to help you with your needed credentials.

1. Create a Strava Developer Account

This is free but mandatory in order to get every data correctly. So head over to Strava Developer to and create a new app. Let's call it Scriptable Widget. Please fill out everything you see and yes, Strava wants you to put in an image. This can be a photo of your last piece of pizza! 🍕

  1. Create a new Strava App

  2. Fill out every detail (As website, you can use your own or something like https://sampleapp.strava.com)

  3. Set call-back domain to developers.strava.com

When you're done, you should be able to see your ClientID and Client Secret

2. Run the Shortcuts Workflow

Download this Shortcut and paste your Client ID and Client Secret. If you're a first time user of Shortcuts, you need to run a basic shortcut once, switch to your phone's settings > shortcuts and allow to run other scripts. Afterwards the script should run fine.

What's going to happen:

After you entered your Client ID and your Client Secret the shortcut opens Safari and tells you to authenticate your app, after a successful authentication you'll see an empy Safari page this is intended and not a bug! You need to copy this page by tapping on the little share-sheet icon in the bottom right corner and select Copy. When you copied the page, press done in the upper left corner. The Shortcut now creates everything you need and passes the parameters to your clipboard. Now you're ready to go.

3. Install the Widget

Download and install strava.js to you and place the small widget on your homescreen. Long-tap the widget and select Edit "Scriptable" . For Script select the Strava Script you just created, for Parameters past the Parameters you just created with the Shortcut. (They should be in your clipboard).

Changelog

Version 1.0.0

  • Added support for Strava's highlight image You can set this to false, if you don't want to display a picture

  • Better error handling To check whats happening, you can see the console and get a more detailed output of which data source is currently in use.

  • Added offline fallback for image + json data In some cases, when the celluar data is weak, you won't be able to see a picture, if the picture comes from an online source. Now, as a fallback, it's saved in iCloud.

Version 1.1.0

  • Added new medium sized widget that shows you weekly statistics The medium sized widget will be automatically selected if you set up your size accordingly.

Troubleshooting

If there is any error, it might get caused because the API endpoint is not available, when the widget tries to pull data from Strava. In order to check the API status, please visit Strava Server Status.

Next Steps

  • Offline fallback, if API is offline

  • Highlight Image as background

  • Medium and Large Widget?

About

A little script which runs in Scriptable Widget to display your latest Strava activity. ✌️

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%