Support‎ > ‎

mPaceline Support

Part I – mPaceline Overview

This guide is to help you get started using mPaceline. We hope that you enjoy using this App. If you have any questions or issues, please email us at

iOS & watchOS Requirements

mPaceline runs on iOS 9.3 without the Watch App or iOS 10.0 with watchOS 3.0. If you don’t have these versions, you will need to upgrade. We also need your permission to access the Health Kit database on your phone. If you don’t grant this permission, the application will not function correctly.


To be very clear, mPaceline is a cycling workout App. If you are looking to track results of other workout types, then mPaceline is not for you.  mPaceline works best if your focus is on taking spinning classes that allow you to capture data from the class to later be entered into the App. If you are Peloton riders like us, then this will perfectly fit your training.

Usage Scenario

mPaceline is a workout App. It is comprised of the iPhone App that allows you to visually see all your workouts (we call them “Rides”) as well as an Apple Watch Companion App from which you can begin and monitor Rides on your wrist. While the iPhone App is detailed and will take some time for you to learn all the features, the Watch App is designed to be very straight forward. Click the “Let’s Ride” button and you’re off.

There are three different usage scenarios for mPaceline:
  1. The first is the recommended option. In this scenario, you take advantage of mPaceline’s iPhone App and Watch App. Rides are started on the watch and transferred automatically to the iPhone when the Ride concludes.

  2. You utilize a 3rd party Apple Watch App or the default Apple Workout App to record and monitor your workout. The workout can be imported into the mPaceline iPhone app as a new Ride.

  3. You utilize a Bluetooth Heart Rate monitor connected to your iPhone to record your vitals over a workout period. You then manually create a Ride in the mPaceline iPhone app.
If you own an Apple Watch, #1 is the recommended approach because after the mPaceline Watch App saves the standard workout data, it allows you to capture extra data and statistics about your Ride. It’s this extra data that is used in the iPhone app to compare different rides and highlight your performance over time. Both the standard workout data and extra workout data are stored in the Health Kit database.

In scenarios #2 and #3, you can still capture the extra workout data, you just need to enter it on mPaceline’s iPhone App. In this case, it’s not written to the Health Kit database.

mPaceline’s Extra Workout Data

The standard workout App on the Apple Watch captures the following information and this information is transferred to mPaceline when the workout is completed.
  • Workout Duration in Minutes 
  • Active Calories Burned 
  • Distance 
  • Heart Rate Measurements 
mPaceline allows you to capture extra data. This extra data includes measurements that highlight your performance during the Ride. The measurements included are:
  • Instructor – selected from configurable list 
  • Ride Type – selected from configurable list 
  • Total Output – measured in Kilojoules 
  • More Precise Active Calories – measured in Calories 
  • Average Output – measured in Watts 
  • Average Resistance – measured in Percent 
  • Average Cadence – measured in RPMs 
Depending on your situation, you may or may not have the above information available. This is particularly true if you spend a good portion of your time riding outdoors.

Part II - Application Walkthrough

Below we will walk through the main screens in mPaceline and give you an understanding of how to interact with the App. 

Home Page 

The home page is designed to give you a quick glance of your most recent statuses and accomplishments.

Key Metrics by Timeframe

At the top of the screen you see a summary of key metrics over different time frames. Swipe this view to see alternatives times. You can also tap on the Calories/Output label to toggle this display.

Most Recent Ride Results

In the middle of the Home Screen you see the results from your most recent Ride. Shown is the date and time as well as the instructor and type of ride. Below this are a set of Ring Graphs that show your performance on this Ride compared to other rides that you have done. You can swipe the Ring Graphs left and right to see more values (more on the Ring Graphs below).  Tapping on the Instructor – Ride Type display will take you to the Ride detail page for this Ride. You’ll notice that if you tap on a Ring Graph you will alter the history display at the bottom of the screen.

Ride History Display

