How to use CopyTrans Contacts via command line (advanced users)

CopyTrans Contacts can be used directly via command line. This is only for advanced users to streamline operations.

1. Begin by downloading the CopyTrans Contacts executable.

   NOTE: no other files are required to run the application besides the executable.

2. Open a Command Prompt window from the folder location where CopyTransContacts.exe exists.

NOTE: In order for Windows PCs to correctly communicate with iOS devices you need to have the iOS drivers installed.

Command line reference

To import contacts to your iDevice (application must be activated):

• CopyTransContacts [/import] [’options’] source_directory

• CopyTransContacts [/import] [’options’] file1 file2 file2

/i, /import – import contacts to first connected iOS device (will wait until device is connected)

/d, /directory – import all contacts in directory instead of individual files (only valid on import)

/r, /recursive – import all contacts in directory and its subdirectories instead of individual files (only valid on import)

/a, /add – on import, will add duplicates (if /silent is used, this is the default behaviour, otherwise will prompt)

/o, /overwrite – on import, duplicates will be overwritten

/k, /skip – on import, duplicates will be skipped

/c, /clear – clear device contacts before import

NOTE: exit code will be set to non zero if import fails.

Examples:

Import all contacts contained in a directory –

• CopyTransContacts /import /directory /silent "c:\My dir with contacts"

Import multiple vcard files –

• CopyTransContacts /import /silent "c:\My dir with contacts\contact1.vcf" "c:\My dir with contacts\contact2.vcf"

To export contacts from your iDevice (application must be activated):

• CopyTransContacts [/export] [’options’] dest_directory

/e, /export – export all contacts from first connected iOS device to directory

/no_groups – don’t export groups

/append_device_name – export to directory with device name

/export_profile – possible export profiles (use only one, default is /ios) include /ios, /android, /icloud, /outlook, /gmail, /yahoo, /hotmail, /thunderbird, /win_contacts, /win_address_book, /excel.

NOTE: exit code will be set to non zero if all export fails. That is, if even one contact is exported, and all other fail, exit code will be set to zero.

Example:

Export to directory for reimport on other iOS device –

• CopyTransContacts /export /quit /silent /ios "c:\My exported contacts\"

To activate CopyTrans Contacts:

• CopyTransContacts [/activate] [’options’] “first_name” “last_name” activation_code

/activate – activate application, must be followed by firstName lastName activationCode

Note: exit code will always be zero (on success or failure).

Example:

• CopyTransContacts /activate /quit /silent "David E." "James" FFFF-FFFF-FFFF-FFFF-FFFF-FFFF

Misc:

/?, /help – displays command line reference.

/s, /silent – do not open main program window

/q, /quit – quit after operation execution (if /silent is specified, will be done by default)