How to install JPhotoTagger's ZIP distribution

Non Windows users can install JPhotoTagger's platform independent ZIP distribution JPhotoTagger.zip, located at the Download page. This artice describes, how to install JPhotoTagger from that ZIP file.

The installation typically consists of these 3 steps:

  1. Unzip the ZIP file either into a programs folder, e.g. /usr/local or your home folder, e.g. /home/peter. This can be done with your file manager e.g. Nautilus or Dolphin or via the command line: unzip JPhotoTagger.zip If unzip is an unkown command, you must install it before installing JPhotoTagger's ZIP distribution from the command line.
  2. Write a start script, see below
  3. Link the start script to your Desktop

Start script

The start script starts the Java Virtual machine with JPhotoTagger's JAR as argument and parameters how much memory JPhotoTagger can use. See also parameters for other languages. The script has to be executable. Under Linux you can write a bash script - a plain text file with the name e.g. JPhotoTagger.sh:

#!/bin/sh

# Comments starting with a hash sign "#". The "&" at the end of the
# command starts JPhotoTagger as a background process.
#
# If the java executable's directory is not in the $PATH environment variable,
# the full path must be specified, e.g. /usr/bin/java instead of "java"
#
# If JPhotoTagger is not installed into your home directory, the full
# path has to be specified, e.g. /usr/local/JPhotoTagger/JPhotoTagger.jar
# instead of "$HOME/JPhotoTagger/JPhotoTagger.jar"
#
# You can give JPhotoTagger more memory via the -Xmx parameter,
# 750m are 750 Megabytes

java -Xms30m -Xmx750m -jar $HOME/JPhotoTagger/JPhotoTagger.jar &

If not already done, make the script executable. If it's name is JPhotoTagger.sh, type into the command line chmod +x JPhotoTagger.sh.

Usually it's a good idea, to put a link to that script as a desktop icon and/or as a start menu entry.

Updates

Unzip JPhotoTagger's updated ZIP distribution file always into the same folder where it is already installed. Nothing further has to be done.

Author:
Write e-Mail
Status of this document: 2013-05-20