Loading Data

Chapeau supports direct loading of a variety of file formats and can also be connected to Strava.

Warning

Strava activities are missing the full data available in original files, for example, power balance, pedal smoothness, or torque effectiveness are not present in Strava activities. To get the most from your data use the original files.

From File

Chapeau supports loading data from multiple different file types including the following:

  • Flexible and Interoperable Data Transfer (.fit) – format specifically designed for sports. Very commonly used.

  • GPS Exchange Format (.gpx) – commonly used format developed by topograpfix.

  • Training Center XML (.tcx) – older standard developed by Garmin.

  • gzip files (.gz) – gzip files will be extracted, and any supported file types will be collected and loaded.

  • Golden Cheetah (.json) – files exported by Golden Cheetah.

Files can be loaded by dragging and dropping them directly onto the session tree from Finder (macOS) or Windows Explorer. Or through the File –> Import… menu option, the mini toolbar or from the Import button directly.

Three ways to import files into Chapeau

Once files are imported the session tree on the left will be populated:

Session Tree Updates with Sessions Post Loading

From Bulk Exports

Many athletes may have stored their sessions in other online software packages. The instructions below detail how to get a data dump from these platforms and pull them into Chapeau.

Note

Instructions updated January 2024

Strava

To retrieve all your original activities from Strava:

  1. Login to Strava

  2. Click on your icon (upper right-hand side)

  3. Choose Settings

  4. Select My Account

  5. Scroll down to Download or Delete your account

  6. Click Get Started

  7. Click on Request Your Archive

  8. Wait for email from Strava

  9. Download zip file from link in email

  10. Unzip the zip file

  11. From the activities folder drag and drop files onto Chapeau

TrainingPeaks

To retrieve all your original activities from TrainingPeaks:

  1. Login to TrainingPeaks

  2. Click on your icon (upper right-hand side)

  3. Choose Settings

  4. Click on Export Data in the left hand column

  5. Under Workout Files select a date range (1 year max per download)

  6. Click Export button

  7. Download file when prompted in the Export Complete window

  8. Export additional years as desired

  9. Unzip the zip files

  10. Drag and drop files onto Chapeau

Garmin / Garmin Connect

To retrieve all your original activities from Garmin:

  1. Sign into Garmin main site (not Garmin Connect)

  2. After Sign In click Account from upper right dropdown

  3. Under Data Management click on Manage Your Data button

  4. Click on Export Your Data

  5. Click on Request Data Export

  6. Wait for email from Garmin

  7. Download zip file from link in email

  8. Unzip the zip file

  9. The DI_CONNECT / DI-Connect-Fitness-Uploaded-Files folder contains a zip file of uploaded files

  10. Unzip the zip file

  11. Drag and drop files onto Chapeau

Wahoo / Wahoo Fitness

To retrieve all your original activities from Wahoo:

  1. Sign into Wahoo

  2. After Sign In click My Account (upper right corner)

  3. Click Account Information from the options (left hand side)

  4. Under Manage Account choose export account info

  5. Complete the form, under Request Type choose Access My Information

  6. Submit the form, an email will be sent from OneTrust to confirm your account.

  7. Confirm your account and follow the emailed instructions to access the Wahoo portal

  8. An file of activity data will be attached to the messages in the portal

Wahoo / DropBox

A great way to get your Wahoo files onto your computer is to sync the Wahoo app with Dropbox. Doing this allows you to share the files to Dropbox which in turn syncs them up to your computer. In this way you have all your files quickly and easily available on your Mac or PC for use with Chapeau.

Wahoo / Wahoo SYSTM / Email

The Wahoo SYSTM app can send you your data files via email post every ride, this is configured in Wahoo SYSTM under Settings, Authorized Apps, and choose Send completed SYSTM activities to your email. The data file for an individual activity can be emailed by viewing the activity in the SYSTM website and choosing Share.

Direct from Strava

Important

  • NEW in 2.1 Chapeau can automatically import new activities on start-up, use the auto-download checkbox to enable. This setting is saved with the currently opened database.

  • NEW in 2.5 Hotkey introduced to turn off auto-download when opening Chapeau.

  • NEW in 2.5 Filter out and ignore manual activities.

  • NEW in 2.6 Add support for Running activities and Segments.

  • NEW in 2.6 Expand on supported activity sub-types.

  • NEW in 2.6 include icons for activity sport.

Warning

  • Strava activities are missing full data available in original files

  • Strava activities contain smoothed data, it does not match original files

  • To turn off auto-download hold down the SHIFT key and then double click the Chapeau icon to open the app

Activities from Strava can be directly downloaded and converted into Chapeau sessions via the Strava… option in the File Menu.

In the Load from Strava window click the Connect with Strava button to authorize Chapeau to pull activity or segment data from Strava.

Once you have authorized Chapeau to work with Strava you will see a list of your cycling and / or running activities from the last 30 days.

Check each activity you want to import and click the download button (lower right) to start the download and import process.

Load Cycling / Running Activities from Strava from last 30 days

Note

  • Activities previously downloaded will be gray, activities that overlap an existing session will be pink.

  • Control the naming of sessions by choosing to Keep Strava Names or Generate Chapeau Names.

Data Processing

Important

  • NEW in 2.6 added support for running sessions

File Import Progress

As files are imported a progress bar will show the percentage complete and the current file being imported.

Upon completion Chapeau will show your new achievements in Best Speeds / Paces, Powers, Cadences / Step Rates, and Heart Rates and will notify you of any issues that may have occurred during import.

Session bests for Speed, Power, Effective Power, Cadence, and Heart Rate

Session bests for Pace, Power, Effective Power, Step Rate, and Heart Rate

Note

  • A common issue is loading the same session more than once or one that overlaps an existing session time span.

  • A session will be loaded but data excluded if the maximum heart rate or maximum power is exceptionally high

Chapeau found overlapping session and bad data during data loading

Define Manual Sessions

Important

  • NEW in 2.1.1 added calories calculation, revamped layout for calculated fields

  • NEW in 2.1.1 renamed Stress to Load

  • NEW in 2.3.1 increase precision of Intensity to 3 decimal places

  • NEW in 2.6 add support for running sessions

From time to time, it may be necessary to define a session manually without the benefit of data from a head unit. This is a useful way to track your training load for non-Cycling workouts. Chapeau provides this capability in the Edit menu under the Add Manual Session menu item, choosing between Cycling… or Running….

Add a manual session for Cycling

Add a manual session for Running

Define the time, distance, and intensity of your session. Speed / Pace will be calculated based on time and distance.

If your database has power data, the Power will be calculated based on the Estimated FTP for the date specified on the window and multiplied by the Intensity provided.

Note

FTP is estimated on a per sport basis.

Add Training Plans

Important

  • New in 1.6.0

  • New in 2.6 add support for running sessions

Include training plan workouts in Chapeau to model your build and training load. Simply add a workout from an ERG or MRC file by choosing Cycling… or Running… from the Edit –> Add Training Plan Session menu.

Note

If you choose an ERG file, the power values are already in the file, and these will be used directly. If an MRC file is selected, the Estimated FTP will be used to scale the percentages.

Note

FTP is estimated on a per sport basis.

Cycling

Add a training plan session for Cycling

The window opens with your most recent Estimated FTP pre-populated. Continue by Adding a title, choosing date and time, and optionally Setting a speed.

Running

Add a training plan session for Running

The window opens with your most recent Estimated FTP pre-populated. Continue by Adding a title, choosing date and time, and optionally Setting a Pace.