Guide

How to use Thermocline on iPhone, iPad and Mac, task by task. Written for the beta; menus can still change between builds. Updated 16 November 2026.

Something not working? See Troubleshooting. Thermocline is a logbook: it shows what your dive computer recorded and never calculates decompression.

Get the app

Thermocline is for Apple devices only: iPhone, iPad, Mac and Apple Watch. During the beta it's installed through Apple's TestFlight app.

First launch and the tour

The first launch asks your name, your units and where your dives come from. Units are stored in metric; changing them only changes the display.

iPhone and iPad

Everything else lives in the Profile tab. Profile → Help → Show the tour walks through every screen on a sample logbook, not yours.

Mac

Settings are under Thermocline → Settings. Help → Take the Tour opens the tour on a sample logbook.

The iPhone logbook: one dive waiting under To confirm, then the dive list with site, date, depth and time.
The logbook on iPhone. Dives that need a site or gas wait at the top.

Screenshots on this page show the sample logbook from the tour: the dives and sites are made up.

Bring your logbook

Thermocline reads MacDive (its database, XML or UDDF), a Shearwater Cloud database, UDDF from any logbook, and CSV. You choose which dives to add, and anything it can't read is listed, never silently dropped.

iPhone and iPad

  1. Profile → Your data → Import a logbook file.
  2. Pick the file, from iCloud Drive or Files.
  3. Untick any dives you don't want, then Import.

Mac

  • File → Import from MacDive… and choose MacDive's folder. This is the fullest route: dives, dive photos and card photos. MacDive's files aren't changed.
  • For exported files (UDDF, MacDive, Shearwater Cloud, CSV), use the File menu's import command (⇧⌘I).

Coming from MacDive on iPhone only? In MacDive on your Mac, select your dives, choose Export → Dives → Selected as UDDF, save the file to iCloud Drive, and import it on the iPhone.

When the import finishes, a report shows how many dives were added, which items were not imported and why, and anything to check. Dives whose file had no gas wait in To confirm. A restore point is saved before any import of more than one dive, and on the Mac Undo Import… takes it back.

MacDive's UDDF export leaves out gear, gear sets, dive types and photos. Importing MacDive's folder on the Mac brings those across too.

Download dives from your computer

Put the dive computer in its Bluetooth mode first. On a Shearwater: Menu → Bluetooth. It stays there about two minutes. Only dives newer than your last download are fetched.

iPhone and iPad (Bluetooth)

  1. Logbook → Download Dives.
  2. Pick your computer under Nearby. The first time, type the PIN shown on its screen.
  3. Untick any dive you don't want, then Keep. Unticked dives stay on the computer and are offered again next time.

Mac (Bluetooth or cable)

  1. File → Download from Dive Computer… (⇧⌘D).
  2. Choose Bluetooth or USB Cable as the connection.
  3. For a cable, pick your computer's model and its port, follow Before you start, then Download.

The clock question. The first download from each computer asks What zone is the computer's clock set to? Most computers record local time with no time zone, so this keeps your dive times right when you travel. The answer is remembered for that computer.

The iPhone download screen: the clock zone question for a Perdix 2, three new dives ticked, and a Keep 3 dives button.
Downloading on iPhone: the clock question, the new dives, then Keep.

After choosing dives, you can step through them one by one to set the site and gases, or Finish later: they wait in To confirm.

Deleted a dive and want it back? Turn on Download every dive on the computer. It takes longer; dives already in your logbook are skipped.

Shearwater Predator and Petrel 1

These use older Bluetooth (Bluetooth Classic) that iPhones and iPads can't use. On the Mac, pair the computer in System Settings → Bluetooth first, then choose USB Cable in the download window: its port may appear in the list. Put the computer in its Bluetooth upload mode and choose Download. This hasn't been tried on a real Predator or Petrel 1 yet, so please send the download log whether it works or not. On iPhone, import their dives from Shearwater Cloud or a UDDF file instead.

Supported computers

Thermocline downloads with libdivecomputer, the open-source library many logbooks share. It knows several hundred models from most makers. To see yours, open the download screen and choose Supported computers; each one says whether it works on iPhone and iPad or needs the Mac.

ConnectionWhere it worksTried so far
Bluetooth LEiPhone, iPad and MacShearwater Perdix and Perdix 2. Other models should work: tell us.
USB or serial cableMac onlyBuilt, not yet tried on real hardware.
Bluetooth Classic (Predator, Petrel 1 and other older models)Mac only, paired as a serial portNot yet tried.

Got a computer we haven't tried? Help us test it.

Confirm site and gases

Dives still missing a site or confirmed gases wait in To confirm. Nothing stops them saving; fill them in when you like.

iPhone and iPad

They're at the top of Logbook under To confirm. Open one, then Choose a site and tap Yes, these gases are right (or Correct Gas…).

Mac

Go → To Confirm (⌘2). The banner on each dive offers Confirm Site and Gases…, Choose Site… or Confirm Gases….

Thermocline suggests the site from the dive's position: your own sites first, then the built-in lists of more than 73,000 dive sites and wrecks, which work offline.

A dive waiting to be confirmed on iPhone, asking whether its gases are right.
A dive in To confirm, asking about its gases.

Read a dive

A dive on iPhone: the safety strip with depth, time, gases, deco, ppO2 and CNS above the profile.
The safety strip, then the profile.
Stacked strips under the iPhone profile for tank pressure, SAC, temperature and ppO2, with chips to show or hide each one.
Chips choose the strips under the profile.
The How? panel for gas use on iPhone, listing the cylinder, pressures, temperature and the calculation.
How? shows every input behind SAC.
The Mac app: the dive list beside a dive with its safety values, site, buddies, gear and depth profile, with a readout of the deepest point.
The same dive on the Mac. Point at the profile to read any moment.

Sites, positions and the Apple Watch

iPhone and iPad

  • Profile → Sites, then the add button: Find or name a site or Mark spot here (GPS).
  • A site without a position offers Find position: check the suggestion on the map, type in coordinates, or drop a pin.

Mac

  • Go → Sites (⌘4), then Add Site….
  • Find Positions… works through every site without one, one at a time.

Apple Watch: at the surface, open Thermocline on the watch and press Mark spot once it has a good fix. You can add a name. The spot goes to your iPhone, which looks it up and puts it in To confirm.

The sites map on iPhone, with your sites and the built-in dive-site lists marked.
Your sites and the built-in lists on the map.

Site positions are for logging, not for navigation.

Gear and tanks

Merge and join dives

Photos and video links

Sync with iCloud

Turn on Sync with iCloud on each device: Profile → Sync on iPhone, Thermocline → Settings → Sync on the Mac. Every device signed in to the same Apple Account then shares one logbook, stored in your own private iCloud. Changes made offline wait on the device and send when it's back online.

The Sync section shows the status, anything Waiting to send, and whether this device and your others match. Sync now checks straight away.

The Sync with iCloud switch on iPhone, with a note on what it keeps the same across devices.
Profile → Sync on iPhone.

Export, restore points and erase

Your data on iPhone: Import a logbook file, Export logbook (UDDF), Export in another format, Restore points and Erase logbook.
Profile → Your data on iPhone.

Still stuck?

See Troubleshooting, or send feedback from TestFlight or to support@thermoclineapp.com.