Flavio's app supportAll guides · Sign in

← All guides

How to use Contact Export Rescue

Contact Export Rescue

Export every contact from Contacts as vCards, find the records Contacts hides, and compare with an old export.

Bought Contact Export Rescue? Sign in with the email you bought it with to download the latest version or ask me a question.

On this page

Install

Contact Export Rescue requires macOS 14 Sonoma or later, on Apple silicon or Intel. Download the ZIP from the order page or your Creem receipt. Unzip it and move the app to Applications.

The app checks for updates once a day. When a new version is ready, click Install and Relaunch. To check anytime, choose Contact Export Rescue → Check for Updates….

Allow access to Contacts

The Contacts card in the sidebar shows where things stand: Not asked yet, Access allowed, or Access is off. macOS asks the first time you click Read Contacts. Click Allow.

If you clicked Don’t Allow, the main button becomes Open Privacy Settings…. Turn the app on in System Settings → Privacy & Security → Contacts, then click Read Contacts again.

The app only reads. Nothing in Contacts is changed, merged or deleted.

Contact Export Rescue after access was refused: the sidebar card reads Access is off with Open Privacy Settings…, and an orange note in the main area says to turn it on in System Settings → Privacy & Security → Contacts, then click Read Contacts again

Contacts that Contacts hides

Also look for contacts that Contacts hides is ticked by default. With it on, the app looks for damaged records in a copy of the address book database, the ones that the Contacts app doesn’t show and its export leaves out. Each one it finds gets a pink Hidden from Contacts pill and is rebuilt from what’s stored in the database. The copy is only read, so the database Contacts uses isn’t touched.

macOS may require Full Disk Access for the app to read the database. If it can’t, the preview shows an orange line with Open Full Disk Access…. Allow the app there, then click Read Contacts Again. Without it, the app still exports every contact Contacts lists.

The same search fills in notes, which Contacts may give the app empty, and photos it can’t get otherwise.

Check an old export

Under Old export to check (optional), drop a .vcf or click Choose…. The card shows how many cards it has. An empty file is fine: every contact will count as missing from it. A file that isn’t a vCard file gets a plain message, and the ✕ removes it.

After reading, contacts the old file doesn’t have get a purple Missing from old export pill. Matching uses the contact’s ID in Contacts, then email, then phone number, then name. Cards in the old file that match no current contact are listed as Only in old export.

Contact Export Rescue with Show set to Missing from old export and Select set to Only missing, listing the hidden contacts at the top, with the button Export 15 Contacts

Choose who to save

The Check before you export screen lists everyone, with hidden and problem contacts at the top and the reason under each one. The pills count contacts read, hidden from Contacts, exported, rebuilt, can’t export, missing from the old export and only in the old export.

A Rebuilt contact is one Apple’s vCard writer failed on or wrote without its name, email or phone. The app wrote that card itself from the fields it could read.

Save

Under What to save, Also save one file per contact adds a .vcf for each person, and Include contact photos keeps the photos. Both are remembered.

Under Save in, click Choose… for the folder. The app makes a new folder inside it every time, named by New folder name (Contacts rescue and the date by default), so an earlier export is never replaced. Click Export N Contacts.

The folder has:

Show in Finder opens it. Start Over goes back to the start.

Limits

Contacts are read and saved on your Mac. The app uses the internet to check for and download updates.

Contact Export Rescue is $20, a one-time purchase.