SETS Installation Guide

Installing python

At first install the newest version of python 3. The installer can be downloaded from the python website. During installation make sure to install python to PATH by selecting the according checkbox at the bottom of the very first window of the installer. Follow the instructions of the installer to complete the installation.

Downloads & Preperations

Once the python installation is complete, create a new folder on your PC that will contain the app. This folder may not be a subfolder of the Downloads folder. Installing SETS to a non local location like OneDrive may or may not work, using a local folder is therefore recommmended. In this walkthrough this folder will be called SETS and is located directly on drive D:\. From the GitHub repository download the following files and folders with all the files they contain and put them into the just created SETS folder.

• Folders to download:
  • local
  • src
• Files to download:
  • main.py
  • requirements.txt

Installation

With those files in place, open a command line. This can be done by pressing WindowsButton+R, typing cmd and hitting Enter or by searching for cmd in the start menu. Navigate the command line path to be identical with your SETS folder path by using pushd "D:\SETS". Replace D:\SETS with your path without removing the quotation marks. The path can be retrieved by clicking into the navigation bar of the Windows Explorer while inside the correct folder.

Use the command python -m pip install -r requirements.txt to install the requirements for this app. Wait for the execution to be finished, indicated by seeing the current path again at the bottom of the command line. During execution various statements will appear on the command line. Unless there are entire red paragraphs titled "Error" or "Failure" the installation was successful.

Download Images

Now download the images archive from the GitHub page and extract it. If you choose the self-extracting archive (.exe extension), just execute it and select a path for it to unpack to. Otherwise you need to extract the archive manually. It is preferred to do that with a dedicated archiving software, but windows default extraction works as well. In your app directory create a folder named .config and put the extracted images folder into it. You can run SETS without this step, but first start can take extremely long due to thousands of images being downloaded.

Checkpoint

With this step done, your folder should have the following structure:

SETS
 +- .config
 |  `- images
 |    `- <lots of images>
 +- local
 |  `- <some files>
 +- src
 |  `- <some more files>
 +- main.py
 +- requirements.txt

Starting the app

To start the app complete the following steps:

• Open a command line: use WindowsButton+R, type cmd and hit Enter
• Navigate the command line path to your app folder: pushd "<YourFolderName>"
• Start the app by using the following command in your command line: python main.py

If you want to automate this step, download this batch file from the SETS Loader Github Repository and put it into your app folder. Double-clicking this will open the app as well.