Intervals.icu

A Python/Powershell script to send training events from a JSON file to the Intervals.icu API. This script automates the process of uploading training schedules for athletes.

Features

• Uploads multiple training events in bulk to the Intervals.icu calendar.
• Supports cycling, swimming, and running workouts.
• Easy-to-configure JSON input file for flexible scheduling.
• NEW: Supports repeated intervals using "reps" and "steps" blocks in the JSON file.
• NEW: Each step can include "intensity" and "cadence" fields.
• NEW: The script parses repeat blocks for API upload without expanding.
• NEW: JSON input format updated to include activity type as a field, making it independent of the workout title.

Prerequisites

• Python 3.6 or higher
• An Intervals.icu account with API access
• Your API Key and Athlete ID

Installation

1. Clone the Repository

   git clone https://github.com/KjellVerb/intervals.icu.git
   cd intervals.icu

2. Configure the Script
   • Open the upload_trainings.py or upload_trainings.ps1 file.
   • Replace the placeholders:
     • your_api_key with your API key from Intervals.icu.
     • your_athlete_id with your athlete ID.

Usage

1. Create your schedule
   h3xh0und made a custom GPT Coach GPT for Intervals.icu that you can use to create a trainingsplan for an event. It works like the Annual Training Plan (ATP), so you can add multiple events (A,B or C events). When your happy with the plan the GPT will ask you to generate it as a JSON. Save this file as training.json in the same directory as the script. I did not test this, nor whether it can generate the new format of the training.json

   • Repeat blocks:
     You can now use the following structure for repeated intervals:

     {
       "description": "5x",
       "reps": 5,
       "steps": [
         {"duration": "2m", "zone": "Z2 Pace", "description": "Run", "intensity": "active"},
         {"duration": "1m", "zone": "Z1 Pace", "description": "Walk", "intensity": "rest"}
       ]
     }

     The script will correctly format these blocks for upload.

   • Description field:
     The description field will be used as the step text that is displayed on your device (watch) during training.

   • Step fields:
     Each step can optionally include "intensity" and "cadence" fields for more detailed workouts.

2. Run the Script
   Python

   python3 upload_training.py
   

   Powershell

   .\upload_trainings.ps1
   

3. Verify on Intervals.icu

   • Log in to your Intervals.icu account.
   • Check the calendar for the uploaded events.

Support Intervals.icu

Make sure to subscribe to Intervals.icu to support the hard work David Tinker puts into maintaining this incredible tool for athletes!

Contributing

Feel free to contribute to the project by submitting issues or pull requests. Contributions are welcome!

License

This project is licensed under the MIT License.