Installation instructions

pip

Note that using pip outside virtualenv is not recommended since it ignores your systems package manager. If you aren’t comfortable debugging package installation issues, this is not the option for you.

Create and activate a virtualenv:

virtualenv dfimagetoolsenv
cd dfimagetoolsenv
source ./bin/activate

Upgrade pip and install dfimagetools dependencies:

pip install --upgrade pip
pip install dfimagetools

To deactivate the virtualenv run:

deactivate

Ubuntu 18.04 and 20.04 LTS

To install dfimagetools from the GIFT Personal Package Archive (PPA):

sudo add-apt-repository ppa:gift/stable

Update and install dfimagetools:

sudo apt-get update
sudo apt-get install python3-dfimagetools dfimagetools-tools

Windows

The l2tbinaries contains the necessary packages for running dfimagetools. l2tbinaries provides the following branches:

  • main; branch intended for the “packaged release” of dfimagetools and dependencies;

  • dev; branch intended for the “development release” of dfimagetools;

  • testing; branch intended for testing newly created packages.

The l2tdevtools project provides an update script to ease the process of keeping the dependencies up to date.

The script requires pywin32 and Python WMI.

To install the release versions of the dependencies run:

set PYTHONPATH=.

C:\Python3\python.exe tools\update.py --preset dfimagetools