Installation

Via PyPi

The first thing to decide is whether you want to install ELDonationTracker to your system packages, user packages, or a virtual environment.

System Packages

Todo

Add instructions and note that this could potentially cause problems with system packages.

User Install

Todo

Add Instructions

Via Github

Here you have a few options depending on what you want to do.

GUI Single Executable Users

Go to the latest release and download one of the files that ends in “For Windows”. For the 4.4.0 release you can choose a single executable binary or the zip file as before. Unzip it to the location you want to use and then proceed to Usage.

New in version 4.4.0: Single-binary executable build added.

Changed in version 4.0.1: Pyinstaller images will no longer be made for Linux as there are issues with the version of libC it links to as well as other side effects from the VM used by the Github CI system. Linux users can still use the GUI via PyPi, Source Code download, or git clone.

Commandline Users and/or Developers

Two options:

  1. Go to the latest release and click on “Source Code (zip)” or “Source Code (tar.gz)” depending on whether you’re using on Windows or Linux. Then proceed to Usage.

  2. Go to the main Github page and click on “Clone or Download” and click the button to copy the URL to your clipboard. Then run:

git clone https://github.com/djotaku/ELDonationTracker.git

And any time you want to get up to the latest version you can just go to that folder and type:

git pull

The master branch is always equivalent to the latest release (except maybe with more up-to-date documentation) so you should always end up with a working version of ELDonationTracker if you do a git pull. (As long as you’re not changing any files. For that reason you may want to move your participant.conf to the persistent location - see participant.conf for that location) Then proceed to Usage.