Installation:Windows

Binary package

The binaries are distributed inside a single .zip file. Extract all the files and the directories to your preferred location and start using it.

All the executable applications are in bin. Among them, GeopsyLand is of interest for Windows users. It provides the list of graphical applications on the left panel and a simple emulation of a Linux terminal on the right panel. Environment variables are properly set by default (PATH) and all command line tools can be directly executed inside the terminal.

If you installed several geopsy or dinver versions, it is mandatory to set the appropriate path for tools and plugins before running them. Run in terminal:

 geopsy -clear-tools
 dinver -clar-plugins

Source package

Compiling from the source package may be an option if the binary package is not yet available. It takes a bit longer and requires several steps. Once a build environment is ready updates are relatively straight forward. Getting Git, Qt and compiling FFTW are required only once. When updating from a previous Geopsy release you can skip these steps and go directly to Geopsy package. As a general comment, do not move directories after their installation, prefer a new installation instead.

This tutorial is under construction, use it at your own risks!

Git

Git is a widely used version control tool, required to access the geopsy and Qt main repositories. The binary package for Windows comes with a bash terminal which is used here also for compilation.

Download the 64-bit standalone installer (version 2.39.1 at the time of writing this tutorial). Start the installer and follow the instructions. Default options are fine except a few detailed hereinafter. Among default options:

 * Git components
 * Vim as editor
 * Let git decide the name of the initial branch
 * Git from the command line and also 3rd party software
 * bundled OpenSSH
 * OpenSSL library
 * MinTTY
 * Default (fast forward or merge)
 * File system caching
 * No experimental options

For some other options, the default is not preferred.

 * Installation in 'C:\geopsy\Git' (Avoid spaces in directory names like 'Program files')
 * Select "Checkout as-is, commit Unix-style line endings" for line ending conversions

Mingw-w64

Mingw-w64 provides GNU C++ compiler for Windows. Download w64devkit. This tutorial is based on w64devkit-1.17.0 but another more recent release might also work. Extract the archive to

 C:\geopsy\Mingw-w64

and start

 C:\geopsy\Mingw-w64\w64devkit.exe

Git, make and g++ should be available

 ~ $ git --version
 git version 2.39.1.windows.1
 ~ $ make --version
 GNU Make 4.4
 Built for x86_64-w64-mingw32
 ~ $ g++ --version
 g++ (GCC) 12.2.0

Qt

This is an interface library that provides portability to virtually all platforms. A binary package for Microsoft Windows can be downloaded from Qt. Go to "Download. Try". Under "Downloads for open source use", click on "Go open source". Go to the bottom of the page and click on "Download the Qt Online Installer". Click on "Download" button.

A Qt exe file should be available in your Download directory. Launch "qt-unified-windows-x64-...-online". A Qt account is required to proceed with the installation. A new one can created within the installer. Once logged in, accept the Qt Open Source Usage Obligations.

By default Qt is installed in "~/Qt" but other locations can be chosen. This tutorial assumes that Qt is installed in "~/Geopsy/Qt-5.14". Qt provide a lot of components, to get the minimal footprint, select only one Qt version and inside this version, only "macOS" (Qt 5.14.2 for this tutorial). After the license agreement, the installation should start. Do not launch Qt Creator at the end.

In a terminal, add Qt path to your profile:

 echo "export PATH=~/Geopsy/Qt-5.14/5.14.2/clang_64/bin:\$PATH" >> ~/.zshrc

Update your current environment:

 source ~/.zshrc

qmake should be available:

 qmake -v

 QMake version 3.1
 Using Qt version 5.14.2 in /Users/wathelem/Geopsy/Qt-5.14/5.14.2/clang_64/lib

To run Qt graphical applications some files must be copied to a specific system path.

 sudo mkdir -p /Library/Geopsy.org/${GEOPSY_BRANCH}/plugins
 cd ~/Geopsy/Qt-5.14/5.14.2/clang_64/plugins
 sudo cp -r platforms imageformats  /Library/Geopsy.org/${GEOPSY_BRANCH}/plugins

Defining the branch and the version

The current branch and the current version are defined by the following variables

 export GEOPSY_BRANCH=3.5
 export GEOPSY_VERSION=3.5.0-preview