The ride history display shows results over time. The bar to the far right is the most recent Ride. You can use pinch and zoom gestures to alter the number of bars shown and you can swipe left and right to see different time periods. The number of bars shown in the graph and the default number visible bars on the graph are adjustable in the settings screen. If you tap on a bar graph you will be taken to the Ride detail page for that Ride. If you tilt your iPhone landscape, you will get a better view of this bar graph. Tapping on the bars in landscape mode provide a popup of details.

Ring Graphs

The following Ring Graphs are seen in several screens throughout mPaceline:
  • Duration – the number of minutes you spent in the Ride.\n" +
  • Power Ratio – a measure of power-to-effort calculated by the average output of a ride divided by your average heart rate. This is a very useful measurement to compare your performance across multiple rides.\n" +
  • Output – the total output in KJ that you achieved during the Ride.\n" +
  • Calories – the total calories in CAL that you burned during the Ride.\n" +
  • Avg HR – your average Heart Rate over the course of the Ride measured in BPM.\n" +
  • Max HR – the maximum Heart Rate you hit during the Ride measured in BPM.\n" +
  • Avg Output – the average output you achieve during the Ride measured in WATTS.\n" +
  • Avg Resistance – the average resistance during the Ride measured in a percentage between 0 and 100.\n" +
  • Avg Cadence – your average cadence during the Ride measured in RPMs.\n" +
  • Distance – the distance you traveled in either Miles or Kilometers during the Ride. See settings to set your preferred distance measurement.

mPaceline’s Ring Graphs are designed to give you a quick visual of the performance of a Ride against other rides that you have done. The graph in the ring starts at the bottom and goes clockwise around in a circle. A Ring Graph that is filled, represents your best effort in a metric. The center of the ring shows the metric numerically.

Note that Ring Graphs are “grouped” based on the duration of the workout. This means that if you are looking at a Ring Graph from a 45-minute workout, the graph is only comparable to other 45-minute workouts.

The toolbar at the top of the page has some additional options that you can select.

Import – brings up the import screen from which you can add new rides to mPaceline.

Stream Ride Icon – click to live stream ride data from your Apple Watch to the iPhone.

If you have yet to purchase the Full Access version of mPaceline, you will see an option at the top of the Home Page to make a purchase.

Rides Page 

The Rides page allows you to navigate through all of the rides that you have completed. There are two levels of the Rides Page. The first is a summary table that aggregates rides by Year and Month. If you click on a row in the Rides summary table view, you will be shown the Rides detail table view. This will be all Rides taken in the month that you clicked on. 

The Rides detail table view is shown below: 

Clicking on a row will bring up the ride detail page. Here you can see additional details for the ride including a couple of different views of your heart rate and the zones that your heart was in during the ride. You also have the ability to enter notes for the ride.

Viewing Ride Details

The Ride Details screen shows you all details about a particular Ride.

A key feature of the Ride Details screen is to show the heart rate graph recorded during the ride. There are two graphs shown. The first plots your HR across the timeframe for the Ride. You can visually see what zone your HR was in based on the colored sections on the graph. The second graph gives you a visualization of how much time you spent in each HR zone.

The heart rate zones shown are configurable in the settings page. You should also set your maximum heart rate on the profile page.

If you double tap on the left side of the first HR graph, you will be shown the previous Ride. Similarly, if you double tap on the right side, you will advance one Ride.

The toolbar at the top of the Ride details page has some additional options that you can select.

Delete – allows you to delete this ride. Note that this will not remove the ride from the Apple Health Kit database. Scroll down for the ‘Delete’ button.

Share Icon – click to share your most recent ride with friends.

Edit – Bring up the edit screen so that you can exit the extra ride data.

Note that the heart rate graph will respond to pinch and zoom gestures so that you can see the heart rate values in better detail.

Editing a Ride 

You can access the edit ride screen from the “Edit” swipe menu on the Rides detail table view or by clicking on the “Edit” button when viewing Ride Details.

