Abee Help

Abee imports contacts from one address book service or application into macOS Contacts. It does so using a file that you must provide and which you create using any service or application that is cabable of generating either one of:

Note that CSV files must have a ".csv" extension to be recognized as such by Abee. Otherwise they are assumed to be tab-delimited files.

Such files can come from any online service that manages contacts, or from applications running on any operating system. Examples of such services include, but are not limited to:

In general, such services and applications have an Export function to generate the CSV or tab-delimited file. Once generated, this file becomes the import file for the purposes of Abee.

Basic Operation

In most cases, using Abee is straightforward and done using the following steps.

  1. Launch Abee. An empty import window comes up.
  2. Click the Choose button and use the file dialog to pick an import file previously obtained from another service or application. After a few seconds, the list of fields in the import file will appear in the left column.
  3. Associate the fields to their appropriate Contacts counterpart by simply dragging them from the left to the empty boxes on the right. If applicable, select an appropriate label for each field.
  4. At the bottom of the window, if the first contact in the import file is only a header that describes the fields, select "Import all records except first one" from the bottom popup.
  5. Indicate whether you want the imported contacts to be added to a specific group in macOS Contacts. The default is "Imported Contacts".
  6. Click the Import button! After a few seconds, your contacts will have been transfered to macOS Contacts.

Saving & Reusing Your Mapping

If you need to perform the same import more than once or on a regular basis, the mappings you create can be saved to be reused later. Such a configuration is saved as a document that can be double-clicked or opened from Abee.

To save your mapping, use the following steps.

  1. Set up your mapping as described in steps 1 through 5 above.
  2. Use the Save command from the File menu. A file dialog appears.
  3. Enter a name and click Save. A document with the Abee icon is created where you indicated.

That's it. The next time you need to perform the same import, just open this mapping file from the Finder. An import window already set up will appear, into which you can simply drop an import file and then click Import.



I'm trying to import a CSV file but it doesn't seem to be recognized by Abee. What's up?

A CSV file must have a ".csv" extension to be recognized as such by Abee.

I'm trying to import contacts that use characters other than the English alphabet and they appear garbled in Abee or macOS Contacts. How can I fix that?

Use the File Encoding popup in the choose file dialog. You might have to experiment with the various choices.

The import works fine except for dates which don't get imported or are imported incorrectly. What can I do?

Let us know via the contact link below.


If you have any question or need any help, contacts us at support@aptapps.ca.