Installation

There are currently two ways of installing Útil paisagem, depending on the computer's operating system. Both will create a shortcut to launch it, but the app may still be launched from the command line if the user wants.

Linux (and possibly MacOS)

1. In order to install Útil paisagem, first ensure you have Python 3.13 or higher installed.
2. After this, download the latest release and decompress it on the folder of your choice.
3. Run ./install.sh.
4. It will then appear on your start menu or desktop. Use those shortcuts to run it.

Attention: if the install script cannot find your Python executable, pass it as an argument to the script. E.g.:

./install.sh -p /path/to/python3.13

See Usage for post-installation instructions.

Windows

1. Access the latest release and download the installer (Util_Paisagem_Installer.exe).
2. Run the installer and follow the instructions.
3. A shortcut will be created at the start menu. Use this shortcut to run it.

See Usage for post-installation instructions.

Frequently imagined questions

1. I can't install it!

First of all, check if you can use Python on the command line using python3 (Linux) or py (Windows). If not, pass the path to the Python executable to the installer with ./install.sh -p /path/to/python3 (Linux) or win_install.bat -p c:\path\to\python.exe (Windows). Of course, use the appropriate path.

If you still cannot install, the following commands on the Útil paisagem folder should help (use the adequate Python executable):

Linux:

python3 -m venv .env
source .env/bin/activate
python -m pip install -r requirements.txt
python shortcut.py

Windows (using the traditional command line):

py -m venv .env
.env\Scritps\activate.bat
python.exe -m pip install -r requirements.txt
python.exe shortcut.py

If you still cannot install it, please create an issue providing the output of the above attempts.

2. What if I have multiple Python versions on my computer?

You may provide the path to the correct Python version passing it to the installer: install.sh -p [correct Python here] or win_install.bat -p [correct Python here].

3. How do I upgrade or override an Útil paisagem installation?

Do exactly as in the installation instructions, but first delete the .env directory if it exists — it will be recreated during installation. No information will be lost in the process. If you used the Windows executable installer, uninstalling and reinstalling it is a good practice.