This is an old revision of the document!
Move Family Historian Settings and Projects
Sooner or later everyone gets a new computer, or a second computer, and needs to migrate Family Historian on to it. Most of the information for your family history will be stored in your GEDCOM file and attached multimedia files, or in your Project Folder with V4 or later, but some items such as Text Schemes, Queries, Fact Sets, etc., are stored elsewhere.
Also your current computer may break down. In any case it is important that you have back-ups of all the necessary data. The following sections explain where Family Historian keeps its data items and customisations that need to be backed-up or transferred in order to retain everything you use. See also the Backup and Recovery advice.
If you are using ƒh V5+ Projects then the Family Historian V5 & V6 Migration Guide gives step by step instructions that replace all the following sections.
V4 and Above - Projects
The simplest way to move these is to copy the entire folder to the new computer using Windows File Explorer (Windows key + E) via some intermediate storage such as a USB pen drive. This will move the GEDCOM file itself, all your linked Multimedia in the Media sub-folder, and any other project files, to the new computer.
If Family Historian Version 5 or later is installed on both PC, then on the old PC you can use File > Backup/Restore > Full Backup (Entire Project Folder), copy the FH Project Backup - … .zip file to the new PC, and use File > Backup/Restore > Restore Backup on this file.
However, with either method above, if you keep your Multimedia outside the Project folder, then they will need to be copied separately, but will almost certainly result in 'broken links' on the new PC.
For the above to work satisfactorily, all Multimedia image file links must use Relative Paths and NOT Full Paths, otherwise they will all become 'broken links'. To check, use Tools > Work with External File Links and ensure all links are within Project Data Folder - Media, and drive letters such as C: are NOT mentioned. To convert Full Paths then use Re-map within Project Data Folder or run the V5/V6 Plugin Check and Repair Media Links.
If you have NOT customised any features listed below, you can simply copy your Project folder and not worry about anything else.
- Any Diagrams, Icons, Fact Sets, Queries, Reports, Text Schemes, etc, including Standard ones.
- Any Property Box Tabs or Records Window Columns or Plugins or Internet Search settings.
- Any Tools > Preferences or Tools > Record Window Options (V4) or Tools > Work with Data > Places/Addresses > Columns.
- Any Tutorial Files for Chapters of Getting the Most From Family Historian.
If any of the above have been customised and you are using ƒh V5+ Projects then the Family Historian V5 & V6 Migration Guide should be all that is needed, otherwise read on …
Export and Import in FH
As of V3 there are options on the File menu of FH to allow single items, such as a Query or Text Scheme to be exported to a folder of your choice and to import new items in. This works well when sharing single items with other users, but can be time consuming as a method of backing-up or moving things where you have many custom items.
Windows Easy Transfer
Nowadays your new PC will probably use Windows 7 or Windows 8, which include the free Windows Easy Transfer utility in Start > All Programs > Accessories > System Tools, or type Windows Easy Transfer into the Search box.
This utility copies all My Documents folders and files, and program settings and data from your old PC to the new PC (but it does not install the programs themselves). See the Windows Easy Transfer web pages for full details, including the operating systems supported, and the various transfer communication methods.
If you have a broadband router with multiple LAN ports or WiFi support, then simply connect both PC to the router at the same time and Windows Easy Transfer will copy your data from the old PC to the new PC via the router network connection. Other communication methods include an Easy Transfer USB cable, or USB flash drive, or external hard disk.
The utility should transfer your GEDCOM file, FH Project Folder, and FH Application Settings, along with the other documents and settings of each user account. If any data is not transferred successfully, then use the techniques below to complete the transfer.
If transferring from Windows XP, then check that the folders and files in C:\Documents and Settings\All Users\Application Data\Calico Pie\Family Historian\ are copied to C:\ProgramData\Calico Pie\Family Historian\ as explained in Transferring the Folders below.
One limitation of Windows Easy Transfer that has been reported is that it does not cope well if the disk drive letters and usage are not organised the same way on both PC.
Version 5 and Above - Plugins
Family Historian Version 5 introduced a new Plugin feature that allows virtually all of the techniques described below to be automated.
Use Tools > Plugins and visit the Plugin Store to check what is available; search for "Backup" to find the Plugins you need.
The Plugin specifically designed to migrate Family Historian V5+ settings from one PC to another is Backup and Restore Family Historian Settings. See its Help & Advice pages for details, and in particular the Moving from PC to PC advice.
The follow items are stored in a set of folders on the PC, in a different place to the Family Historian application:
|Items||Family Historian Program Data Folder|
|Diagrams||\Calico Pie\Family Historian\Diagrams\Standard & \Custom|
|Fact Types||\Calico Pie\Family Historian\Fact Types\Standard & \Custom|
|Flags||\Calico Pie\Family Historian\Flags|
|Fan Chart/Plugins||\Calico Pie\Family Historian\General (V5+)|
|Icons||\Calico Pie\Family Historian\Icons|
|Plugins||\Calico Pie\Family Historian\Plugins (V5+)|
|Property Box Tabs||\Calico Pie\Family Historian\Property Box (V4+)|
|Queries||\Calico Pie\Family Historian\Queries\Standard & \Custom|
|Reports||\Calico Pie\Family Historian\Reports\Standard & \Custom|
|Text Schemes||\Calico Pie\Family Historian\Text Schemes\Standard & \Custom|
|Internet Search||\Calico Pie\Family Historian\Web Search|
The Family Historian Program Data Folder location of these folders depends on the operating system on your computer. This location is NOT in the Program Files folder.
Transferring the Folders
The best way to move these items is to copy the Calico Pie folder over to the new machine after Family Historian has been installed. You will need to be logged on to your PC as an Administrator otherwise the folder may not be visible. If you still cannot see the folder via Windows Explorer, using the Start button followed by Run and typing in the whole folder name will normally show the folder. Remember that if you are moving from Windows XP to a later version of Windows you must copy the Calico Pie folder from C:\Documents and Settings\All Users\Application Data into C:\ProgramData. Do NOT use C:\Program Files.
It is also important to include this Calico Pie folder in your regular file back-up regime.
When moving from PC to PC, if Family Historian is also being upgraded from Version 3 or Version 4 to Version 5/6, then special care must be taken with Diagram Type (.fhd) files. Three methods are suggested:
- Install Version 5/6 on the old PC so the .fhd files are converted to .fhdx files before copying the Calico Pie folder.
- Copy the Calico Pie folder from PC to PC before installing Version 5/6 on the new PC, which will convert the files.
- Export the Diagram Type (.fhd) files on the old PC, and Import them into Version 5/6 on the new PC.
Some preferences are stored in the Windows Registry, but for most users, it is easier to simply manually change these on the new computer rather than trying to extract and apply the changes using regedit.
It is worth making a note of your important Tools > Preferences and Tools > Record Window Options (V4) and Tools > Work with Data > Places/Addresses > Columns prior to moving to a new computer. One way of achieving this is to take a screen-shot of each settings window using the PrintScreen button, the Snipping Tool, the Problem Steps Recorder, or something similar, and save them in your Project Folder. If more than one user account uses Family Historian, then this should be repeated for each account in case they use different settings.
Core Diagram Settings
The Core Standard Diagrams for Ancestors, Descendants, Ancestors & Descendants, All Relatives, Everyone, and V5 Blank Diagram need special attention to move their settings.
The settings for these Diagrams (displayed via the View > Standard Diagram Types menu or via buttons on the FH toolbar) are stored in the Windows Registry, rather than in the Family Historian Program Data Folder described above for all other Diagrams. The settings can be copied to a new machine as follows:
- View one of the Standard Diagrams and use Diagram > Save Diagram As > Custom Diagram Type to create a new Custom Diagram Type containing your current settings.
- Transfer this Custom Diagram Type settings file over to your new PC - either by using File > Export/Import, or by copying it between the appropriate folders (as explained above) on each PC.
- Once you have copied the Custom Diagram Type file onto the PC, you can make those settings the default for these Windows Registry based 'button-driven' Standard Diagrams too. On the PC, select someone at random, and use View > Custom Diagram Types to open your new Custom Diagram Type, and then choose Diagram > Settings > Save As Default Settings.
Only one Custom Diagram Type settings file is needed because all Default Settings apply to all five Standard Diagrams, with the exception of the Generations Up/Down options, which can easily be adjusted per Diagram Type.
If more than one user account uses Family Historian, then this should be repeated for each account in case they use different Diagram defaults, taking care to use a different Custom Diagram Type name for each account.
If you have used your own Custom Icons in Diagrams, then they could be located anywhere on your PC.
View the Diagram and use Diagram > Options > Boxes, select the Condition and Edit Features button. In the Icon section, click the <<Select button, and the Select Icon window will identify the folder and Icon filename. Repeat this for each Condition that has an Icon. Now you know what Icon files to move to the new PC.
It might be advisable to move these Icon files either into your Project folder in a folder called Icons, or into the \Calico Pie\Family Historian\Icons folder mentioned above. The Diagram Icons will then need to be reselected.
Record Window Columns
If you have Custom Record Window Columns save these as Custom Queries from the Configure Columns editing dialogue so you can restore them from the Custom Query on the new PC.
If more than one user account uses Family Historian, then this should be repeated for each account in case they use different Custom Columns, taking care to use a different Custom Query name for each account.
If you have used any of the tutorials associated with Chapters of the Getting the Most From Family Historian book, and you wish to retain where you have got to, then these tutorial files also need to be transferred.
The C:\Users\Public\Documents\Calico Pie\Family Historian\Tutorial Files\ folder, or on earlier Windows versions the C:\Documents and Settings\Public\Documents\Calico Pie\Family Historian\Tutorial Files\ folder, holds the tutorial files that need to be copied.
Using Non-Default Locations
By default all the Family Historian Projects, installation Program Files, and Family Historian Program Data Folder are stored on the C: drive.
With the advent of SSD and multi-drive PC it is becoming increasingly common to want to relocate those folders onto a different drive.
Some of the folders are easy to move, but others are technically challenging and should only be tackled with the appropriate expertise. The advice below starts with the easy options and gets progressively more complex.
If you apply any of these settings, then next time ƒh is installed, check the settings are still correct.
Family Historian Projects
This is an easy and fairly safe move.
First use Windows/File Explorer and Copy the Family Historian Projects folder from My Documents to its new location, say F:\Family Historian Projects.
In ƒh use File > Project Window and click the Location: link My Documents\Family Historian Projects, select Choose Location… and browse to its new location, say F:\Family Historian Projects, and click OK.
Your Projects should be listed as before, but in the new location. Remember to select your Default Project in this new location. When satisfied, Delete the original Family Historian Projects folder from My Documents.
Program Files Folder
This affects the C:\Program Files (x86)\… folder on 64-bit PC, or the C:\Program Files\… folder on 32-bit PC.
ƒh installs two products: Family Historian itself, and the Nova PDF Printer.
C:\Program Files (x86)\Family Historian\ is ~27MB with sub-folders Books, Diagrams, Fact Types, Flags, Program, etc. It can easily be relocated by reinstalling ƒh and choosing a different installation folder during the dialogue. Then if necessary the original folder can be deleted.
C:\Program Files (x86)\Calico Pie\Family Historian PDF\ is ~4MB with sub-folders AMD64 and i386. This can only be relocated by using Utility ~ Link Shell Extension or Utility ~ Windows Directory Junctions. Create a Family Historian PDF folder in its new location, then move the contents of the original folder to this new folder using Windows/File Explorer. Use one of the utilities to establish a symbolic link/directory junction between the two folders.
Program Data Folder
The location of the Family Historian Program Data Folder depends on the Windows version and may be hidden.
Since Windows Vista it is at C:\ProgramData\Calico Pie\Family Historian\ is initially ~14MB with sub-folders Diagrams, Fact Types, Flags, General, etc. This can only be relocated by using Utility ~ Link Shell Extension or Utility ~ Windows Directory Junctions. Create a Family Historian folder in its new location, then move the contents of the original folder to this new folder using Windows/File Explorer. Use one of the utilities to establish a symbolic link/directory junction between the two folders.