iOS App for Intervals.icu Data

Matthew_Roche · 21 April 2022 21:37

Hi all,

I am a huge fan of Intervals.icu and everything David has created here. I write apps as a hobby, and with David’s permission have created a fairly simple app called “FitnessFatigue” for iPhone allowing you to quickly see your Fitness, Fatigue and Form, as well as some overview information for individual workouts. I mostly created this as I wanted to have my Fitness, Fatigue and Form displayed on a “widget” on the Home Screen, this is also available.

Unfortunately I won’t be able to work on this app any further or add any new features as this was mostly created as a personal education project and I have a job in an entirely different field. However the code is open source and available here if anybody wishes to develop this project further.

The app itself is available here for anyone interested.

One caveat: The fitness and fatigue stats calculated for each day vary slightly from the website (usually by no more than 1). I think this is just a rounding issue that I’ve been unable to solve, but could potentially be fixed if David were able to provide this data through the API in the future (I’m well aware how busy he is…).

A screenshot of the widget is below, views of the rest of the app are available at the App Store link above.

cjazz · 22 April 2022 06:06

Hi Matt,

Thank you for posting this. This looks really good… it would be good if someone could take this on and expand it further and add an Apple Watch app as well.

thanks for sharing this with the community.

Howie · 22 April 2022 07:02

That’s pretty cool. Thanks!
I wish I could code. Anyone who is going to take this on, I get get an Error: unable to retrieve data from server.

app4g · 22 April 2022 08:41

@Matthew_Roche Cool!!

I actually had something coded up many months ago (Oct 2021 it seems). Never published, the code is still in the app, just not “used”

My Goal was just to populate this week’s summary data, Form/Fitness/Fatigue and some stats - eventually replacing what I’m using TrainingPeaks Free for.

I left the work “sitting” as the thought of the UI portion of it made my head spin… I just might poke around your UI and use that as “inspiration”, since i’m nearly done w/ my HR Target feature set, which is looking quite good if I do say so myself.

May I know your license terms?

Here’s the raw output dump which at a cursory glance, seems to tally. Tho I’ve not checked in detail in case some of the API output data has changed.

week#16 [Apr 18 - Apr 24]
 Current Load:38  Time:57m Dist:224.5 D+:0m   kJ:350  
 Current Fit :5   Fat:5   Form:0  
 Planned Fit :5   Fat:5   Form:0  

 Compliance:-
  Ride   : Load:200%[38/19] Time:77%[57m/1h 14m] Dist:100%[224/0km]
  Run    : Load:0%[0/0] Time:0%[00m/00m] Dist:0%[0/0km]
  Swim   : Load:0%[0/0] Time:0%[00m/00m] Dist:0%[0/0km]
  Others : Load:0%[0/0] Time:0%[00m/00m] Dist:0%[0/0km]
  All    : Load:200%[] Time:77%[] Dist:0%[]

====== START User Pref =========
  icuWeight:91 RestingHR:89
  0 userPref ["Ride", "VirtualRide"] - indoorFTP:100 FTP:200
  1 userPref ["Run", "VirtualRun"] - indoorFTP:123 FTP:123
  2 userPref ["Swim"] - indoorFTP:200 FTP:200
  3 userPref ["Other"] - indoorFTP:0 FTP:0
====== END   User Pref =========

=== ATL by Day ====
 "2022-04-18"	0
 "2022-04-19"	0
 "2022-04-20"	0.23
 "2022-04-21"	4.79
 "2022-04-22"	5.26
 "2022-04-23"	4.51
 "2022-04-24"	3.87
