How

to install GEM-Selektor v. 3.3.x on your local PC (desktop or laptop)

1. To install GEM-Selektor v.3.3.x on Windows XP, Windows 7, Windows 8.1, or Windows 10:

1.1. Download or copy the installer file (e.g. “Gems3.4.2-xxxxxx.yyyyyy-win32-install.sfx.exe”) into a

1.2. The installer will ask where to install/update, suggesSng e.g. "C:\GEMS342”. If you accept, the
program will be located in "C:\ GEMS342\Gems3-app\". This folder will contain program and resource
files, including help database, and the "\DB.default\" folder with the thermodynamic database. Upon
the first start of GEM-Selektor, a folder "C:\GEMS342\Library \Gems3\projects\" will be created, where
your modelling projects will be stored later. The folder will iniSally contain some test projects.

1.3. AlternaSvely, you can type or select another locaSon ("\Program Files" is not recommended), for
example "D:\MyWork". In this case, the program will be located in "D:\MyWork\Gems3-app\", and
modelling projects- in "D:\MyWork\Library\Gems3\projects\".

1.4. A`er extracSng the files, GEM-Selektor will start automaScally; you can exit it and look for a GEMS
v3 icon on your desktop, to be used further on for starSng the GEM-Selektor code. At a first-Sme
installaSon, the "....\Library\Gems3\projects\" folder will be created and test projects copied in there
from the "....\Gems3-app\Resources\projects\" folder. If the installer is executed for update/upgrade
(i.e. into the exisSng folder containing Gems3-app), the test projects will not be copied even they were
updated in the "Resources" locaSon. However, if you install the upgraded version into a new locaSon,
the test projects will also be upgraded there, but you will have to copy or move your own modelling
projects from the previous locaSon using any file manager.

On Windows 10, it is recommended to edit the GEMS v3 shortcut (by right-click on the icon) such that
the program is launched by the Administrator.

1.5. You can also use any file manager to add your exisSng backed-up old project folders into the
"....\Library\gems3\projects\". Backup of modeling projects from this folder needs to be done at least
once per day.

1.6. To update the GEM-Selektor code, start the installer and browse to the locaSon where GEMS3 has
been previously installed, for example, to "D:\MyWork\". Only files in the "...\Gems3-app\" subfolder
will be replaced; your exisSng modeling and test projects in "...\Library\gems3\projects\" will not be
changed.

1.7. To remove the GEM-Selektor code from your computer: use a file manager to locate the installaSon
folder (e.g. "D:\MyWork\Gems3-app\") and delete it. Find the "GEMS3" icon on your desktop and drag
it into the Recycle Bin. The modeling projects will remain intact in "D:\MyWork\Library\" folder.

1
2. To install GEMS3.3.x on Mac OS X 10.7 and higher:

2.1. Click on the installer .dmg file (e.g. “Gems3.3.5-xxxxxx.yyyyyy-OSX-x86-64.dmg”) to mount it. A
window appears with the applicaSon gems3.app.

2.2. Drag the gems3.app from that window to the /ApplicaSons folder. The gems3.app contains program
and resource files, including help database and /DB.default folder with the thermodynamic database.

2.3. Opening a terminal, go to your home folder, and start GEM-Selektor once by a command:

~$ exec /ApplicaSons/gems3.app/Contents/MacOS/gems3 -d

This will create a subfolder ~/Library/Gems3/projects (if not yet available) in your home directory,
where some test modelling projects will be copied, and your own modelling projects will be stored later
on. This command will also reset configuraSon files to point to your actual locaSons.

2.4. You can add your old modeling project folders by copying them into ~/Library/gems3/projects/. To
locate this folder in Finder, click on the Mac OSX desktop, then select in the top menu "Go" "Go to
folder...", type "~/Library" in the appearing dialog, and click the "Go" buhon. Backup of modelling
projects is strongly recommended to do at least once per day.

2.5. To normally start GEM-Selektor, go to /ApplicaSons folder and double-click on "gems3.app". To add
the GEMS3.3.x icon to Dock, right-click on GEMS3 icon in the Dock, and select "Keep in Dock".

2.6. To upgrade GEM-Selektor: just move gems3.app from /ApplicaSons to Trash, and proceed with
steps 2.1 through 2.3. Only files in gems3.app will be replaced; your own modelling projects, located in
the ~/Library/gems3/projects/ folder, will not be affected.

3. To install GEM-Selektor v.3.3 on linux (ubuntu >= 14; fedora >= 16; OpenSuSE >=13):

3.1. Get the installer (e.g. Gems3.4.5-xxxxxx.yyyyyyy-linux-x86-64-noQt5.tgz file) downloaded from

3.2. Unpack the installer to your home directory. This will create a folder "~/Gems3-app/" that contains
the program and the resource files, including help database and a "/DB.default/" folder with the
thermodynamic database.

3.3. Now create in your home directory a folder like "~/MyGEMS/" and move the folder "~/Gems3-app/"
into that folder. Open the terminal, cd into "/Gems3-app/" wherever it is installed, and execute a
command:

$ ./rungems3.sh -d

The GEM-Selektor v.3 program should launch; a`er you exit it, a folder "/Library/Gems3/projects/" with
several test modeling projects will be created at the same level as the "/Gems3-app/" folder.

