Installation
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.
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, the full version must be downloaded. Move everything in the "Ortho4XP_Data" folder except "Utils" and "Providers" (unless you have modified or custom providers) from your previous version of Ortho4XP to the new version of Ortho4XP.
| Operating System | Architecture | Full Version | SHA-256 hash |
|---|---|---|---|
| Windows 10/11 | x86 64-bit | Download | 7967efca5f6b0ee4e7e76973e34edbdbc15b152377ffdde3aa753864def7a866 |
| macOS 26 | ARM 64-bit | Download | b80e36fa4bad408eff9d9180824e5bda2a2d653890413c9b48671e7d283acd0b |
| Debian 13 | x86 64-bit | Download | 36e5aa36d03dddb89003beb59167df7da650e55efa19eb8f3eaef212573293f5 |
| Arch Linux (2025.10.01) | x86 64-bit | Download | 650d8197ff892a77ce878db4b4b460b4ce921175e2cc3021c67ed7c06274aba4 |
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.13.5. 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 Arch Linux based distributions, install p7zip, tk and gdal with pacman. When installing python requirements, install everything listed in requirements.txt with the one exception that the version of gdal must match the version installed with pacman.
For Debian based distributions, you will need the following packages for setting up using Python 3.13:
- python3.13
- python3.13-venv
- python3.13-tk
- python3.13-dev
- build-essential
- libgdal-dev
As mentioned above with Arch Linux, install everything listed in requirements.txt with the one exception that the version of gdal must match the version installed with apt.
-
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