Results Page

The Results has been designed to provide you with a series of graphs that can help demonstrate that your ride performance is improving. Most people will share that their overall workout goals are to improve performance, strengthen and tone muscles, increase overall cardiovascular performance and to strengthen your heart.

So how do we prove that we are doing this. Well, the first is simply going to be based on how you feel. If you stick with your training plan you will certainly feel better and will notice that you are able to conduct rides more easily as time goes on. But, that's not enough is it? We all want to see some measure or indicator that shows us that this is happening. Doing so offers reinforcement that our effort is not wasted and actually motivates us to keep going. 

There are a number of graphs that can show you how you are performing over time. There are two types of graphs available.

Ride Results

Ride Results offer a set of graphs that show your ride performance over time. These are meant to give you information about how well are improving over time. It may take a few months before you have enough ride history to fully take advantage of these graphs, but if you are like us, you’ll be pleased with the result that you see. 
  • Instructor – these graphs show results based on the instructor you take rides with. Here we are sharing what you probably already know, that you have favorites. That you tend to stick with who you think motivates you. Maybe you just like a particular instructor more than others. It can be a comfort thing. However, have you ever thought about which instructor motivates you to get the best output or highest cadence? Maybe it's who you think. Maybe it's not...
  • Ride Type – just like 'By Instructor', these graphs can help you understand which type of Ride gets your best response.
  • Power Ratio – a power ratio is a measure of power-to-effort calculated by the average output of a ride divided by your average heart rate. This is a very useful measurement to compare your performance across multiple rides. In these graphs, we chart this ratio and allow you to visualize its change over time.
  • Rides Over Time – here we show you rides that you have done by week, month and year. You can select what ride metric you want charted and can visualize the results to see if you are sticking to your training plan.
  • Comparisons – this is a free form set of graphs that allows you to pick a couple different metrics to be compared across all of your rides. Maybe you want to see how output compares with average resistance or how you power ratio is impacted by distance. Pick you stats and you may visualize something interesting that you hadn't thought of.
  • Heart – an overview of the zones that your heart rate has been in during a set of workouts.
Measurement Results

The measurements results allow you to graph your weight change and inches lost over time. You enter your weight and inch measurements on the profile page. One you have enough data points, you’ll be able to graphically see your results. 
  • Weight Loss Over Time – graphs of your weight changes since you have been using mPaceline.
  • Inches Lost Over Time – graphs of your body measurements since you have been using mPaceline

Below on the left is a sample of the Results Screen. If you click on the view button associated with the type of result that you wish to see, a corresponding graph will be shown. Below on the right is an example of what the Power Ratio graph looks like.

You’ll notice a set of options below the Power Ratio graph. These options vary based on the graph you are viewing. Using these options, you can tailor or filter the graph across a number of areas.

Profile Page

The Profile Page contains information about the mPaceline user. This page contains two sections. The first (“User Details”) is basic information about you, the mPaceline Rider. At a minimum, you should make sure to set your maximum heart rate. The other data is used when you shared Rides with other people.

The second section (“Measurements”) is optional, but allows you to record and track body measurements including your weight and inches. The summary view at the top of the Home Page will show your progress as these measurements change over time. You can also graph them on the Results Page.

You can click on a measurement and update its value. This actually saves an additional measurement. If you click on a row for a measurement, you will be shown all the measurements that you have entered. You can then edit and/or delete them.

Settings Page

The Settings Page allows you to set up how you would like mPaceline to function. There are 6 groups of settings on this page.

Ride Setup

