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 everything on your device belongs to you. The export tools make that ownership practical: pull weeks of sleep data into spreadsheets, save the audio behind any episode, and package it all into a single report you can send anywhere. This page explains each export path, what's inside 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 a single ZIP archive, with optional audio alongside. To open it, navigate to the night you want to anchor on, tap the download icon at the top of the Snoring Episodes list, and open Export Report.

From the sheet you make two choices:

  • Date range. Pick one of three presets: Last 7 days, Last 30 days, or All time. The range controls 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 detail matters here: audio covers only the night you are currently viewing, even when you select a wider date range for the CSV data. That keeps report sizes manageable, since a week of continuous audio would dwarf the spreadsheets. The app shows a size estimate before generating.

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 such as "Writing nightly summaries…," "Writing sleep stages…," "Preparing audio…," and "Packaging archive…" Data-only exports finish faster; audio adds the bulk. If the estimated audio size exceeds 1 GB, the app warns you that the export may take several minutes and use significant temporary storage.

You can stop at any time. The button reads "Tap to cancel" while generating; tapping it halts the export and resets the sheet to idle.

"No data in selected range"

If your chosen range contains no recordings, the app shows the error "No data in selected range" and creates no file. This usually means you didn't record on any night within that window. Widen the range to Last 30 days or All time, or pick dates covering nights you recorded.

The CSV files, column by column

Every CSV opens in Excel, Numbers, Google Sheets, or any other spreadsheet app. Timestamps use ISO 8601 format with timezone information, for example 2024-01-15T22:30:45-08:00, and night identifiers use plain ISO dates in YYYY-MM-DD format. Text containing commas, quotes, or line breaks is quoted so the files parse cleanly. The consistent formatting is deliberate: it lets you sort, filter, and chart across months of nights without cleanup.

Nightly Summary

One row per night, covering the whole picture of that night. The columns group into four areas:

  • 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 Events, Total Gasp Events, Total Cough Events, Total Sleep Talking Events, Total Breathing Disruptions.

Units follow 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 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 connected watch or 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 indicates the kind of event, such as 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 data points 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 gives 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.

This data comes from a connected Apple Watch via Apple Health.

Exporting audio

CSV files describe your night; audio proves it. 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 includes 2 seconds of padding before and after the episode, so you hear the sound in context rather than starting mid-snore. The icon tells you the state of the download:

  • Download icon: ready to download.
  • Spinning progress circle: in progress.
  • Clock icon: queued. The app downloads up to 2 clips at once; extras wait and start as earlier ones finish.
  • 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 '[start time]' 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 select Export Full Night Audio to save one continuous file for the whole night; the file saves and a share sheet appears. The same menu lets you bulk download all of the night's episodes at once instead of tapping each one.

Bundled into a report

The Export Report sheet offers 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 lands in the ZIP alongside the CSVs. Remember that this audio always comes from the night you are currently viewing, regardless of the date range you picked for the data.

Tip

Before exporting audio, check your recording quality setting. Higher quality tiers produce larger files, which means bigger exports. Storage & Recording Quality explains the trade-offs.

Where your files land

On iPhone, everything you export lives in the Snore Timeline folder, browsable 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 organized 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, such as "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 of reports stays sorted and searchable. Each night's audio folder also contains 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 can jump to this folder without hunting for it: the export screen includes 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

After you generate an export, tap the Share Export button 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 contains CSV spreadsheets of your nightly summaries, sleep stages, detected events, and watch biometrics, and can optionally include audio recordings.

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 a particular night stands out, view that night before exporting so its audio rides along, since gasps and silent gaps are easier to discuss when the doctor can hear them. The Doctor-Ready Data guide walks through assembling a report for an appointment step by step.

Treat the report as information to discuss, not a diagnosis. Snore Timeline analyzes audio and sleep data for your personal insight. It is not a medical device and does not 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.