Skip to content

Installation

Jump to bottom
shred86 edited this page Jul 20, 2024 · 29 revisions

Ortho4XP is a Python-based tool that relies on various dependencies. Two methods exist for setting up Ortho4XP, the recommended setup which is a bundled version requiring no additional setup and the manual setup where dependencies must be installed separately.

Recommended setup

Download the version specific for your operating system and architecture. The download will contain the Ortho4XP application and a folder labeled _internal that contains all of the dependencies and files used by Ortho4XP. The application and _internal folder must be kept together. The data for Ortho4XP is located in /_internal/Ortho4XP_Data/.

If updating from a previous version, only the executable file is needed which can be downloaded using the link in the Update column. macOS users will have to reapply the additional steps mentioned below.

Download Links

Version 14.1.07

Operating System Architecture Full Version Update
Windows 10/11 x86 64-bit Download Download
macOS 14.5 ARM 64-bit Download Download
Linux x86 64-bit Download Download

Launch Ortho4XP by opening the Ortho4XP executable. A Command Prompt or Terminal window will appear which will need to remain open while the application is open. The first time Ortho4XP is opened, it can take up to 10-20 seconds before the main interface appears.

Additional steps for macOS

Before launching Ortho4XP, macOS users will have to remove macOS security restrictions on application and its dependencies.

  1. Open a Terminal window and browse to your Ortho4XP folder: cd /path/to/Ortho4XP

  2. Run the following which can several minutes to complete: xattr -dr com.apple.quarantine *

Additionally, Rosetta is required for one of the tools used by Ortho4XP which can be installed by running the following from terminal: softwareupdate --install-rosetta

Manual setup

For users who prefer not to use the bundled/packaged version, Ortho4XP can be set up manually by first clicking here to download this repository, extract it to a preferred location on your computer and follow the instructions for your operation system below.

Windows

  1. Download and install Python 3.12.3. Use the "Customize installation" option and make sure "pip" and "tcl/tk and IDLE" are selected on the Optional Features page and "Add python to environmental variables" is selected on the following page.

  2. Run the installation script by opening install_windows.bat

  3. Launch Ortho4XP using start_windows.bat

Linux

Steps will vary depending on your Linux distribution and version. For Debian based distributions, you will need the following packages for setting up using Python 3.12. Ortho4XP can also run on older versions of Python 3:

  • python3.12
  • python3.12-venv (optional)
  • python3.12-tk
  • python3.12-dev
  • build-essential
  • libgdal-dev (tested with version 3.8.4 and 3.9.0)

macOS

  1. Open Terminal and navigate to the Ortho4XP directory. A simple way to do this is hold the Control key and mouse click (or just "right click") the Ortho4XP folder, select "Services" -> "New Terminal at Folder". The additional steps are Terminal commands.

  2. Install the Homebrew package manager: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  3. Update the install_mac.sh permissions to allow it to be executed: chmod 755 install_mac.sh

  4. Run the installation script: ./install_mac.sh

Note: The install process can take 30+ minutes depending on your system.

  1. Start Ortho4XP using: ./start_mac.sh
Clone this wiki locally