Skip to content

Installation

shred86 edited this page Jun 3, 2024 · 29 revisions

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.11.9. Use the "Customize installation" option and make sure "pip" and "tcl/tk and IDLE" are selected on the Optional Features page.

  2. From a Command Prompt window, install the required packages: py -3.11 -m pip install -r requirements.txt

  3. Go to the Ortho4XP folder: cd /path/to/Ortho4XP

  4. Launch Ortho4XP: py -3.11 -m Ortho4XP_v130.py

(Optional) Install tools needed for using elevation data (custom_dem) other than the default:

  1. Download and install the latest Microsoft Visual C++ Redistributable (Microsoft C and C++ (MSVC) runtime libraries). The link provided is specific for Windowws 64-bit (X86). If you need a different version, they can be found here.

  2. Download the Geospatial library wheels for Python. The link provided is specific for Python 3.11 and Windows 64-bit (X86). If you need a different version, they can be found here.

  3. Install GDAL (update the path to where you downloaded the file in step 2): py -3.11 -m "/path_to_downloaded_file_in_step_2/GDAL-3.8.4-cp311-cp311-win_amd64.whl"

Linux

Not yet updated.

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. Of note, this can take approximately 25-30 minutes: ./install_mac.sh

Clone this wiki locally