Tempo’s Training Planner enables the ability to import custom training plans and view workouts schedule in a simple and beautiful calendar layout. A plan can be imported using a CSV file format described below.

Why CSV?

We might add more UI to add plans directly in the app, but setting up multiple weeks of training can be very tedious and slow. A spreadsheet app can make this process much faster, allow plan data reuse, and the entire plan data can be easily exported into a CSV file format.

How does it work?

1. Build your training plan using Numbers, Excel, or Google Sheets and export it into a CSV
2. Save the CSV file on your iCloud Drive to be easily accessible from the Files app on your iPhone
3. Launch Tempo and Import the file. Tempo will also require a plan name and training start date

CSV Format

1. Lines starting with a # are ignored and can be used for comments

2. Each line is a training day

3. First line list the field names: week, day, distance, type, details, duration

4. Ordering of field names can be changed, but field names are fixed and case-sensitive

5. Tempo parses distance field to preferred distance unit (mi or km)—don’t add unit to the distance values

6. Tempo parses duration field in minutes. Don’t ad unit to the duration values

   • For duration in hours, convert them to minutes. Example: 1h 31m = 91

7. A training plan consists of multiple weeks starting with week 1

8. Each week is made up of days [Mon, Tue, Wed, Thu, Fri, Sat, Sun] that Tempo will parse and order correctly

9. Each day field should match one of the weekdays in [Mon, Tue, Wed, Thu, Fri, Sat, Sun]

10. You can add multiple workouts for same day by repeating the week + day combo

    • Following line will add two workouts for Week 1, Wednesday,
      • Workout 1: 3 mi (or km) as Recovery type
      • Workout 2: 5 mi (or km) as Easy with 10x150m

    1,Wed,3,Recovery,
    1,Wed,5,Easy,10x150m
    

11. All the fields except week and day are optional. This is useful if you want to add cross-training days that do not have a distance assigned.

    • A line would be essentially considered as rest day when it only has week and day. For example, following line will parse Week 1, Monday as rest day.

      1,Mon,,,
      

    • Following line will parse Week 2, Tuesday as type=Biceps and details=Cross-training, Lift

      2,Tue,,Biceps,”Cross-training, Lift.”
      

12. Parsing will not fail if a week or day is missing. Tempo will add those as empty days or weeks