Help · Workouts
Workout files
In RawWatts, a workout is one line of text:
Sweet spot 3x10: 10m 55%, 3x(10m 90%, 5m 55%), 10m 50%
A handful of them in a plain text file is a set. That file is everything there is: you can write it in any editor, send it through any channel, and read it without the app. This page covers the format, how a file gets into and out of the app, and how a coach uses it to give riders their sessions.
One workout, one line
A line is an optional name, then steps separated by commas. Each step is a duration and a power.
| Part | Write it as | Notes |
|---|---|---|
| Name | text before the first : |
Optional. Without one, the app shows the steps as the name. |
| Duration | 90s, 10m, 1h, 2m30s |
The unit is required. 2:30 is not accepted, because it could mean hours or minutes. |
| Power in watts | 215 or 215w |
Whole watts. |
| Power in percent | 90% |
Percent of the rider's FTP. |
| Ramp | 100-200 or 50%-75% in place of the power |
From the first value to the second over the step's duration. |
| Free step | ~150 or ~55% in place of the power |
Starts at that value; from there the rider decides. |
| Repeat | 3x(10m 90%, 5m 55%) |
A repeat may contain another repeat, but no deeper than that. |
| Reference FTP | @ftp 245 at the end of the line |
Optional. The FTP the watts were written for. |
Spaces and upper or lower case don't matter. When the app writes a workout, it always uses the form shown here.
Watts or percent
- Percent steps follow the rider:
90%is 234 W for an FTP of 260 W, and the app rides 235 W. A rider who has no FTP set is asked for it before the workout starts. - Watts without
@ftpare taken as written.10m 215is 215 W for everyone. - Watts with
@ftpscale to the rider.10m 215 @ftp 245is 215 W for a rider with an FTP of 245 W, and 230 W for a rider with 260 W.
Scaled and percent values are rounded to the nearest 5 W.
Ramps
5m 100-200 goes from 100 W to 200 W over five minutes; 10m 50%-75% does the same in percent of your FTP. Ramps can go down too (5m 200-100). RawWatts moves the target every second, to the watt, so the ramp is smooth. A ramp is one lap.
Free steps
10m ~150 is ten minutes that start at 150 W and then belong to the rider: the ± buttons change the watts for this step only, and the next step starts at its own value. 10m ~55% does the same from a percentage of FTP. Use it for a warm-up or a recovery where the exact watts don't matter.
A free step always names its starting value. After a hard interval the trainer would otherwise stay hard until the rider reacts. In every other step, ± shifts the whole rest of the workout, and that shift also applies to where a free step starts.
Cues: text during the ride
A cue is a short text that appears on the ride screen at a set time, with a buzz. Cues are written as description lines under the workout, in the form <how long>@<when>: text:
W1 Sweet spot 3x10: 10m 55%, 3x(10m 90%, 5m 55%), 10m 50%
- Steady, not hard.
- 10s@15s: Settle in
- 15s@9m45s: Series starts
- 20s@-10m: Ten minutes left
- The time counts from the start of the workout:
10s@15sshows for ten seconds, fifteen seconds in.@0is the very start. - A minus counts from the end:
20s@-10mshows ten minutes before the workout is over. - Durations and times need their units, like everywhere else.
- A line under a workout is a cue when it starts this way. Every other line stays description, so "Steady, not hard." above is shown with the workout, not during the ride.
- If two cues overlap, the one that started later is shown. Cues follow the workout's clock, which stops while the ride is paused.
What the format leaves out for now
Cadence targets as their own field; a cue covers them for now (30s@5m: Cadence 100+). Sprints, slope and heart-rate targets aren't part of it either: RawWatts sets watts and lets the trainer hold them. Let me know which ones you are missing or what else to add!
A set: several workouts in one file
# Winter base · from Anna, for Marco
> W1 once a week for 4 weeks, then replace it with W3.
> W2 on any other day.
W1 Sweet spot 3x10: 10m 55%, 3x(10m 90%, 5m 55%), 10m 50%
- Steady, not hard.
- Cadence 85–95.
W2 Endurance: 60m 65%
W3 Threshold 2x20: 15m 55%, 2x(20m 100%, 5m 50%), 10m 50%
- The last five minutes should hurt.
What a line is depends only on how it starts. Indentation means nothing.
| Line starts with | It is | Notes |
|---|---|---|
# |
the title of the set | Once, above the first workout. Without it, the file name is the title. |
> |
a note for the whole set | Any number of lines. Shown under the title in the app. |
- |
a description of the workout above it, or a cue | Any number of lines. Cues are described above. |
## |
reserved for sections | Skipped on import. |
| anything else | a workout | Must be a valid workout line. |
- Blank lines are ignored. Put one between workouts, so the file also reads well in a Markdown viewer.
- The file is plain text in UTF-8. The extension can be
.txt,.mdor missing, and any line endings work. - One wrong line rejects the whole file. The app names the line and the problem, for example "Line 7: Step 3: no duration", and adds nothing. That includes a cue that is wrong, such as one timed after the workout's end. Nobody ends up riding half a set.
Getting workouts into the app
Workouts live under Rides → Workouts. There are three ways in:
- Paste. Copy a line or a whole set from a message, tap +, then Paste.
- Import file. Tap +, then Import file…, and pick the file.
- Open in RawWatts. Share a text file to RawWatts from Files, Mail or a messenger.
Where it lands:
- Text with a
#title arrives as a set, listed under that title with its notes. - A file without a title that holds several workouts also arrives as a set, named after the file.
- Anything else joins Your workouts.
Workouts in a set can be ridden but not changed. Copy to my workouts makes a copy the rider can edit. Importing the same set a second time adds it a second time.
Getting workouts out
- One workout: press and hold it, then Share. The file holds its line and its description.
- A set: the ⋯ button next to its title, then Share.
- All your own: +, then Share all.
Each of these produces a .txt file in the format above, so what one rider shares another can import unchanged. A ride can become a workout as well: Save as workout on a past ride turns the targets that were ridden into a line, ready to edit and share.
For coaches: handing a program to a rider
A set is how a coach supplies the sessions of a training block. No account, platform or connection is involved; the file is the whole hand-over.
- Write the set. One file per rider or per group, one line per session.
- Put the schedule in the notes. The
>lines say when to ride what: "W1 once a week for 4 weeks, then replace it with W3." Short labels at the start of the names (W1,W2) make that easy to refer to. The app shows the notes and does not act on them; the rider picks the session of the day. - Put the instructions for a session in its description: how it should feel, cadence, when to stop. What the rider should read at a certain moment goes into a cue: "Series starts", "Cadence 100+", "Last one".
- Choose percent or watts.
- For a group, write in percent. Every rider gets their own watts from their own FTP.
- For one rider, watts are just as good. Add
@ftpand the set keeps fitting when their FTP changes.
- Send the file by mail or messenger, or paste the text into a message. The rider imports it as described above and finds it under its title.
- For the next block, send a new set with a new title, for example the month. The rider deletes the old one.
What comes back: the ride itself, through Strava if the rider has connected it. Every step of a workout is recorded as a lap. A rider who had to adapt a session on the bike can save that ride as a workout and send it back as text.
During a ride, the rider can shift the whole workout up or down with the ± buttons. Where the rider should choose the watts themselves, write a free step. The workout itself stays as the coach wrote it.
The examples that ship with the app
The app comes with one set, Examples: eight common structures in percent of FTP. This is that file, exactly. It is a working template for a set of your own.
Download rawwatts-examples.txt
# Examples
> Eight classic structures, in percent of your FTP.
> Duplicate one to change it.
Endurance 45: 45m 65%
Tempo 2x15: 10m 55%, 2x(15m 85%, 5m 55%)
Sweet spot 3x10: 8m 55%, 3x(10m 90%, 4m 55%)
Threshold 2x15: 10m 55%, 2x(15m 100%, 5m 50%)
Over-unders 3x8: 10m 55%, 3x(2x(2m 95%, 2m 105%), 4m 50%)
VO2 4x4: 10m 55%, 4x(4m 115%, 4m 50%)
30/15s: 10m 55%, 3x(13x(30s 125%, 15s 50%), 3m 50%)
One-minute repeats 16x1: 10m 55%, 16x(1m 120%, 1m 50%)
Let an AI write it
This page is all an AI assistant needs. Give it the link, describe the sessions you want, and paste what it writes into the app. If a line is wrong, the app tells you which one.