Snore Timeline logo Snore Timeline Support Download
Devices & health

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.

Export Report sheet with date range and category toggles
The Export Report sheet. Pick a range, toggle categories, generate a ZIP.

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 "Writing nightly summaries…," "Writing sleep stages…," "Preparing audio…," and "Packaging archive…" 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 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.

"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. There are three ways 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.
  • X: the download failed.

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.

The full night, or every episode at once

Tap the download icon at the top of the Snoring Episodes list and choose Export Full Night Audio to save one continuous file for the whole night. The file saves and a share sheet pops up. The same menu lets you download all of the night's episodes in one go instead of tapping each one.

Bundled into a report

The Export Report sheet has two audio options. Per-Episode Clips packages a separate clip for each detected episode of the night, and Full-Night Recording packages one continuous file. Either one lands in the ZIP next to the CSVs. Remember that this audio always comes from the night you're currently viewing, whatever date range you picked for the data.

Tip

Before exporting audio, check your recording quality setting. Higher quality tiers make larger files, which means bigger exports. Storage & Recording 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:

  1. Open the Files app
  2. Tap Browse at the bottom of the screen
  3. Under Locations, tap On My iPhone
  4. Open the Snore Timeline folder

Inside, files are sorted by type:

Files > On My iPhone > Snore Timeline ZIP reports from the export screen, named by date range
Files > On My iPhone > Snore Timeline > Exported Recordings Full-night audio exports
Files > On My iPhone > Snore Timeline > Snoring Episodes Individual episode audio clips

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.

Snore Timeline folder in the Files app showing reports and audio folders
Exported reports and audio in the Files app on iPhone.

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.