Ancestor Tree Manager

Installation on macOS

Installation

1. Make sure the correct Java version (see Download page) is installed in /Library/Java
2. If ATM is already installed the program must be closed before installing a new version
3. Open a Terminal (see Instructions)
4. Start the installer:
   sudo sh ~/Downloads/AncestorTreeManager-<version>.command
   or
   sudo java -jar ~/Downloads/AncestorTreeManager-<version>.jar
   and press Enter
   Replace <version> by the actual version number
   If the installation file is not in the Downloads folder, replace ~/Downloads with the actual path
   
5. Enter the password and press Enter
6. 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, you can launch Ancestor Tree Manager by double-clicking the script you just created:

How to set an ATM icon to the desktop shortcut

1. Right-click on the script
2. Information about the script will be displayed
3. Leave this window open

4. With Finder navigate to [installation folder]/logo
5. Drag the file AncestorTreeManager.png onto the icon in the upper left corner of the information window
6. The icon of Ancestor Tree Manager is now displayed
7. Close the information window
8. From now on the script will look like this:

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