Skip to content

Installation

Jump to bottom
shred86 edited this page Jun 10, 2024 · 29 revisions

Ortho4XP is a tool developed in the Python programming language which utilizes several different dependencies. Using PyInstaller, everything has been bundled into a package allowing users to simply download and run the application without any additional setup.

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 data for Ortho4XP is located in /_internal/Ortho4XP_Data/.

Ortho4XP 1.4.01 (forked)

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 you see the main interface appear.

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 *

Updating

If using the packaged version above (recommended setup), new versions of this forked version of Ortho4XP can be updated by downloading the and replacing the Ortho4XP executable below.

Note: macOS users will have to remove the security restrictions again but only for the updated executable filing using: xattr -dr com.apple.quarantine Ortho4XP from the Ortho4XP folder.

Ortho4XP 1.4.01 Update

Manual setup

Download this repository and 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