Directus Strava Extension

A directus extension to enable automatic and easy manual backup of strava activities.

• Authenticates using included Strava OAuth application
• Retrieves activity data on manual trigger and creates or updates Directus items
• Use full log in details to retrieve full activity data

Limitations

The Strava activity endpoint does not allow access to private notes or original GPX data. If you wish these to be retrieved then you can provide login details to get these from the Strava website (you can verify that these never leave the client extension).

Usage

Install

Compatible with Directus 10.x.x.

Install the extension by copying the release files to your directus extensions folder:

• Copy index.js to <directus_root>/extensions/endpoints/strava/index.js
• Copy config.js to <directus_root>/extensions/endpoints/strava/config.js

Configure the extension by editing config.js. See below for config options. You must set directusUrl for authentication to work. You must create a strava oauth application and set the clientId and clientSecret.

Then you can visit <directus_url>/strava where you can authenticate and start fetching activities.

Configure

Configuration is done in config.js. The options are:

Option	Type	Default	Description
clientId	string		Strava OAuth application client id
clientSecret	string		Strava OAuth application client secret
directusUrl	string		The full url to your directus instance
webhookSecret	string		A random secret to obfusticate the webhook url
directusAuth	boolean	true	Ensure the user has a valid directus login cookie to see the extension
collection	string	"strava"	The directus collection to insert strava data into
mapActivityToItem	function		A function that maps strava activity properties into a directus item
extensionName	string	"strava"	Extension name - should match the extension directory name
athleteEmail	string		Your strava account email - only required for retrieving "full" activities
athletePassword	string		Your strava account password - only required for retrieving "full" activities

Development

Install dependencies:

npm install

Build the extension files:

npm run build

Run an instance of Directus with the extension installed:

npm run start