Installation on macOS

There are 2 options for installing Ancestor Tree Manager:

  • with an installation script (recommended method for macOS 10.15)
  • with a jar file (for older macOS versions)
The script will search for the best Java version available in /Library/Java.

Installation

  1. Make sure the correct Java version (see Download page) is installed in /Library/Java
    Download the macOS Installer and start the installation by double-clicking the file from Finder
  2. If ATM is already installed the program must be closed before installing a new version
  3. Open a Terminal (see Instructions)
  4. Go to the folder where the installation file is downloaded by entering the following command:
    cd ~/Downloads (if the file is downloaded in the default download folder)
    or:
    cd /xxx/yyy (replace /xxx/yyy by the actual path to the download folder)
    and press Enter
  5. Start the installer (this must be done as super user) with the command:
    sudo sh AncestorTreeManager-<version>.command
    or:
    sudo java -jar AncestorTreeManager-<version>.jar
    and press Enter
  6. Enter the password and press Enter
  7. Install ATM preferably in /usr/local/AncestorTreeManager

Problems

If there are problems with the installation, they may be caused by security settings that prevent commands from being executed. See the following links for an explanation and a solution:

https://osxdaily.com/2018/10/09/fix-operation-not-permitted-terminal-error-macos/
https://appletoolbox.com/seeing-error-operation-not-permitted-in-macos-mojave

Starting the program

If ATM is installed in the recommended folder /usr/local/AncestorTreeManager, desktop shortcuts are automatically installed in /Applications:

  • Ancestor Tree Manager.app
  • File Transfer Handler.app

Double-click on a program to start it.

If ATM is installed elsewhere, you can create a desktop shortcut yourself (see below).
Other method:

  • With Finder navigate to [installation folder]/bin
  • Double-click on AncestorTreeManager.command

How to create a desktop shortcut

This example assumes that ATM is installed in /Applications/AncestorTreeManager.

  1. Go to folder Applications Utilities
  2. Open the application Script Editor
  3. Click button New Document
  4. Enter the following line of code:
    do shell script "/Applications/AncestorTreeManager/bin/AncestorTreeManager.command"
  1. Click on to test the script: Ancestor Tree Manager should start now
  2. Close Ancestor Tree Manager
  3. In the Script Editor select menu-item File Save
  4. Choose Application as File Format
  5. Give your script a name e.g. Ancestor Tree Manager
  6. Click Save and close the Script Editor

From now on all you have to do to start your Ancestor Tree Manager is to double-click the script you just created:

Uninstallation

From version 9.2 an Uninstaller is available, located in the program folder.

  1. Open a Terminal (see Instructions)
  2. Go to the program folder by entering the following command:
    cd /usr/local/AncestorTreeManager (assuming this is the path to the program folder)
    and press Enter
  3. Start the Uninstaller (this must be done as super user) with the command:
    sudo sh Uninstaller.command
    and press Enter
  4. Enter the password and press Enter