Somalog Support

Somalog reads the Health data you allow and saves it as open files in a Somalog folder, on your iPhone or in a folder you pick in the Files app. You can open those files with your own tools, give them to an AI assistant, or share a copy of any range of dates. There is no account and no server.

What do I need?

An iPhone with iOS 26 or later, and the Health data you want to keep. You don’t need an account.

How do I start?

Open Somalog and tap Continue, then Continue again on Connect Health. Health asks which types Somalog may read: turn on the ones you want, or all of them. Next you can share medications and Health Records, or skip them for now. On Your First Export, Save To shows where your files will go. To pick another folder, tap Change, then Choose Folder. Then tap Start Export. If you tap Later, Start First Export on Somalog’s main screen begins it when you’re ready.

How long does the first export take?

It reads your whole Health history, so years of data can take a long time. Keep Somalog on screen until it finishes. Somalog keeps the screen awake while it runs, and its main screen shows how many types it has read. If your iPhone locks, the export stops, because Health can’t be read while your iPhone is locked. Nothing is lost: tap Continue Export and it picks up where it left off.

Where are my files?

In the Files app, under On My iPhone > Somalog, unless you picked a folder. If you did, they’re in a Somalog folder inside the folder you picked. Save To in Advanced shows which.

To reach your files from a Mac or another device, pick a folder in a storage service that device also uses, or on a drive or server it can reach. After you reinstall Somalog or restore your iPhone from a backup, Somalog saves to On My iPhone > Somalog again until you pick a folder.

How do I change the folder?

In Advanced, tap Choose Folder and pick a folder in Files. It can be in a storage service you use in Files, or on an external drive or a server. Somalog saves to a Somalog folder inside it. Use On My iPhone goes back to saving on your iPhone. Before your first export, you can also tap Change, then Choose Folder, on the Your First Export page.

Once your first export has started, a different folder starts a new export there. Somalog asks first, then starts the new export right away, reading all your Health data again into the new folder under a new export ID. Files already saved stay where they are, and Activity starts empty. Picking the folder you already use keeps the current export. You can’t change the folder while an export or a copy is running.

What’s in the folder?

Somalog > outbox holds a folder named by your export ID, which Advanced shows. Inside it, each export adds one or more numbered batch folders: 00000001, 00000002 and so on. Your first export writes your whole history across the first batches. Each later export adds what’s new since the one before, including anything deleted from Health.

A batch folder holds:

What do the files contain?

Every line is one JSON object. Timestamps are UTC, in microseconds since January 1, 1970, and durations are in seconds. Each type’s values are in one unit, which the manifest lists. Types are named by their Health identifiers, such as HKQuantityTypeIdentifierHeartRate. The file name says what kind of record it holds:

How do I open them?

They are standard gzip and JSON, so most data tools read them as they are: gzcat or zcat in a terminal, Python’s gzip and json modules, or DuckDB’s read_json, which can read a whole folder of them at once.

Each export ID is one history: read its batches in order. If the outbox holds more than one (after Reset Export, after changing the folder and back, or after reinstalling Somalog or moving to a new iPhone while using a folder you picked), the one Advanced shows is current. Keep the older folders, since they can hold history this iPhone’s Health no longer has.

Batches build on each other. The same record can appear in more than one batch, and the newest copy is current. A workout’s wl lines in a batch replace all its earlier ones. A del file lists samples deleted from Health. Other lines can still point to one by their p or w field, or inside an ids list, so treat those references as gone too. A stat row replaces the older row for the same type, period and time, and an act row the one for the same day, instead of adding to it. Each char line replaces the last. Later batches re-send stat and act rows for recent days, and for all time once a month. The manifest’s snapshots list says what a batch re-sent whole: within each listed window or kind, older rows the batch doesn’t include are gone. The newest batch’s types_off lists the types you turned off: leave those out, including their rows in earlier batches. A type it no longer lists counts again from every batch.

To use an AI assistant, give it the folder, or the batches you want it to read, and tell it what this page says about the format. An assistant that can run code can read the files directly.

How do I share a copy?

On Somalog’s main screen, tap Share a Copy and choose the dates: Last 30 Days, Last 12 Months, All Time or Custom, which asks for From and To. Tap Make Copy and keep Somalog open until it’s ready, because locking your iPhone stops the copy. Somalog puts the data in one zip file and opens the share sheet, where you choose where it goes, such as a person, an app or a folder in Files. If you close the share sheet without sending it, Share Again opens it again. Your Somalog folder and your export stay as they are. Somalog deletes its own copy of the zip when you’re done with Share a Copy, or the next time it opens. You can make a copy before your first export. Export Now is unavailable while a copy is being made.

What’s in a copy?

The zip is named for its dates, such as Somalog Health Data 2025-11-14 to 2026-11-14.zip, or Somalog Health Data through 2026-11-14.zip for All Time. Inside, a folder of the same name holds outbox, then a folder named by the copy’s own export ID, then numbered batch folders in the same format as your Somalog folder.

A copy holds the samples that start within its dates, Health’s totals and Activity rings for those days, and your Health Details and workout zone settings, which have no dates. If you’ve shared them, it also holds your medication list, and the vision prescriptions and health documents from those dates. Health Records come along only in an All Time copy, because Health dates them by when they were downloaded, not by when the care happened. It leaves out deletions. Its batches are marked as a range copy, which format 2.1 added: each manifest has batch_kind range and a range with from_us and to_us. Every types entry has scan_complete false, so a reader that removes deleted records never removes anything because of a copy.

How do I keep my files up to date?

