-
Notifications
You must be signed in to change notification settings - Fork 3
Installation
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.
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/.
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.
| Operating System | Architecture | Full Version | Update |
|---|---|---|---|
| Windows 11 | x86 64-bit | Download | Download |
| macOS 14.5 | ARM 64-bit | Download | Download |
| Linux | x86 64-bit | Download | Download |
| Operating System | Architecture | Full Version | Update |
|---|---|---|---|
| Windows 11 | x86 64-bit | Download | Download |
| macOS 14.5 | ARM 64-bit | Download | Download |
| Linux | x86 64-bit | Download | Download |
| Operating System | Architecture | Full Version | Update |
|---|---|---|---|
| Windows 11 | x86 64-bit | Download | Download |
| macOS 14.5 | ARM 64-bit | Download | Download |
| Linux | x86 64-bit | Download | Download |
| Operating System | Architecture | Full Version | Update |
|---|---|---|---|
| Windows 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.
Before launching Ortho4XP, macOS users will have to remove macOS security restrictions on application and its dependencies.
-
Open a Terminal window and browse to your Ortho4XP folder:
cd /path/to/Ortho4XP -
Run the following which can several minutes to complete:
xattr -dr com.apple.quarantine *
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.
-
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.
-
Run the installation script by opening
install_windows.bat -
Launch Ortho4XP using
start_windows.bat
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)
-
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.
-
Install the Homebrew package manager:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" -
Update the install_mac.sh permissions to allow it to be executed:
chmod 755 install_mac.sh -
Run the installation script:
./install_mac.sh
Note: The install process can take 30+ minutes depending on your system.
- Start Ortho4XP using:
./start_mac.sh