=== ATL by Day ====

  ==> Weekly Plan
       Load:["Ride": 19]
       Time:["Ride": 4440]
  ==> Weekly Real
       Load:["Ride": 38] Overall:38
       Time:["Ride": 3450] Overall:3450[57m]
       Dist:["Ride": 224569.648] Overall:224.6 km
       Elev:["Ride": 0.0] Overall:0 m
       Work:350 kJ
  ==> Weekly Target
       Time:[:]
       Load:[:]
       Dist:[:]
  ==> Weekly Zones Times
       PwrPlan    :["Ride": [3882, 258, 120, 180, 0, 0, 0]])
       PwrReal    :["Ride": [1696, 1754, 0, 0, 0, 0, 0, 0]]
       HRReal     :["Ride": [1720, 0, 0, 0, 0, 0, 1730]]
       AllPwrPlan :[3882, 258, 120, 180, 0, 0, 0]
       AllPwrReal :[1696, 1754, 0, 0, 0, 0, 0, 0]
       AllHrReal  :[1720, 0, 0, 0, 0, 0, 1730]
  ==> Compliance
       Load:["Others": 0, "Run": 0, "Ride": 200, "Swim": 0]
       Time:["Ride": 77, "Swim": 0, "Others": 0, "Run": 0]
       Dist:["Ride": 100, "Run": 0, "Others": 0, "Swim": 0]
       All :["Dist": 0, "Load": 200, "Time": 77]
 ==> Fitness Status
       FIT(CTL):["2022-04-19": 0.0, "2022-04-24": 4.59, "2022-04-22": 4.81, "2022-04-23": 4.70, "2022-04-20": 3.91, "2022-04-18": 0.0, "2022-04-21": 4.70]
       FAT(ATL):["2022-04-23": 4.5, "2022-04-21": 4.79, "2022-04-18": 0.0, "2022-04-24": 3.87, "2022-04-20": 0.23, "2022-04-19": 0.0, "2022-04-22": 5.26]
       FORM    :["2022-04-18": 0.0, "2022-04-22": -0.26, "2022-04-23": 0.18, "2022-04-19": 0.0, "2022-04-24": 0.72, "2022-04-21": 0.20, "2022-04-20": 3.76]

david · 22 April 2022 12:17

Nice! The fitness and fatigue data is now in the API. You can fetch it along with wellness data:

GET /api/v1/athlete/{id}/wellness{ext}?oldest=2022-04-20

If you use .csv then you need to supply a cols parameter: cols=atl,ctl,atlLoad,ctlLoad etc

Gerald · 22 April 2022 18:32

Well done, potential is there to add so much more.
Think of the possibility to add other metrics that give an all round score.

FelTTie · 22 April 2022 19:45

Just downloaded it, nice app and i’m keen to see more metrics there in future!

Matthew_Roche · 25 April 2022 19:11

Thanks for the feedback! I’ve just added an MIT license to the Github repository.

Matthew_Roche · 25 April 2022 19:11

Thanks for letting me know. I’ll take a look when I get a chance!

Howie · 26 April 2022 06:17

Any guess why I get this error?

Gerald · 26 April 2022 06:20

I got the same error, and then changed the settings at the authorization step to read and write. Then it works. Not sure if that is the problem, but it worked for me.

Howie · 26 April 2022 06:35

Yeah, I tried that too. Also disabled my ProtonVPN temporarily to see if that was blocking something. Still no go.

Elizabeth_Eden · 26 April 2022 20:40

Just downloaded it and its working seamlessly for me. Really clean and tidy interface too. Many thanks Matthew.

rob · 28 April 2022 22:04

Omg please let there be an android dev who could knock one of these out on that platform too.

Matthew_Roche · 29 April 2022 21:54

Hmmm. Thanks for letting me know, and sorry it doesn’t work for you. Not sure why this is happening, my best guess would be that your data is in a slightly different format to mine when it comes from the server. Do you sync from Strava or somewhere else?

Matthew_Roche · 29 April 2022 21:56

Sorry you had the same problem. The app shouldn’t need any write permissions, so maybe this was a coincidence?

Howie · 30 April 2022 06:10

All my data goes directly from the devices to Intervals.icu, or at least as directly as possible (i.e. FIT file in Dropbox if not direct sync). No Strava. No TP.

Gerald · 30 April 2022 09:45

Mine is working, after I ticked all the boxes at the login stage.

Howie · 30 April 2022 15:23

Yup, tried that.

Matthew_Roche · 30 April 2022 22:29

OK. My best guess is that the dates returned from the intervals.icu server for your activities are in a different format from those that come through Strava etc. This was a personal project so there was very limited testing and I have no remote debugging, sorry it’s not working for you.

I think I’ve probably found a work around, but would like to test it first. If you’re happy to do so could you send an example FIT file to matt@fitness-fatigue.com?

Thanks