Ride setup allows you to enter additional details about rides that you take. There are 3 key areas here.
  • Instructors – clicking on Instructors will bring up a screen that allows you to create, edit and delete a list of instructors that you take spinning or other training classes with. These instructors are then available for you to associate with a Ride. 
  • Ride Types – you can create a list of ride types that you typically take. The types of rides will vary based on the type of usages you have for mPaceline. These types can be any set of values that you feel categorize the types of rides that you take. Like instructors, these ride types are associated to rides that you take. You can use these in the Results reporting to see improvement over these types of rides. 
  • Heart Rate Zones – This is an important area and you should make sure to take some time to setup. By default, these are defaulted for you based on standard HR models. When you click on the Heart Rates Zones, you will see a screen that will allow you to edit the zone names as well as the starting zone heart rate percentage. The BPM values shown on this page will update as you move the sliders and this BPM is based on the maximum HR you set on the profile page. 
General Preferences

The preferences are simply there to allow some customization as to how mPaceline works. These are:
  • Dark Mode – you can toggle between a dark and light mode that changes how the App looks. 
  • Default Home Page Graph – the graph at the bottom of the home page can initially show a set of values when the App starts. Toggle that initial value here. 
  • Home Page Rides to Show – the Home Page Graph can be setup to show a specific number of bars. To show all Rides, slide the slider all the way to the right. 
  • Visible Home Page Rides – there is only so much room on the phone, so you might want to set this to 10 or so. It determines how many bars are actually shown. You slide the bars left and right to show more. 
Ride Import & Streaming

Use these preferences to change how mPaceline interacts with the Watch App.
  • Auto Import – this allows you to specify whether or not mPaceline automatically imports new rides or if you need to use the Import screen to manually select them. 
  • Stream Rides from Watch – You can turn the streaming option on or off from your Watch. If you elect not to use this feature, it’s best to leave it turned off as it will preserve your Watch battery. 
Region Settings

This section is pretty straightforward. Set the toggles for Distance, Weight and Length units based on your preferences.

Peloton Ride History Download

mPaceline has the ability to download and load data from a Peloton Ride History file. Note that these settings only apply if you are a Peloton Cycle owner.

This works by performing a date and time match on records from the Peloton Ride History file to the Rides in mPaceline. If a match is found, the Ride is updated with the Peloton data (instructor, output, etc.) This is particularly useful to load history from rides that you did prior to installing mPaceline.

There are two ways that you can download the Ride History Data:

Automated Download: If you find that you like to reload the Peloton Ride history every so often, you should take the time to setup mPaceline to make this automatic. Click on the (i) information link on the settings screen for details on how this works

Manual Download: You can manually download the Peloton Ride History from Peloton’s website. Click on the information link on the settings screen for details on how this works

Advanced Options

The options in this area are advanced features and should not need to be used by the average user.
  • Reset All Ride Data – If you find that you want to erase all rides from mPaceline, you can use this feature. Note that this is not reversible. If you erase all rides, you will need to re-import them from Health Kit or re-load them from a Peloton Ride History file. 
  • Mark All Rides Read – If you would like to mark all rides in your database as “read”, press the ‘Mark Read’ button. This can be useful if you have just done a large import or load from a Peloton Ride History file.

Part III – Importing Rides 


We made importing rides a separate section of this guide because it requires a little more explanation as to how it works. First some background…

As you are probably already aware, Apple saves all health-related information, including heart rate measurements and workouts in a database on the iPhone referred to as Health Kit. When you use the mPaceline Watch App, we write directly to Health Kit just like any other workout app does. This includes the standard workout fields as well as the extra data that you enter on the Watch. This is then available to any App that you have authorized as having access to your Health Kit data.

When you “import” a workout into mPaceline, it creates a link to the Health Kit workout and maintains some local data. Establishing this link is what we call importing. It basically allows mPaceline to work with the Health Kit workout data and represent this data in the screens we highlighted in Part II of this guide. If you delete a “Ride” in mPaceline, it only deletes the reference and you will still have the workout in your Health Kit database.

It’s important to note that since mPaceline is a cycling focused workout App, it will only import workouts that are designated as cycling (indoor or outdoor). The others will be ignored.

- - - -

