Export Reports & Sharing Your Data
Turn recorded nights into CSV reports and audio files you can keep, analyze, or hand to a doctor.
On this page
Everything Snore Timeline records stays on your device, and it's yours to do what you like with. The export tools are how you get it out. Pull weeks of sleep data into a spreadsheet, save the audio behind any episode, or package the lot into one report you can send anywhere. This page goes through each export path, what's in the files, and where to find them afterward.
The Export Report sheet
The Export Report sheet is the main export tool. It bundles your data into CSV spreadsheet files inside one ZIP archive, with audio alongside if you want it. To open it, go to the night you want to anchor on, tap the download icon at the top of the Snoring Episodes list, and pick Export Report.
The sheet asks you two things:
- Date range. Pick Last 7 days, Last 30 days, or All time. The range sets how much CSV data the report covers.
- Categories. Toggle which kinds of data to include. Each category becomes its own CSV file inside the ZIP:
- Nightly Summary: aggregated stats per night.
- Sleep Stages: sleep stages over time, from both phone and watch sources.
- Detected Events: snoring, sleep talking, coughs, gasps, and breathing disruptions.
- Watch Biometrics: heart rate, HRV, SpO2, and respiratory rate from a connected Apple Watch.
- Audio (optional): per-episode clips, the full-night recording, or both.
One thing to know. Audio only covers the night you're currently viewing, even when you pick a wider date range for the CSV data. That keeps reports a manageable size, since a week of continuous audio would dwarf the spreadsheets. The app shows a size estimate before it generates anything.
How long it takes, and how to cancel
While an export runs, the app shows progress from 0 to 100 percent with status messages like "Adding nightly summaries…," "Adding sleep stages…," "Gathering recordings…," "Creating full-night audio…," and "Finishing up…" Data-only exports are quick. Audio is what adds the bulk. If the estimated audio size goes over 1 GB, the app warns you that the export may take several minutes and use a fair amount of temporary storage.
You don't have to wait on the sheet. An export with audio keeps running if you close the sheet or switch apps, and on iOS 26 the system shows its progress as Exporting Your Report. You can stop at any time. The button reads "Tap to cancel" while it's generating. Tap it and the export halts and the sheet goes back to idle.
Change the date range, a category, or an audio option after an export and the button goes back to Generate Export, so the next tap builds what you've selected now.
"No data in selected range"
If the range you picked has no recordings in it, the app shows "No data in selected range" and doesn't create a file. Usually that means you didn't record on any night in that window. Widen the range to Last 30 days or All time, or pick dates that cover nights you did record.
The CSV files, column by column
Every CSV opens in Excel, Numbers, Google Sheets, or any other spreadsheet app. Timestamps are ISO 8601 with timezone, for example 2024-01-15T22:30:45-08:00, and night identifiers are plain ISO dates in YYYY-MM-DD format. Any text with commas, quotes, or line breaks in it is quoted so the files parse cleanly. The formatting is kept consistent on purpose, so you can sort, filter, and chart across months of nights without any cleanup.
Nightly Summary
One row per night, covering the whole night. The columns fall into four groups:
- Recording: Night, Notes, Total Recording Duration (s), Total Size (MB), First Recording Start, Last Recording End.
- Sleep: Sleep Score, Sleep Efficiency, Total Sleep (s), Time to Sleep (s), Sleep Detected Via, Light Sleep (s), Deep Sleep (s), REM Sleep (s), Silence (s), Awake (s), WASO (s), Awakenings, Avg Respiratory Rate (bpm). The Sleep Score and Sleep Stages pages explain how these values are derived.
- Snoring: First Episode Start, Last Episode End, Episode Count, Total Snore Time (s), Loudest Peak (dB), Average Peak (dB).
- Events: Total Snore Signals, Total Gasp Events, Total Cough Events, Total Sleep Talking Events, Total Breathing Disruptions.
Units are in the column names. Durations in seconds, sizes in megabytes, respiratory rate in breaths per minute. Loudest Peak and Average Peak are the maximum and average decibel levels across all the detected episodes that night.
Sleep Stages
One row per stage segment, with columns: Night, Source, Stage, Start Time, End Time, Duration (s), Reason, Breathing Rate (bpm). Source tells you whether the stage came from Snore Timeline's audio analysis or from a watch or other Apple Health source, so you can compare the two side by side.
Detected Events
One row per detected sound, with columns: Type, Timestamp, End Time, Peak dB, Source, Silence Start, Silence Duration (s), Recovery Strength (dB). Type is the kind of event, like snoring, sleep talking, cough, gasp, or breathing disruption. The silence and recovery columns are filled in for breathing disruption events, where the silent gap and the strength of the recovery sound are the numbers that matter.
Watch Biometrics
Including Watch Biometrics adds two CSV files:
- Watch Biometrics Samples lists individual readings with the columns Night, Source, Metric, Timestamp, Value, and Unit, covering metrics like heart rate, HRV, SpO2, and respiratory rate.
- Watch Biometrics Aggregates is a per-night summary. Total sleep and time in bed, sleep stage durations, heart rate averages with minimum, maximum, and resting estimates, HRV, SpO2 averages and minimums, respiratory rate, and wrist temperature.
All of this comes from a connected Apple Watch through Apple Health.
Exporting audio
The CSV files describe your night. The audio is the proof. Here's how to get recordings off your phone.
A single episode
In the episode list, tap the download button next to an episode to save its audio clip. Each clip has 2 seconds of padding before and after, so you hear the sound in context instead of starting mid-snore. The icon tells you where the download is at:
- Download icon: ready to download.
- Spinning progress circle: in progress.
- Clock icon: queued. The app downloads up to 2 clips at a time, and the rest wait their turn.
- Share icon: finished and saved. Tap it to open the iOS Share Sheet and send the file anywhere.
- Red X: the download failed. Tap it to try again.
When a clip is saved you'll see a message like "Saved episode '(10:42 PM)' to Files folder." After the first download the app keeps a copy ready, so sharing the same clip again is instant. A download keeps going for a short while if you switch apps, and one that fails cleans up its partial file. Clips recorded at any quality tier, and through a Bluetooth microphone, download the same way.
The full night, or every episode at once
Tap the download icon at the top of the Snoring Episodes list to open Export Report, then turn on Include audio. Choose Full-night recording for one continuous file of the whole night, or Per-episode clips for every episode at once. Tap Generate Export, then Share Export to send it anywhere.
Bundled into a report
The audio lands in the same ZIP as the CSVs for whichever categories you leave switched on, so one export can carry a night's numbers and its sound. The audio always comes from the night you're currently viewing, whatever date range you picked for the data.
Before exporting audio, check your recording quality setting. Higher quality tiers make larger files, which means bigger exports. Storage & Audio Quality explains the trade-offs.
Where your files land
On iPhone, everything you export goes into the Snore Timeline folder, which you can browse in the Files app:
- Open the Files app
- Tap Browse at the bottom of the screen
- Under Locations, tap On My iPhone
- Open the Snore Timeline folder
Inside, files are sorted by type:
ZIP reports are named by their date range in YYYY-MM-DD format, like "SnoreTimeline Report 2024-01-15" for a single day or "SnoreTimeline Report 2024-01-08 to 2024-01-15" for a range, so a folder full of reports stays sorted and searchable. Each night's audio folder also holds a Nightly Summary.csv of overall stats and a Snoring Episodes.csv of per-episode metrics, so audio you download per night travels with its data.
You don't have to hunt for the folder. The export screen has a "View previous exports in Files app" link that opens it.
On Android, open the Files app, go to Downloads, then open Exported Recordings or Snoring Episodes. The Android page covers the other platform differences.
Sharing with a doctor
Once you've generated an export, tap Share Export to open the standard iOS Share Sheet. From there you can send the ZIP report by email, Messages, or AirDrop, or save it to another app. The report holds CSV spreadsheets of your nightly summaries, sleep stages, detected events, and watch biometrics, and can include audio recordings if you chose them.
A wider date range makes a stronger report. A single night could be an outlier. Last 30 days or All time shows a doctor the pattern, which is what they care about. If one night stands out, view that night before exporting so its audio comes along, since gasps and silent gaps are easier to talk about when the doctor can hear them. The Doctor-Ready Data guide walks through putting a report together for an appointment.
Treat the report as something to discuss. It isn't a diagnosis. Snore Timeline analyzes audio and sleep data for your own insight. It isn't a medical device and doesn't diagnose sleep apnea or any other condition. Your data never leaves your device until you choose to share it. The Privacy Policy covers the details.