Build and publish the EnMAP-Box

Build the EnMAP-Box Plugin

Building the EnMAP-Box plugin is done by creating a zip file the QGIS Plugin Manager uses to install the EnMAP-Box from. This requires that:

  1. you have the development specific python packages installed (see 2. Install packages required for developers)
  2. git is available in your shell/command line (see _dev_installation_detailed)
  3. you use the EnMAP-Box code from the EnMAP-Box repository (see Add EnMAP-Box Code) instead from your local QGIS installation.


python make/

creates or updates:

  • deploy/enmapboxplugin/ which contains the plugin code + additional files
  • deploy/ - just deploy/enmapboxplugin as zip file
  • deploy/qgis_plugin_develop_local.xml a QGIS Plugin Repository XML that can be used for local testing


The <subsubversion> consists of <date>T<time>.<active branch> and is generated automatically.

This helps to generate, test and differentiate between EnMAP-Box versions of different development steps.

A successful ends with a printout like:

### To update/install the EnMAP-Box, run this command on your QGIS Python shell:

from pyplugin_installer.installer import pluginInstaller
#### Close (and restart manually)

QProcess.startDetached(QgsApplication.arguments()[0], [])

## press ENTER

Copy and run it in your QGIS python shell to install the build EnMAP-Box plugin and restart QGIS. Alternatively, you can install the plugin in QGIS with a few mouse clicks more by:

1. Open the QGIS Plugin Manager 3. Install from ZIP with the created ZIP file 4. Restart QGIS to account for activate changes in python code

Publish the EnMAP-Box

Official EnMAP-Box plugin master versions are named like They need to be uploaded to using an OSGeo account.

Other versions, e.g. development snapshots are named like or and might be distributed using the repositories download section

Publish the EnMAP-Box documentation

Updates to the EnMAP-Box documentation (folder doc/source) are automatically detected by readthedocs if they get pushed either to the develop or master branch.

To create the HTML based documentation on your local system call:

cd doc make html

This creates a folder doc/build with the HTML documentation. To visualize it, just open doc/build/html/index.html in your webbrowser.