By default, the auto importing of cycling workouts is turned off in the settings panel. We do this so that you don’t fill mPaceline with unwanted data. We recommend that you manually import the initial workout data and then turn on the automatic setting for subsequent imports.

Importing Rides

You start an import by pressing the Import button on the Home Page. It is located in the upper left corner of the screen. You will be shown the import screen below:

The import rides page allows you to mark the listed rides as either imported or ignored. You use ignored when there are rides that you want to remove from the list but don’t want to import them. Importing will bring the Ride in the mPaceline App and no longer show it on this page.

There are two ways to ignore or import rides. You can do this row by row by swiping left on the row and selecting the Import or Ignore options. You can also click on each row which will show a red check mark to the left side of each row and then use the Multi-Selection Action buttons (Import or Ignore) at the top of the page. The All or None selection buttons will toggle the selection on or off. The “Show Ignored” toggle button will show or hide Rides that you have previously ignored. 

Peloton Loaded Rides

Rides marked with the Peloton logo match rides that you previously loaded from your Peloton History file. You may not want to import these as doing so could create duplicates. They are good candidates for ignoring...

Auto Importing Rides

If you like, you can turn on automatic importing of rides. This is done on the Settings Page. When this is turned on, any Cycling Workouts that show up in Health Kit will be pulled into mPaceline as new Rides. We recommend that you manually process all existing Health Kit workouts before turning this on. This prevents you from having to delete rides that were imported that you didn't want in your mPaceline App.

Part IV – Load Peloton Ride History 

This section is only relevant to mPaceline users that are Peloton Cycle owners. If you are interested in learning more about Peloton Cycle, visit them at

- - - - - - - 

As discussed in the previous section, importing in mPaceline pulls rides from Health Kit. This works well after you have installed mPaceline and are using our Watch App to track cycling workouts. However, what about those Rides that you did prior to installing mPaceline? Well, if you happened to do these rides using another workout app on your Apple Watch, they can be imported as well. However, if you didn’t utilize any mechanism for identifying cycling workouts on your Watch or iPhone, then there is no data for mPaceline to import.

To account for this, we created the ability for you to download Peloton’s Ride history file and either match this data to rides already in mPaceline or create new Rides. The latter is great to get this history that you may not have on your iPhone. Note that Peloton doesn’t provide HR data so while you’ll have all your Ride details, you won’t have any HR data.

mPaceline provides a couple different way for you to download and load the Peloton ride history data.

Manual Download

If you go to you can access your Peloton account. You will be prompted to log in if you haven’t already done so. Once you log in, you will be shown your ride history. At the top of the ride history is a link to download ride details. Clicking on this link downloads a Comma Separated (CSV) file of data about all of your Peloton rides.

Note that this download link does not work on an iPhone and we recommend that you use a computer to download this file.

Once the ride history file has been downloaded, you need to get it to your iPhone. The simplest way to do this is to email it to yourself and then open the email on your iPhone. Once the email is opened, you should be able to click on the file and choose the “Import Using mPaceline” link that shows up. This does work differently in some email clients so you may have to experiment a bit.

Once the file is opened in mPaceline, you will be walked through a couple of screens to load the data into mPaceline. More on this below…

Automated Download

The automated download make the process of getting the ride history file into mPaceline a lot easier, but will require a little setup on your part.

On the Settings screen, you will see a field that you can enter your Peloton User ID. This is not your Rider Name, but a 32-character key created by Peloton when you registered your account. You can find this key on the Setting screen under ‘My Account’.

After you have entered the Peloton User ID, press the Login button below the field. This will open Safari on your iPhone and you will be prompted to login to your Peloton account. After you login, you should be prompted by Safari to save the login credentials. Please do this so that next time Safari is launched it will login automatically.

To check that everything was done correctly, click on the “Auto Download” button. Safari will be launched once again and it should show you your Ride History Data. At the top of the data will be a linked titled “More…”. If you click on this you will be given the option to “Import using mPaceline” and pressing this will start the Load…. Note that the “More..” link will disappear after a few seconds and you can get it back by simply tapping once on the Peloton data in Safari.

