Ancestor Tree Manager

Installation on macOS

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"

5. Click on to test the script: Ancestor Tree Manager should start now
6. Close Ancestor Tree Manager
7. In the Script Editor select menu-item File Save
8. Choose Application as File Format
9. Give your script a name e.g. Ancestor Tree Manager
10. 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