Get your ring key

Keep the official Oura app, and connect loophole over Bluetooth too

loophole can talk to your ring directly over Bluetooth. To do that it needs the ring's auth key, the same one the official Oura app set up when you paired. Here is how to read it off your own phone and paste it into loophole.

This is your data, and nothing gets changed. You only read the key. Your ring stays paired to the official Oura app, so its features and firmware updates keep working.

When you need this

Only if you want to use both apps. To leave the official app behind entirely, skip this page: remove the ring from the Oura app, then tap Settings ▸ Ring (Bluetooth) ▸ Pair in loophole and it sets up its own key.

Before you start

Keep the ring paired in the official Oura app, so the key on your phone is current.
Turn off encrypted backups in your backup tool. An unencrypted backup keeps the app's files readable.
Save everything to your Desktop. The commands below assume that, so they work as written.

Read your key

Pick your computer. The final command is the same on all three.

Back up your iPhone

Open Finder, select your iPhone in the sidebar, choose Back up all of the data on your iPhone to this Mac, leave Encrypt local backup unchecked, and click Back Up Now.

Extract the Oura app data to your Desktop

In iMazing: your device ▸ Apps ▸ Oura ▸ Extract App Data. Save it to your Desktop. You get a file called Oura.imazingapp.

Read the key

Open Terminal and paste this in. Everything it needs is already on your Mac.

cd ~/Desktop
unzip -o Oura.imazingapp -d oura-data

sqlite3 oura-data/Container/Documents/*/assa.sqlite \
  "SELECT serial_number, hex(auth_key) FROM ringconfiguration;"

Find the line with your ring's serial number. The long value next to it is your key: 32 characters, digits and the letters a to f.

Back up your iPhone

In the Apple Devices app (or iTunes): select your iPhone, back up to This computer, make sure Encrypt local backup is off, then click Back Up Now.

Extract the Oura app data to your Desktop

In iMazing: your device ▸ Apps ▸ Oura ▸ Extract App Data. Save it to your Desktop. You get a file called Oura.imazingapp.

Read the key

Install SQLite once with winget install SQLite.SQLite, then open PowerShell and paste this in.

cd ~\Desktop
mkdir oura-data
tar -xf Oura.imazingapp -C oura-data

$db = (Get-ChildItem oura-data -Recurse -Filter assa.sqlite).FullName
sqlite3 $db "SELECT serial_number, hex(auth_key) FROM ringconfiguration;"

Find the line with your ring's serial number. The long value next to it is your key: 32 characters, digits and the letters a to f.

Install the tools and trust your phone

iMazing is not available on Linux, so use libimobiledevice instead. On Debian or Ubuntu:

sudo apt install libimobiledevice-utils sqlite3
idevicepair pair

Unlock your phone and tap Trust when it asks.

Back up your iPhone to your Desktop

Turn off encrypted backups first, then:

cd ~/Desktop
idevicebackup2 backup --full oura-backup

Read the key

Backup files are stored under scrambled names, so the first command looks up the right one:

cd ~/Desktop/oura-backup/*/

fid=$(sqlite3 Manifest.db \
  "SELECT fileID FROM Files
   WHERE domain='AppDomain-com.ouraring.oura.production'
     AND relativePath LIKE '%assa.sqlite';")

sqlite3 "${fid:0:2}/$fid" \
  "SELECT serial_number, hex(auth_key) FROM ringconfiguration;"

Find the line with your ring's serial number. The long value next to it is your key: 32 characters, digits and the letters a to f.

Then, in loophole

Open Settings ▸ Ring (Bluetooth) ▸ Add ring auth key and paste the 32 characters. Capitals do not matter, and there are no dashes. loophole stores it only in your device's Keychain.

If something goes wrong

Nothing comes back? The ring may have been unpaired. Pair it in the Oura app again, make a fresh backup, and run the command again.
Check what you copied. The key is 32 characters with no dashes and no prefix. Anything with dashes, or starting with something like v1:, is a different value and will not work.

Using both apps

A ring accepts one Bluetooth connection at a time, so the two apps take turns rather than connecting together. If the Oura app cannot connect, loophole is probably holding the link. Tap Settings ▸ Ring ▸ disconnect in loophole to free it.

Keep your key private

Your ring key is a credential. Treat it like a password: do not post it, email it, or share it. It belongs on your devices only.

Not affiliated with Oura

loophole is an independent app and is not affiliated with, endorsed by, or connected to Ōura Health Oy. These steps only read your own data from your own device.