Once the above steps are done, you should be able to just click on the ‘Auto Download’ to do subsequent Peloton data loads.

Loading Downloaded Peloton Ride History

After you have downloaded your Peloton ride history by one of the methods above, you will be shown the Load Peloton Ride History Screen like below. Complete the settings on this screen and press load to have your history matched with mPaceline Rides.

Header Fields & Actions

When performing a load it's important to pay attention to the fields listed at the top of the screen. These fields will give you an indication of what is about to happen to your mPaceline data. A load is not reversible so you should take care to make sure you understand what is about to happen. The following fields are listed:
  • Peloton Rides – the number of records that are in the Peloton History File.
  • mPaceline Matches – the number of date/time matches made between records in the Peloton History File and Rides in mPaceline.
  • Updates – the number of mPaceline Rides that will be updated with information from the Peloton History File.
  • New Rides – the number of mPaceline Rides that will be created from information in the Peloton History File.
There are two action toggles in the header. These can be set to alter the number of Rides that will be pulled from the Peloton History File:
  • Create Unmatched – turning this action on will result in new Rides added to mPaceline if they are not matched to existing Rides.
  • Overwrite Previous Loads – turning this action on will result in previously matched Rides being updated in mPaceline again.
Health Kit Import First!

Important - You should make sure to import all of your workouts from Health Kit as Rides before you utilize the Peloton History Load. Otherwise you may create duplicates if you do the import at a later time.

Match Fields

The mPaceline and Import fields should already be matched for you and should not need any changes. If it turns out that this is not the case, tap on each field and select the corresponding field in the history file so that it matches the mPaceline field description.
Run the Load

The 'Updates' and 'New Rides' will give you an indication of how many Rides will be updated and/or created by the load. When you have matched the fields and are ok with the 'Updates' and 'New Rides', press the load button to perform the load. When it is finished, you will see load results and then be brought back to the mPaceline Home page."

Part V – mPaceline Watch App

Here we will review the usage of our Apple Watch Companion App.

Our goal was to create a simple app that would allow you to easily capture the extra data fields as well as visually see how your Ride is going. 

Installing the Watch App

Installing mPaceline on your Apple Watch is the same as any other Watch Application.  Go to the Watch App on your iPhone and click on the "My Watch" tab at the bottom of the screen.  Scroll down until you see the mPaceline entry.  If you click on this you will be shown a screen that will allow you to toggle the installation of the mPaceline App. Click on the slider and mPaceline Will install.

Running the Watch App

Navigate to the Application on your Watch and click on the mPaceline Icon. You’ll see the main screen with the “Let’s Ride” button.

This is the main screen. Simply press the Let’s Ride button and your Ride will begin. 
When a Ride is active, you see your current heart rate and calories burned in the circle. You see the zone that you are in spelled out and a graphic representation of which zone you are in by the colored circle. 

If you ‘deep press’ on the Ride screen, you get a popup of actions. These are: 
  • Pause/ Resume 
  • End and Discard Ride 
  • End and Save Ride 
  • Continue – back to Ride screen 

When you choose “End and Save” from the popup, you will be shown a series of screens that let you capture the mPaceline “Extra Data”.

Turn the digital crown to select the value and then press next. 

You will be asked to select values for the following fields: 

Instructor, Ride Type, Output, Avg. Output, Avg. Cadence, Avg. Resistance and Calories. 

Once you reach the last field, the next button becomes Save. Press it and your Ride will be complete. All data will be transferred to your phone for importing… 

** It’s important to note that your Apple Watch makes an estimate of the calories that you burn during your Ride. The actual calories burned may be more accurate if you use the data from your spin bike or a power meter as this measurement can consider your cadence and resistance. The Watch App will not have that data. Our Watch App will show you the calories calculation on the watch, but allow you to overwrite it with a more accurate value.