2
3.4. (opSonal) If the program does not start, this most probably means that the Qt5 toolkit is present in
the system path (as in the latest KDE linux distribuSons such as (k)ubuntu 16.04). Then make sure that
Qt5 is installed in the system path completely. On (k)Ubuntu linux, run in terminal the command:

$ sudo apt-get install qt5-default qhools5-dev libqt5svg5 libqt5help5

On other linux systems, some equivalent command for the respecSve package manager can do the job.

Then get another installer (e.g. Gems3.4.2-xxx.yyy-linux-x86-64-Qt5.tgz file) from the GEMS web site
hhp://gems.web.psi.ch/GEMS3) and unarchive it as described above. This installer is built on linux
kubuntu 16.04 with Qt5 in the system path and does not contain Qt5 frameworks and plugins. In this
case, the gems3-app executable must be started directly (i.e. without using rungems3.sh), for the first
Sme as:

$ cd /home/<me>/GEMS/Gems3-app/gems3 –d

and any next Sme GEM-Selektor should be started as

$ cd /home/<me>/GEMS/Gems3-app/gems3 –c

On linuxes such as Opensuse, CentOS, RedHat Enterprise, etc., this prebuilt GEM-Selektor sSll may not
work because of some system library incompaSbiliSes. In this case, it may be necessary to git clone the
code from git repository (publicly accessible) hhps://bitbucket.org/gems4/gems3gui.git and
compile/build GEM-Selektor as described in the "Overview" there.

3.5. You can copy the exisSng third-party projects, or your old project folders into
".../Library/Gems3/projects/". Backup of modeling projects is strongly recommended once a day.

3.6. To create a desktop shortcut for starSng GEMS3: copy the file GEMSv3.3.desktop from
".../Gems3-App/ToDesktop/" to the "~/Desktop/" folder; right-click on the GEMSv3 icon on your
desktop, select "ProperSes", and edit the actual locaSon of the of the GEMS3 icon (e.g.
/home/<you>/MyGEMS/Gems3-app/gems3.png). Then edit the program start locaSon in the command
line (e.g. "/home/<you>/MyGEMS/Gems3-app/rungems3.sh -c" or ”/home/<you>/MyGEMS/Gems3-
app/gems3 -c") and save.

3.7. Start GEM-Selektor v3 program by clicking on the desktop icon. If it does not start, check the path in
the icon again, or edit the rungems3.sh file by replacing "#!/bin/sh" with b"#!/bin/bash" (depends on
the parScular linux distribuSon). On Ubuntu linux 14.04 or up, you can drag the launcher icon from
desktop to the launch bar (on the le` side) and start GEMS3 by clicking on that icon in the launch bar.

3.8. To update GEM-Selektor, unpack the installer archive and replace with it the exisSng
"/Gems3-app/" folder only (your projects will remain intact in the ".../Library/Gems3/projects" folder).

3.9. To remove GEMS3 from your PC, simply delete both "/Gems3-app/" and "/Library/Gems3/" folders
where you have them in your home directory.

All operaSons described above do not require root privileges. Enjoy using GEM-Selektor v.3!