Family Historian V6 & Ancestral Sources V5 on Crossover, PlayOnLinux/Mac & Wine


This advice has been obtained from FHUG members who have succeeded in installing Family Historian (fh) and Ancestral Sources (AS) into Windows emulators such as CodeWeavers CrossOver and PlayOnLinux & PlayOnMac that are reliant on WineHQ.

Only the latest versions of fh and AS are supported as described below. Earlier versions do NOT work at all, and lack features designed to assist with these emulators.

The advice below applies to these or later stable versions, but also see Reported Problems.

FIXME ~ need to confirm some versions.

Program Installation

The Crossover, PlayOnLinux/Mac & Wine Bottler, and native Wine installation processes should be similar for Mac and Linux platforms.

Install the programs into a Windows 7 or Windows 8 configuration. Do NOT use Windows XP.

When installing fh, disable Create a desktop icon and disable Launch Family Historian. Ignore messages saying fh is incompatible with Windows 7/8 or that the installation was incomplete.


In Crossover (as of Dec'15) select install a Windows Application as normal. Create a new Win 7/8 Bottle for Family Historian V6 as an unsupported other application.

Install these applications into one bottle:


FIXME ~ This section needs reviewing for PlayOnLinux & PlayOnMac.

Install fh into a new non-listed application bottle:

Install AS into a new non-listed application bottle:

  • Create a new non-listed application bottle
  • Select Install a program in a new virtual drive
  • Select Install some libraries
  • Scroll down the list and select POL_Install_dotnet35sp1 to install Microsoft .NET Framework V3.5 SP1
  • Allow Microsoft fonts to be installed
  • Select I Agree
  • DotNet 2.0, 3.0 and 3.5 then download automatically and install. This can take some time. If this install fails due to timeouts then cancel it and start again using the overwrite option when choosing the same bottle. It will usually complete installation on the second attempt but may need a third
  • Once this has completed successfully then select and install the Utility ~ Ancestral Sources v5.3.0 32-bit latest download
  • Finally select Ancestralsources.exe as the programme to run

When running AS and adding an image you may get an error message. The continue option can be chosen and the image will be added correctly.


In Wine run winecfg, and with Default Settings selected under Applications, set Windows Version to Windows 7, and ensure that Drives are set appropriately. Install programs using the wine command to specify their installation .exe file. (FIXME It is not certain whether WINEARCH is required to set a win32 wineprefix for FH which is a 32-bit application.) See Wine User's Guide part 3 Using Wine.

Install these applications:

Program Configuration

To ensure fh Reports display text correctly, set fh Tools > Preferences > General > Advanced > Emulator Compatibility Mode.

All the fh and AS settings below should specify similar folder paths, usually involving the Documents folder, and all the named folders and files must actually exist.

  • fh File > Project Window in the Location field
  • fh Tools > Preferences > Startup in the Default Startup File field
  • fh Tools > Preferences > Backup in the Default Backup Folder field
  • AS Tools > Options > General settings > Folders in all three fields

If necessary, it is advisable to create new folders using Crossover, PlayOnLinux/Mac or Wine rather than within fh or AS windows.

Configuration changes are needed as described below in Plugins to allow some Plugins to work.


The default Location for projects is My Documents\Family Historian Projects that is physically on the Mac at Documents/Family Historian Projects.

The C:\Program Files\Family Historian installation folder is physically at <username>/Library/Application Support/Crossover/Bottles/Family Historian V6/drive_c/Program Files/Family Historian where Family Historian V6 is the name if your bottle.

Ensure the Crossover window remains on the Mac screen on which it is opened, and does not follow the cursor when swiped to another screen. To achieve this, locate the Dock and right-click (control-click) the Crossover icon, go to Options, and ensure it is set to This Desktop. Repeat this with the FH and AS icons.


FIXME ~ Example file paths.


FIXME ~ Example file paths.

Program Updates

The simplest way to update both fh and AS is to use their own Help > Check for Updates commands and follow the automated download and install process, although this may not succeed in Wine.

Otherwise use the following strategies for both fh and AS program updates.


After the update has been downloaded, preferably using Firefox, and the program association has been made, then double-click the update exe file to apply the update in the existing bottle.


FIXME ~ After the update has been downloaded, …


After the update has been downloaded, preferably using Firefox, it may be necessary to copy the update file to the virtual C drive and run the update exe file from there and apply it to the existing bottle. - FIXME See thread Upgrading FH to 6.2.3 on a MAC with wine for further advice.


Plugins downloaded from the Plugin Store sometimes will not import using the browser Open With option, although Save followed by an explicit Import command works OK. A workaround in Firefox is to use its Firefox > Preferences settings to associate .fh_lua Plugin files with Family Historian then Open With works OK too.

Plugin Configuration

The following COMPUTERNAME Environment Variable change is needed to allow many Plugins to work.

With Crossover V14.0.3/Version 15.0.0 the location of the bottles is slightly different from earlier versions, as is accessing them.

CrossOver All Bottles

Click on the 3 blue bottles underneath the screen sizing icons, select the Family Historian V6 bottle, and click the gear menu and choose Open C:drive. Finder will now open, so go up one level in Finder and select the cxbottle.conf file, and open it in a plain text editor such as TextEdit. Scroll to the bottom of the file to the [EnvironmentVariables] section, and at the bottom of this section add a new line, ensuring that the quotes are normal ones and NOT smart quotes:


Make this "NAME" unique across your computers, but do not use your Mac computer name in System Preferences. Choose an alternative name such as your first name all in capitals.

Finally Save the cxbottle.conf file.

If you are using Text Edit smart quotes are turned on by default. Turn them off by selecting Edit > Substitutions and untick Smart Quotes.

FIXME ~ A similar change may NOT be needed in PlayOnLinux/Mac or Wine (To be confirmed).

Plugin Library Modules

Some Plugins require extra library modules not included in the fh installation, but their download will fail or be very slow. So download and run the Install Library Modules Plugin shortcut to install these library modules in advance: luasql, md5, mime, pl, socket & zip.

Problems With Plugins

The Plugins listed below may have limitations. Ensure that COMPUTERNAME is set as advised above.

Backup and Restore Family Historian Settings

Version 2.5 or later is almost fully operational in Crossover but fails in Wine. Even in Crossover it only detects the primary Family Historian installation, and NOT any subsidiary installations such as Family Historian Demo 3.0 or Family Historian 6.0 Beta, and it will omit the settings of any custom Named List not mentioned in the current Project. FIXME ~ PlayOnLinux/Mac operational status is not confirmed.

Check Installed Plugins Against the Store

This may say all Plugins are Not In Store because Crossover (& Wine? FIXME) does not support the winhttp service needed to check the Plugin Store. See Forum thread Check Installed Plugins Against the Store - Crossover issue.

Some Plugins also check the Plugin Store for a later version, but cannot do so for the same reason as above.

Therefore, it is necessary to occasionally check the Plugin Store manually to ensure you have the latest versions.

This problem appears to be partially fixed in Crossover 18.5.0 although automatic Plugin Store downloads still fail, so must be updated manually.

Research Planner

This Plugin also relies on the winhttp service so will fail in Crossover (& Wine? FIXME).

Printing and PDF

All fh Print Setup and Print options work with any Mac (or Linux?) printer, even when a Report is displayed incorrectly on screen (see Reported Problems below).

The free PDFWriter for Mac offers a way of creating PDF output via the fh Print commands rather than the fh Save Diagram/Report As > PDF File (.pdf) commands.

The free CUPS-PDF for Linux offers similar PDF features.

FIXME ~ The detailed capabilities of these PDF tools need further investigation.

Reported Problems

Avoid using Internet Explorer as it can lead to download issues. Instead use Firefox or Chrome in the native Mac or Linux environment.

Although the Family Historian PDF (novaPDF printer) installs, Wine based emulators do not support Windows printer drivers, so the novaPDF printer does not work.

  • In Crossover it can be removed via the Installed Applications dialogue Repair or Remove button
  • In PlayOnLinux/Mac ~ FIXME
  • In Wine use the wine uninstaller or wine control

Having done so, the fh Save Diagram/Report As > PDF File (.pdf) commands say PDF file output is not enabled.

Some fh Reports may display text incorrectly, but this is usually cured by using Tools > Preferences > General > Advanced > Emulator Compatibility Mode. See Index for related topics

Use Tools > Preferences > Internet Data Matches > Location to Display Matches: External Web Browser to avoid problems with the internal window.

The Map Window has display rendering problems. Also there are currently issues with its events sub-window not displaying the events. The individual events are shown on the map, they just cannot be filtered. Better in Crossover 15.0.0 or later.

The fh command Tools > Preferences > Backup > <<Select > Make New Folder, and similar commands in Plugins, produce a hieroglyphic error message. The workaround is to create the folder beforehand using Crossover, PlayOnLinux/Mac or Wine, and select the pre-existing folder in fh or Plugins.

When changing a Date field and the Invalid Date message opens saying Unknown date. Please enter a valid date. do not change focus to another application as fh will freeze and must be closed. This problem may affect other error messages.

AS often would not work at all prior to Crossover 15.0.0.

If fh &/or AS &/or another program are running at the same time, and one program changes the shared GEDCOM file, then the other program(s) correctly report the file has changed, but then may freeze and Force Quit must be used. This problem appears to be fixed in Crossover 18.5.0. In FH constantly crashing after every entry in AS it is suggested the problem is fixed by running winecfg and deselecting Allow the window manager to control the windows in the Graphics tab.

Users have reported fh freezes if Edit command is chosen when installed in Crossover 15.0.0. Revert to Crossover 14.1.11 to fix.

FHUG Forum Topics

These are most of the related Forum threads discussing this topic.