NOTE: This page is currently under review, as much of the material is now obsolete or is covered elsewhere on the KB. It is likely to be deleted or heavily modified in the near future.
Sooner or later everyone gets a new computer, or a second computer, and needs to migrate Family Historian and the associated data on to it. Most of the information for your family history will be stored in your GEDCOM, an acronym for GEnealogical Data COMmunication, is a specification for exchanging genealogical data between different genealogy software. It is a file format that most genealogical programs and online trees recognise. file and attached When you add a picture, video, sound recording, document file etc into a Family Historian project, a Media record is created to represent that media item within the project; the Media record includes a link to the actual Media file. files, or in your A Project is a Windows folder, created by Family Historian, which contains all your Family Tree information recorded in Family Historian. Normally located in the Documents\Family Historian Projects folder. Folder with V4 or later, but some items such as Text Schemes, Querying is a very powerful feature that allows you to specify and save criteria for identifying a set of records of a given record type., A Fact Set is a defined list of types of Facts – that is types of Events and Attributes., 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 ƒh 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 replaces all the following sections and gives step by step instructions to migrate ƒh from one PC to another PC.
Export and Import Options
As of ƒh Version 3 there are options on the File menu 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. 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.
Version 4 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 memory stick. 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 ƒh Version 5 or later is installed on both PCs, 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+ 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, Facts are one of the key concepts at the heart of Family Historian; they are how you record the things that happened to, or described, each ancestor (Individual). Sets, Queries, Reports, Text Schemes, etc, including Standard ones.
- Any The Property Box is the primary window for data entry and for viewing details of stored records. It is used with records of all types. Tabs or The Records Window provides a comprehensive view of all the information stored within a Family Historian project. Columns or Plugins are small programs that allow new features to be added without upgrading Family Historian itself; some plugins are written by Calico Pie and others are written by users. or Internet Search settings.
- Any Tools > Preferences or Tools > Record Window Options (V4) or Tools > Work with Data > According to GEDCOM, a Place should hold “The jurisdictional name of the place where the event took place…” /Addresses > Columns.
- Any Unicode Accent Sets (V6) or dialogue Colour Schemes (V6).
- 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 …
Version 5 and Above – Pluginsƒh V5 introduced a new Plugin feature that allows virtually all the techniques described below to be automated.
Use Tools > Plugins and visit the Plugin Store to see what’s available; search for “Backup” to find Plugins you need.
The Plugin specifically designed to migrate ƒh settings for version 5 and above from one PC to another is Backup and Restore Family Historian Settings plugin. See its Help & Advice pages for details, and in particular the Moving from PC to PC advice. If you use this plugin, all the techniques given below can be ignored.
The following items are stored in a set of folders on the PC, in a different place to the ƒh 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+)|
|Map Geocoding is the process of converting addresses/places (like a street address) into geographic coordinates (latitude and longitude), which you can use to place markers on a map.||\Calico Pie\Family Historian\Geocode (V6+)|
|Icons||\Calico Pie\Family Historian\Icons|
|Accent Sets||\Calico Pie\Family Historian\International (V6+)|
|Map Geocoding||\Calico Pie\Family Historian\Map\Cache (V6+)|
|Plugins||\Calico Pie\Family Historian\Plugin Data (V5+)|
|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|
|Website Family Tree||\Calico Pie\Family Historian\Settings|
|Text Schemes||\Calico Pie\Family Historian\Text Schemes\Standard & \Custom|
|Colour Schemes||\Calico Pie\Family Historian\Themes (V6+)|
|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 or Program Files (x86) folder.
Transferring the Folders
The best way to move these items is to copy the Calico Pie Limited is a UK software house, and the publishers of Family Historian. folder over to the new machine after ƒh 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 File Explorer (Windows key + E), follow the advice in the Family Historian Program Data Folder Notes.
It is also important to include this Calico Pie folder in your regular file back-up regime.
When moving from PC to PC, if ƒh is also being upgraded from V3 or V4 to V5 or later, then special care must be taken with Diagram Type (
.fhd) files. Three methods exist:
- Install ƒh V5+ on the old PC so the
.fhdfiles are converted to
.fhdxfiles before copying the Calico Pie folder.
- Copy the Calico Pie folder from PC to PC before installing ƒhV5+ on the new PC, which will convert the files.
- Export the Diagram Type (
.fhd) files on the old PC, and Import them into V5+ 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
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 ƒh, 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 ƒh 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 ƒh, 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, then select the 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 Family Historian Projects 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 ƒh, 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 prior to ƒh V6, and you wish to retain where you have got to, then these tutorial files also need to be transferred.
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 (x86), 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 (Windows key + E) 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 More Tasks > Project List > Choose Location for Projects… 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.
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
i386. This can only be relocated by using the techniques described in Synchronizing Family Historian Settings Using 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\ and is initially ~14MB with sub-folders Diagrams, Fact Types, Flags, General, etc. This can only be relocated by using the techniques described in Synchronizing Family Historian Settings Using 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.https://fhug.org.uk/kb/kb-article/synchronizing-family-historian-settings-using-directory-junctions/