App Backup and Restore

IMPORTANT ALERT: Version 1.3 of the app has been released! Please click on the Version 1.3 link in the menu to the right to learn about the upgrades. Also, be sure to back up your data regularly. This is especially important now, as it may be necessary to restore your data from the backup after updating to the new version.

General info

This release of the app allows you to back up your card data, readings and notes in two different ways, by email or through iTunes. Each time you Add a Card or complete a 4-Card Reading, you will receive a quick reminder. We recommend that you back up your data regularly, especially after adding cards, readings or notes, before exiting the app. This will enable you to recover the data in case your mobile device should be lost or damaged, or the data should become corrupted for some reason. It is also possible to use the Backup and Restore feature to transfer your data to another device, if it has the app installed.

How to Perform email Backup

First tap the Help/Backup button on the Home Screen. This will start the process of preparing your backup files. The files are compressed as a zip file, to conserve space. Next, tap the "Backup" arrow in the upper right margin of the Help/Backup screen, and you will scroll automatically down to the backup link. Tap "Export App Data as Backup" and you will see an alert asking you if you wish to send the backup file via email. Tap YES, then follow the instructions, and the backup email will be sent. NOTE: If you backup file is greater than 25 MB, email backup is not available, and you should use iTunes backup.

When you receive the email, which contains your data as an attachment, download the attachment and save it in a special folder on your computer. We recommend that you change the name of the backup file on your computer by adding "1" or "2", etc., so that you can keep multiple generations of backup. It is important to perform this download, as you may lose access to your email attachments after some period of time, depending upon the policies of your email provider.

Notes on email Backup

When you have only a small number of cards, the backup will happen quickly, and the email with the backup attachment will arrive soon after you send it. As the number of cards becomes larger, the attachment becomes larger, and you may see delays of an hour or more before the backup arrives in your inbox. This is a function both of the email provider which is used on your device to send the email, and the email provider where you receive the email.

Some users have reported problems with email backup when their email provider has a lower limit on attachments than 25 MB. In this case, you will have to perform your backup using iTunes.

How to connect to iTunes

1.  You must have a PC or Mac with iTunes installed. From here on, we will refer to this as the "Mac" but everything applies to the PC as well. Click here to download and install iTunes if you do not already have it installed on your Mac.

2. Connect your iPhone or iPad to your Mac, using the USB cable which normally connects to the charger. From here on, we will refer to the iPhone or iPad as the "device". Connecting the device should automatically launch the iTunes program on the Mac and the device should begin synching with iTunes. Various other windows may appear on the Mac, asking if you want to update your iOS or perform other functions. You should say NO to these (but update later as necessary). If the iTunes program does not launch, start it manually, then unplug the device and reconnect it to your computer. You will see messages flashing at the top of the iTunes window regarding the progress of the synching the device. Wait until the synching process is complete.

3. In the top left corner of the screen, a tiny icon for your device will appear. It is quite difficult to find. Please refer to Screenshot #1 below for help in locating this icon. Now click on this icon.

4. This will bring you to a new screen in the iTunes window on the Mac, with a Summary of the information about your device. Under Options, check the box "Open iTunes when this device is connected" so that iTunes will launch automatically in the future. Now click on "Apps" in the column on the left.

5. Scroll down to the very bottom of the iTunes page on the Mac, where you will see the File Sharing window. Single click the SoulCollage app to highlight it.

How to perform Backup through iTunes

First, follow the instructions above on how to connect your device to iTunes and to navigate to the section of iTunes where Backup and Restore are performed. Then, perform the following steps:

6. On your device (which is now connected to iTunes on the Mac) tap "Help/Backup" on the Home Screen. Then tap the "Backup" arrow in the upper right margin of the screen. The screen will automatically scroll down to the backup section. Now tap "Export app data as backup". Answer NO when it asks if you want to perform email backup.

7. In the "SoulCollage Documents" window in iTunes on the Mac, on the right, highlight the "Backup" folder.

8. Be sure the folder is highlighted, then click "Save to..." at the bottom right corner of the window.

9. In the new window which pops up on the Mac, navigate to the folder where you want to store your Backup data for the app, then click "Select Folder". Your backup data will now be stored as a zip file in the folder you have chosen.

10. (Recommended!) Change the name of the backup file on your computer by adding "1" or "2", etc., so that you can keep multiple generations of backup.

How to Restore your data

Before restoring your data, please remember that any data which is currently on the device will be erased, and replaced by the data from the backup file.

1. Locate the most recent backup file, which was downloaded from you most recent email backup or backed up through iTunes.

2. The backup is contained in a compressed "zip" file which must be unzipped in order to be used. On most operating systems, this is accomplished by right clicking on the file name. Select "extract" or "unzip" or "decompress" or a function with a similar name from the menu which appears. This will bring up a window which contains a suggested path for the new folder which will be created. Click "OK" and the zip file will be unzipped into a new folder which will be created within the folder which contains the zip file. Inside the new folder, you will find many individual files: one for each card image, and one sqlite file named "SoulCollage" which contains all of the notes and reading data.

3. See the instructions above to connect your device to iTunes on your Mac.

4. In the lower right corner of the File Sharing window on the Mac, click "Add". This will bring up a window where you can navigate to find the folder which contains the unzipped backup files. Highlight ALL of these files. (Hold down the shift key and click on the topmost file, then, still holding the shift key, click on the bottommost file, and all of the files should be highlighted). Be sure to highlight all of the files, including the sqlite file at the bottom.

5. Now click "Open" at the bottom of the window which contains the highlighted files. You should see the names of all these files appear in the SoulCollage Documents window in iTunes. These files are now prepared to be restored to the app on your mobile device. You should see an image file for each card, plus the sqlite file which contains all the notes.

6. Be sure that all of the files from the backup folder have appeared in the SoulCollage Documents window in iTunes on the Mac. Then go to the Help/Backup screen of the app on the mobile device, tap the "Backup" icon in the upper right margin to scroll to the backup and restore section, then tap "Restore App Data from Backup".

7. Restore will now be implemented and your backup data will transfer to the mobile device and replace the existing data. You can now disconnect the device from the computer and continue using the app.

8. If you receive an error message, it is most likely because all of the necessary files were not loaded into the SoulCollage Documents window in iTunes. The app analyzes the files to be sure there are the proper number of image files to match the notes, and makes several other checks for validity. Please reload the files and try again. If the problem persists, you can go to an earlier backup and try to restore from that.

How to Transfer data to another device

This is actually quite straightforward. First, perform Backup on the device which has the data you want to transfer. Then, attach the second device to iTunes and perform the Restore function to insert the backup data onto the second device. Remember that any data which is on the second device will be erased and overwritten by the backup data.

Screenshot #1: Finding the Device icon in iTunes