User manual
Everything Control Pause does, and how to use it.
Control Pause times your Buteyko-style breathing sessions and keeps a record of your readings. It walks you through a session one step at a time, with a timer for each step, and keeps a history of every session you save.
Control Pause is a timing and recording tool. It doesn't teach breathing techniques, and it doesn't give medical or health advice. It's for people who have already learned the practice. If you have a medical condition, or feel dizzy, unwell or uncomfortable during a session, stop and talk to a doctor. Follow the guidance of whoever taught you the practice.
1. Getting started
The first time you open the app
The app asks one question first: should it record your pulse, and how? Sessions normally start and end with a pulse step.
- Count it myself: you count your pulse for 15 seconds and type the count. The app does the sum.
- Use a device: you type in the reading from a watch or other device. The app doesn't connect to the device.
- Don't record my pulse: the pulse steps are left out of every session. Everything else works the same.
You can change your mind at any time in Settings → Pulse readings. The change applies from the next session.
The screens
The bar along the bottom moves between the three main screens:
- Home, where you start a session.
- History, your past sessions, as a graph and in detail.
- Settings, your preferences, the paid version, and information about the app.
The fourth screen, Session, opens when you start a session. It has no bottom bar, so nothing distracts you mid-exercise, and you leave it by saving or cancelling the session.
Home
Home shows how many sessions you've done today and when the last one started, such as "Today: 2 sessions · last at 1:05 pm". Under the Start Session button is what a session involves, such as "12 steps · about 20 minutes". Home only counts sessions: it never sets you a target.
2. Doing a session
Starting
Tap Start Session on Home. The Session screen opens on the first step.
The steps come from the session config in use: the app's standard one, or your own (see Custom session configs). The standard session is 12 steps:
- Pulse
- Control Pause
- Reduced Breathing, 4 minutes, then Relax, 1 minute, then Control Pause, three times over
- Pulse, to finish
Without the pulse steps, it's 10. A session keeps the same steps and pulse method until it ends, even if you change a setting in the meantime.
While a session is open, the screen stays on, so the phone doesn't lock itself in the middle of a step.
What's on the screen
The screen shows the current step: its heading, its instructions, and a large timer. Pulse steps have a box to type into, and with Use a device the box replaces the timer.
Down the side is the timeline, one small icon for each step in the session:
- a heart with a heartbeat line for Pulse
- a stopwatch for Control Pause
- a pair of lungs for Reduced Breathing
- a face wearing sunglasses for Relax
Each icon's colour shows how far you've got:
- grey: not reached yet
- yellow: the current step, not finished yet
- blue: the current step, finished and ready to move on
- green: done
Each step that's done shows its value under its icon, such as "72" for a pulse, "32s" for a time under a minute, or "4:00" from a minute up, so the timeline reads as a running record of the session. In a long session, it scrolls to keep the current step in view.
The timer
Every step has the same timer, with three round buttons: start (▶), stop (⏸) and reset (↻). It never starts by itself: press start when you're ready. Depending on the step, it either:
- counts down from a set time to zero, and reset puts it back to the set time, or
- counts up from zero, like a stopwatch, and reset puts it back to zero.
While it's running, it shows tenths of a second.
Each kind of step
Pulse
How this step works depends on the choice you made in Settings → Pulse readings.
Count it myself: find your pulse and press start, then count the beats until the 15-second timer reaches zero. A box then appears: type your count and tap Done on the keyboard. The app multiplies it by 4 and shows the result, such as "= 72 beats per minute". The count must be from 8 to 55. Outside that range, a line under the box says "Enter a number from 8 to 55" until it's changed.
Use a device: there's no timer. Type the reading from your device, in beats per minute, into the box and tap Done on the keyboard. The number must be from 30 to 220. Outside that range, a line under the box says "Enter a number from 30 to 220" until it's changed.
Control Pause
Press start when you begin the hold, and stop when it ends. The timer counts up, and the time when you press stop is recorded as the reading. There's nothing to type.
A reading has to be at least 5 seconds. A shorter one, usually from pressing start and stop by accident, doesn't count, and the step says "Must be at least 5 seconds". Press reset to start again, or start to carry on timing from where it stopped.
Reduced Breathing and Relax
Press start, and the timer counts down from the set time. The step is finished when it reaches zero. Press stop to pause part-way, and start to carry on.
Moving on, saving and cancelling
NEXT moves on to the following step. It works once the current step is finished, with its icon blue.
On the last step, NEXT becomes SAVE. Tap it to save the session. A "Session saved" message shows how long it took, and the app goes back to Home.
Cancel is always there. It asks first ("Keep going" or "Discard session"), then drops the session and goes back to Home. On the first step there's nothing to lose, so it doesn't ask. Only saved sessions go into your history.
On Android, the back button does the same as Cancel during a session.
3. Leaving the app during a step
You don't have to keep watching the app. During a step, you can lock the phone, put it down or switch to another app, and the timer carries on.
When a countdown finishes while you're away
The phone gives three alerts, each with the step's name:
- when it finishes, such as "Relax: your timer has finished"
- a moment later, in case you missed the first (a second later on iPhone, 3 seconds on Android)
- 7 seconds after it finished, the last chance: "Come back now to keep this session."
When you come back, the step is finished and ready to move on. The session never moves on by itself: you always tap NEXT. If you watch a countdown reach zero in the app, there are no alerts, since you can see it's finished. If sound is on in Settings, a soft chime plays instead.
During a Control Pause
The stopwatch keeps counting while you're away, so when you come back it shows the full length of the hold, as if you'd watched it the whole time.
If too much time passes
A session is a sequence of steps without long gaps between them, so the app doesn't wait indefinitely:
- If a countdown finishes and you don't come back within 10 seconds, the session is discarded.
- If a Control Pause stopwatch is left running for more than 10 minutes, the session is discarded.
A discarded session isn't saved. The next time you open the app, a message says so: "Your previous session ran too long between steps and wasn't saved". The same applies if the phone closed the app in the background: when you reopen it, the session carries on where it was, or is discarded if too much time has passed.
If the alerts don't come
Check that notifications are allowed for Control Pause:
- iPhone: in Settings → Notifications → Control Pause, turn on Allow Notifications and Time Sensitive Notifications. If you use a Focus or Do Not Disturb, allow time-sensitive notifications in Settings → Focus too.
- Android: in Settings → Apps → Control Pause, allow notifications, and turn off battery optimisation for the app if your phone has it.
4. History
The graph
The graph shows your Control Pause readings by day. Each point is the average of that day's readings. Pulse isn't graphed.
- The most recent day is shown first. Once there's more than about a week, scroll sideways for earlier days.
- Days without a session are a gap in the line.
- The graph shows the numbers as they are. It doesn't score them, or say whether they're going up or down.
A day, then a session
Tap a day on the graph to list its sessions, with the time each started and its average Control Pause. Tap a session to see every step, with its result, such as "CP · 32 sec", and how long the whole session took. If you used your own session config, its name is shown too. A day with only one session opens it straight away.
On Android, the back button closes the open session, then the open day.
The last 7 days, or everything
The free version's graph shows the last 7 days, today included. The paid version shows your whole history. Every session is saved either way, so upgrading later shows it all straight away. When older sessions are left out, a line under the graph says how many.
Export and import (paid version)
The export button beside the History heading opens a panel with:
- Export: your whole history as a CSV file, which any spreadsheet app opens, to keep as a backup, look at elsewhere, or move to a new phone. There's one row per step, with the session's start time, length and config name, and the step's number, type and value: tenths of a second for times, beats per minute for pulse.
- Import: replaces your history with an exported one, after asking first. The old history is kept as a backup. Only a file exactly as the app exported it can be imported: if it's been changed, even just opened and saved again by a spreadsheet app, it's refused, and nothing changes.
To move your history to a new phone, export it on the old phone, send the file to yourself (for example by email or to Files), and import it on the new one.
5. Settings
- Pulse readings: the same choice as the first time you opened the app. It applies from the next session.
- Haptics: a light tap when the timer starts or stops, and when a step finishes. On by default.
- Sound: a soft chime when a step finishes on screen. On by default. On iPhone, the silent switch mutes it.
- Session config: which steps a session is made of. See Custom session configs.
- Paid version: whether the app is unlocked, with Unlock and Restore purchase. See The paid version.
- About Buteyko-style breathing, the Disclaimer, and About the developer.
- Send feedback or report a problem: opens a new email to the developer. See Getting help.
6. Custom session configs (paid version)
A session config is the list of steps a session is made of: their kinds, timings and wording. The app comes with a standard one. With the paid version, you can write your own, to change the steps, their order and their timings.
The top of Settings → Session config shows which one is in use: "Default", or your own config's name, with how many steps it has and roughly how long it takes.
Writing your own
- Download the template from Settings → Session config. It's the standard config as a text file,
control_pause_config_template.txt, with notes on every field. Save it somewhere you can edit it, such as Files on iPhone, or email it to yourself and edit it on a computer. - Change it in any plain text editor: add, remove or reorder steps, and change their times and wording.
- Give it a name of your own, in place of
"default". - Upload it from Settings → Session config → Upload a custom config.
The app checks the file. If anything needs changing, it lists what and where, such as "Step 4: Relax preset must be between 5 seconds and 30 minutes", and nothing changes until the file passes. Once it's accepted, every new session uses it.
You can't upload a config, or go back to the default, while a session is in progress. Finish or cancel it first.
What a step looks like
Each step is a block like this one, from the template:
{:type :relax
:label "REL"
:heading "Relax"
:instructions "Rest and breathe normally through your nose."
:timer-config {:type :delay :preset 600}
:data-source :delay-preset
:data-key :relax1}
Every step needs all of these, except that a Pulse step has no :instructions, as the app has its own wording for it:
:type::pulse,:control-pause,:reduced-breathingor:relax.:label: 1 to 4 characters, shown in History's session detail.:heading: 1 to 40 characters, the step's title.:instructions: up to 500 characters, shown under the heading.:timer-config:{:type :delay :preset <time>}counts down;{:type :stopwatch :preset 0}counts up, for a Control Pause.:data-source::inputfor Pulse,:stopwatch-valuefor Control Pause, or:delay-presetfor Reduced Breathing and Relax.:data-key: a name for the step's value, different on every step, such as:relax1,:relax2.
The rules
- Times are in tenths of a second, in whole seconds:
150is 15 seconds,600is 1 minute,2400is 4 minutes. - Pulse timers: always 15 seconds. Reduced Breathing and Relax: 5 seconds to 30 minutes.
- A config has 1 to 20 steps, at least one of them a Control Pause.
- Its name is 1 to 40 characters, and can't be "default".
If you've chosen not to record your pulse, any pulse steps in your config are left out too.
The wording in a custom config comes from whoever wrote the file, not from the app.
Going back to the default
While a custom config is in use, Settings → Session config has Go back to the default. After you confirm, your config is removed and sessions use the standard steps again. Keep your file if you might want it again.
7. The paid version
The free app is complete on its own. A single one-off payment, not a subscription, adds:
- Full history: your whole history in the graph, not just the last 7 days.
- Export and import: your history as a spreadsheet file.
- Custom sessions: your own steps, timings and wording.
It also covers any paid features added later.
Unlocking
Tap Unlock wherever a paid feature shows up: under History's graph, in History's export panel, or in Settings → Paid version. A window lists what the paid version adds, with a button showing the price in your currency. The payment happens in the App Store's or Google Play's own payment sheet, like any other in-app purchase, with no account to create. The paid features are available as soon as it goes through.
If a purchase needs approval, such as by a parent, the app says so, and unlocks as soon as it's approved, even if the app was closed in the meantime.
Restoring a purchase
The purchase belongs to your App Store or Google Play account, and the app checks it each time it starts, so reinstalling usually unlocks it straight away. If it doesn't, for example on a new phone, tap Restore purchase in Settings → Paid version. You won't be charged again.
8. Your data
Everything is kept on your phone: your sessions, your settings and your custom config. There's no account, and the app sends nothing to the developer. The details are in the privacy policy.
When it starts, the app checks with Expo, the service it's built with, for small updates to its code. A new update is usually used from the next time you open the app. The check sends technical details only, never your sessions or readings, and without an internet connection the app simply carries on as it is.
Uninstalling the app deletes its data, apart from any copies you've exported yourself, or your phone's own backups. To keep your history, export it first (paid version).
9. Getting help
Control Pause is made and looked after by one person, so every message comes straight to me. The easiest way to get in touch is from the app: Settings → Send feedback or report a problem. It opens a new email with the app version, phone model and system version filled in, which helps me track down a problem. Or email controlpause@riwepo.com.
Common questions are answered on the Support page.