CatBreath / User guide
A simple guide to everyday records
From your first measurement to importing older records, find what you need below.
Your cats
- Tap Add cat on Measure, or open Settings → My cats.
- Enter a name. Birthday, sex, breed and notes are optional.
- After measuring, choose the cat before saving. You can register a cat here too.
- Choose a cat in Records to see only their measurements, events and charts.
- To delete a cat, open Settings → My cats, swipe their card left and tap the trash icon. You can do this without tapping Edit. You can also tap Edit, open the cat’s card and tap Delete cat and records below Save. Both ask you to confirm before deleting.
- Deleting a cat also deletes their measurements, events, medicines, doses, photos and custom measurements. This cannot be undone. Other cats and unassigned records are kept.
1. Measure breathing
- Open Measure. Watch your cat’s chest or belly.
- Tap on the first breath to start at 0. Tap once for each breath after that.
- The count ends by itself after 30 seconds, or 20 or 60 chosen under Measuring time in Settings. Tap Finish to stop earlier.
- Check the breaths per minute — the large number, in whole breaths — choose Sleeping or Resting, select your cat, then Save.
2. Add a past measurement
- Open Records → choose a measurement → +.
- For a new measurement, tap + beside Measurements. Enter its name, choose Number / Count / Percent, then enter the unit (or check the fixed times / % unit). Finally choose Display as: Total or Average. Total adds each day’s entries; Average uses their mean. Individual records are kept.
- To change an existing measurement, tap Edit beside its title in record history. You can also use the item’s Edit button in the edited Measure or Records list, or in Settings → Measurements. Edit its name, unit or Total / Average, then Save. Its value kind stays fixed. Weight allows unit changes only.
- To delete a custom measurement, swipe its card left on Measure or Records, or use Delete measurement type below Save in its edit form. Confirm the named item and its records. Deleting an item with records removes all of that item’s readings and cannot be undone; other measurements and cats are kept. Built-in measurements cannot be deleted.
- Changing Total / Average recalculates past charts without changing individual records. Two entries of 2.5 and 4.5 on one day give a total of 7 or an average of 3.5. Changing a unit only changes its label; values are not converted.
- Enter the value in the unit shown.
- Enter the measurement date and time, select your cat, then Save.
- Records lists measurements first. Under each number it says whether it is the latest record, with its date, or that day's total. Event history at the top opens the events; Dose history is further down.
3. Import CSV or a spreadsheet
- Open Records → choose a measurement → Import records.
- Choose a CSV file, or paste a table with the columns shown below.
- Tap Preview. Correct any highlighted rows.
- Select the cat, check the dates and values, then tap Save.
date,time,value
2026-01-15,09:30,4.6
2026-01-16,18:00,4.7| Column | Format / example |
|---|---|
| date | Measurement date as YYYY-MM-DD, with two digits for month and day. Example: 2026-01-15. The earliest accepted date is 1980-01-01. |
| time | Measurement time as 24-hour HH:mm, including the colon. Examples: 09:30, 18:05. Do not use 0930 or AM/PM. |
| value | The numeric reading, such as 4.6, 25 or 0. Use a decimal point (.), without units such as kg, mL or %, or thousands separators. |
CSV formatting rules
- The first row must be the English header date,time,value. Every following row must use those three columns in that order. Do not add cat names, measurement names, notes or extra columns.
- Choose a comma-separated UTF-8 CSV file, or copy the three columns including their header from Excel or Numbers and paste as a tab-separated table. Export .xlsx and .numbers files as UTF-8 CSV first.
- Each import is for one measurement and one selected cat. The file has no cat or unit column: the cat you choose and the unit shown on screen apply to every row. Convert values to that unit yourself before importing.
- Dates and times use your device’s current time zone. Do not append a time zone or UTC suffix. Invalid calendar dates, nonexistent local times, future times and blank date, time or value cells are errors.
- Values must be zero or greater. Counts require whole numbers; percentages must be 0–100. Built-in breathing rate and weight must be greater than zero. Negative values, formulas and scientific notation (1e3) are not accepted.
- Use at most 1 MB and 1,000 data rows, excluding the header. Split larger imports into separate files. Replace the example dates and values with your own measurements.
- Preview the dates, values and row errors. Fix every error in the file or pasted text, then preview again before saving. Previewing alone does not save any records.
- A matching cat, measurement, timestamp and value is skipped as a duplicate, both within the file and against saved records. A different value at the same time is added as another record; it does not overwrite an existing value.
- The full CSV made by Export records uses a different format. Restore that file with Settings → Local records → Import backup, rather than this three-column import.
4. Compare records
- Choose a period above the plot. Spread two fingers to zoom; drag while zoomed to move through time.
- Tap a date to see its values and event notes. Tap ? for help with the current chart, or ⤢ to open it full screen — the phone can be turned either way.
- Tap the names above the chart to draw a record or take it away. Trend shows each one in its own color, and Ratio draws them beside the ratio of two. Edit the list below to change their order.
- Switch a measurement between a line and candles at the top of its chart, or for Compare beside its name while editing; each place keeps its own choice. In Settings, Charts sets the style for new measurements, whether a line shows each day's mean or every record, and can change every chart at once. A candle's line runs from the day's lowest to its highest reading, its box spans one standard deviation either side of the mean, and a dashed bar marks the median.
- Choose Ratio to see one record divided by another, or Correlation to see paired daily values.
5. Keep event notes
- Open Event history at the top of Records, or Event history → Events on Measure. Use + for a new note; swipe a note left to delete it.
- Choose the cat and date, then add a note such as a food change or vet visit.
- You can also add an event for a date selected on a chart.
6. Medicines and the schedule
- Open Medicines on Measure. Use + to add a medicine; tap Edit, then a medicine, to change it. Swipe a medicine left to hide or delete it.
- Choose a date in Schedule before adding a medicine: it becomes the default start date. That date also follows you through Medicines to record a dose or add a medicine. Editing a saved medicine keeps its stored start date.
- You can also delete an existing medicine below Save in its edit form. If it has doses, choose Hide to keep its records or Delete with records to remove the medicine and all its doses permanently. In Edit, hidden medicines can be restored, edited or swiped left to delete.
- Enter the medicine name and start date. The amount, times a day and number of days are optional.
- For one to four doses a day, the times below Times a day — Morning, Midday, Evening, Night — name each dose. The first highlighted time is the first dose: started this afternoon, a course begins in the evening. Tap a time to add or remove it; drag a highlighted one to change where the course starts. Seven days begun in the evening end on the eighth morning. Five or more doses a day are numbered instead. Changing the times later applies from today, or from tomorrow once today has a ticked dose; earlier days keep their names.
- Fill in the days, or turn on Ongoing for a medicine with no end date, and the app offers a daily checklist.
- ‹ and › move one day. Tap the date to choose a year, month and day on the dial, then Confirm. Week or Month changes the calendar; Today returns to the current date.
- Tap a day to see its doses below. Unticked doses stay in the list; completed doses are folded under Completed.
- A day with medicine carries a dot: its colour says how many medicines that day holds, and it fills in once they are all done.
7. Photo feed
- In Schedule, switch from Doses to Feed above the calendar. The calendar and dates are shared; a day’s dot shows how many photos it holds.
- Tap + to add a photo: choose it from your library or tap Take photo, set the date and a memo, select your cat and Save. The app receives only the photo you pick, so it asks for no access to your library. Take photo asks for camera access the first time; the shot is kept in CatBreath and goes to your Photos app only when you save it there.
- Tap a photo to see it full screen, and pinch there to zoom. Save to Photos at the bottom adds it to your Photos app; the first time, iOS asks to let CatBreath add photos. Tap Edit, then a card, to change or delete it.
- As you scroll down through the photos, the selected date stays on a bar at the top; tap it to return to the calendar.
8. Appearance and language
- Choose Dark or Light in Settings. Dark is the default.
- Choose English, Korean or Japanese in iOS Settings → Apps → CatBreath → Language. English is the fallback.
- Use + on Measure or Records to add a measurement. Edit lets you reorder or hide items. Tap a unit to edit it, then Save or Cancel; only one unit can be edited at a time and the selected cat stays fixed. Swipe a custom measurement left to delete it, with or without entering Edit. Each cat keeps its own list.
9. Your records and troubleshooting
- Records are stored on this device. There is no cloud sync or account backup, so export a copy you keep yourself.
- Open Settings → Local records → Export records to save every cat, measurement, event, medication, individual dose and photo card as one CSV file. Export with photos adds the photos themselves.
- Use Import backup in the same section to preview and add records that are missing from this device. Existing records keep their current contents.
- Swipe a record left in its history screen to delete it. Deletion cannot be undone. Deleting the app deletes its records with it, so export before you reinstall.
- All record and definition forms use Save. If the data is saved but the screen cannot reload, the fields stay locked and Try again only reloads the saved result. Leaving an unsaved form asks before discarding; Cancel keeps the draft.
- If a chart fails, tap Try again or change its period or view. If it keeps happening, note the error code and what you were doing.
Full backup CSV format
- Choose the original CSV made by Settings → Local records → Export records. It restores cats, measurement definitions, readings, events, medications and doses together. This differs from a per-measurement date,time,value file.
- Current backups start with kind,cat,type,unit,date,time,value,note,backup. The first eight columns are readable in a spreadsheet. The last backup column holds IDs, exact times, medication schedules, display settings and other restoration data. Keep all columns and leave the exported file unchanged.
- Use a UTF-8 CSV up to 100 MB. Review the preview, then confirm restoration. Only missing items are added; existing records and edits are kept. Damaged files are rejected without restoration.