Each export after the first adds only what’s new since the one before. Tap Export Now whenever you want your files current, or run the Export Health Data action from Shortcuts. The main screen says when the last export was. To have Somalog export for you, turn on Keep Up to Date, on the main screen or on the Your First Export page. Somalog then saves new Health data every few hours in the background, when iOS allows. This uses some battery. Health can’t be read while your iPhone is locked, so background exports happen only while it’s unlocked. With Keep Up to Date on, the main screen says Up to date when the last export was under 26 hours ago, and Not exported recently after that.

Keep Up to Date is on, but my files fall behind.

iOS decides when Somalog may run in the background, and the main screen says when a setting is in the way. If it says “Background App Refresh is off”, tap Open Settings and turn it on for Somalog. If it’s off for the whole iPhone, turn it on in Settings > General > Background App Refresh. If it says “Low Power Mode is on”, iOS pauses background work until Low Power Mode goes off. Export Now saves what’s new in every case.

Can I include medications, documents and Health Records?

Yes. Health shares them only when you choose them, separately from everything else. In Somalog, open Data Access and tap Share Medications, Prescriptions, and Documents, or Share Health Records. Health asks about each one, and the next export includes what you share. Share Health Records appears only where your iPhone supports Health Records. Each option covers only the categories you keep on: Medications for medications, Body Measurements for vision prescriptions, and Health Records for documents and records.

Can I leave some kinds of data out?

Yes. In Somalog, open Data Access, tap Categories and turn off any category, such as Cycle Tracking or Workout Routes. You can also tap Choose Categories before you connect Health. Somalog stops reading a category that’s off and asks Health only for the categories that are on. Each new batch’s manifest lists the types that are off, so tools that read your files can leave out what earlier batches hold for them. Somalog doesn’t rewrite earlier files. Turn the category back on and it returns, with what changed while it was off. Once your first export is done, Somalog exports as soon as you make a change. Health’s own settings don’t change: to change what Somalog may read, go to Settings > Privacy & Security > Health > Somalog.

It says “First export stopped” or “Export stopped”.

Your iPhone locked, or iOS ended the export, before it finished. Tap Continue Export with Somalog on screen. It picks up where it left off, and the files already saved are complete.

It says “Can’t reach your folder”.

Somalog couldn’t open the folder this export saves to, so the last export saved nothing. If the folder is on an external drive or a server, connect it, then tap Try Again. If the folder was deleted or moved to another place, or you signed out of its storage service, tap Choose Folder Again on the main screen, or Choose Folder in Advanced. Somalog exports right away, so you see whether that fixed it. Picking the same folder again carries on the export, and a different folder starts a new one. Somalog never saves to another place on its own, so all the batches of an export stay together.

It says “No Health data found”.

Somalog’s first export found no Health data it may read. Health doesn’t tell apps which types you turned off, so turning them all off looks the same as having no data. If you expected some, check what Somalog may read in Settings > Privacy & Security > Health > Somalog, then tap Start Over. Somalog then reads your whole history again under a new export ID.

Data Access lists types as not readable.

Health hasn’t given Somalog an answer for these types, so the last export skipped them. Turn them on in Settings > Privacy & Security > Health > Somalog. On iOS 26.5, Health can leave systolic and diastolic blood pressure without an answer even after you allow access.

Types you turned off don’t appear in this list, because Health doesn’t tell apps which types are off. They stay in Categories > All Types and export nothing.

Data Access says Health shares only recent history.

On iOS 27, Health can share only recent history with an app. Data Access shows how many types are limited and from when. For your full history, choose Full History in Settings > Privacy & Security > Health > Somalog. If you change it after your first export has started, tap Reset Export in Advanced to read your whole history again.

It says “Documents are waiting”.

Health documents can be read only while Somalog is on screen. Tap Export Now (or Continue Export, if your first export hasn’t finished) with Somalog open, and the export reads them.

It says “Export didn’t finish”.

Somalog hit an error. The files already saved are complete, and Try Again continues from them. The error is in Activity. If it keeps happening, email us the error.

Can I export from Shortcuts?

Yes. Somalog adds an Export Health Data action to Shortcuts. It saves new Health data to your Somalog folder without opening the app, then tells you how it went. Run it from a personal automation that fires while your iPhone is unlocked, such as when you open an app you use every day. It works once you’ve started your first export in Somalog.

What does Reset Export do?

In Advanced, Reset Export starts over: the next Start First Export reads all your Health data again under a new export ID, in a new folder. Batches already in the folder stay there until you delete them. Activity starts empty. Deleting and reinstalling Somalog also starts a new export ID.

How do I delete my data?

Your files are yours. To delete them, open the Files app, go to the Somalog folder (On My iPhone > Somalog, or the Somalog folder inside the folder you picked) and delete the folders inside. If they appear in Recently Deleted in Files, delete them there too. Deleting Somalog deletes On My iPhone > Somalog and everything else Somalog keeps on your iPhone. It doesn’t delete files in a folder you picked, or copies you shared. To stop Somalog reading Health, turn off its access in Settings > Privacy & Security > Health > Somalog.

Are my files in my iPhone backups?

Somalog asks iOS to leave the files it saves in On My iPhone > Somalog, and its own records, out of your iPhone’s backups, including iCloud Backup. So a phone restored from a backup starts a new export. A folder you pick is backed up or not under its own rules. To keep your files if you lose your iPhone, pick a folder in a storage service or on a drive, or share a copy and keep it somewhere else.

Does Somalog send my data anywhere?

Only where you put it: your Somalog folder, on your iPhone or in the folder you picked, and the copies you send from the share sheet. A folder in iCloud Drive or another storage service is stored by that service. Somalog has no account and no server, makes no network requests of its own, and contains no analytics or advertising. Snowy Ghost never receives your Health data. Read the privacy policy.

Contact

Email team@snowyghost.com, and include your iPhone model and iOS version. A person will reply.