FastPhotoTagger
About v3.0






                            
FastPhotoTagger is open Source Software.
http://fastphototagger.sourceforge.net
Copyright (c) Dennis Damico, dennis508@yahoo.com
GNU General Public License
http://www.opensource.org/licenses/gpl-2.0.php


The FastPhotoTagger for PCs home page is here.
The FastPhotoTagger for Android home page is here.

PC Installation Notes:
You need:
o Java Runtime Environment Version 7 or later
o ExifTool version 8.69 or later
o dcraw (optional)
o ImageMagick (optional)
See below.

FastPhotoTagger requires the Java Runtime Environment Version 7 or later. You may obtain it from: www.java.com.

FastPhotoTagger requires that ExifTool version 8.69 or higher be installed on your system. Install ExifTool from
http://www.sno.phy.queensu.ca/~phil/exiftool/. The first time you execute FastPhotoTagger it will attempt to locate the ExifTool executable file. If that file cannot be located you will be asked to locate and select it. The executable should be named exiftool.exe or exiftool.

To enable viewing of DNG and RAW images, you need the dcraw executable:
o Windows: Download the dcraw program from http://www.centrostudiprogressofotografico.it/en/dcraw/.
Extract the .exe file from the .zip file.
Rename the .exe file to dcraw.exe.
Move dcraw.exe to the folder that contains exiftool.

o LINUX: Install the dcraw program using your system's package manager. Be sure it is installed in a location such that the "which" program can find it. Example:
$ which dcraw
/usr/bin/dcraw

o Also, see limitations section below.

To enable viewing of TIFF images, you need the ImageMagick executable:
o Windows: Download the ImageMagick program from http://www.imagemagick.org/script/index.php.
You may install the program anywhere on your system. You may have to use the option "Install Legacy Components" to get convert.exe.
Then, in the folder containing exiftool.exe, create a symbolic link (not a shortcut) named "convert.exe" to ImageMagick's convert program in its installed location. Example from the command line prompt:
mklink convert.exe "C:\Program Files\ImageMagick.9.9.9\convert.exe"

o LINUX: Install the imagemagick program using your system's package manager. Be sure it is installed in a location such that the "which" program can find imagemagick's convert program. Example:
$ which convert
/usr/bin/convert

o Also, see limitations section below.

Windows users: read the known problem below relating to Unicode pathnames. If you are not using the Unicode workaround you may delete fastphototagger_temp.txt.

To install FastPhotoTagger open the distribution file, move FastPhotoTagger.jar to a location of your choice. If you wish, you may use an icon file to create a desktop shortcut to the jar file.

Be sure that .jar files are executable, i.e., double-clickable, on your system. If you are not sure how to do this see: http://www.wikihow.com/Run-a-.Jar-Java-File.

Execute the program by double-clicking FastPhotoTagger.jar.

FastPhotoTagger is multi-lingual. When first executed, select a language for the user interface. You may change this selection in the Settings/Other panel.


To uninstall FastPhotoTagger:
-Delete FastPhotoTagger.jar from its location.
-If present, delete the .fastphototagger folder from your user folder.
-If present, delete fastphototagger_log.txt from your user folder.
-If present, delete fastphototagger_temp.txt from your user folder.
-If present, delete the FastPhotoTagger icon files.



                             


This version of FastPhotoTagger was tested with:
-Windows 7 SP1, Windows 10
-Java Runtime Environment, Version 8 Update 101
-ExifTool 9.95

-Kubuntu 14.04
-Java version
1.7.0_111, OpenJDK Runtime Environment (IcedTea 2.6.7) (7u111-2.6.7-0ubuntu0.14.04.3)
-Exiftool 9.90


Limitations, warnings, and known problems:
-Your RAW file may not be recognized by FastPhotoTagger: There are hundreds of RAW formats. It may be a simple matter for FastPhotoTagger to recognize your format. Send email to the author.

-Your TIFF file may be displayable; FastPhotoTagger is limited by 3rd party software capability. See user guide. Some versions of ImageMagick do not correctly apply the Exif Orientation tag.

-Corrupt image files: There are reports that a corrupt image file can hang ExifTool. If this happens, FastPhotoTagger will also hang. Use a system Task Manager or System Monitor to terminate the ExifTool process.

-Memory management: In extreme cases, such as folders with many thousands of images, you may notice missing thumbnail images or FastPhotoTagger slowing down drastically or even hanging. This indicates that FastPhotoTagger needs more memory to operate. You may supply more memory by executing the program from the command line like this:
java  -Xmx1024m  -Xms1024m  -jar FastPhotoTagger.jar
or change the 1024 values to any value greater than 512 (the default).
Likewise you can constrain the program to use less memory by changing 1024 to any value less than 512 that does not cause the insufficient memory condition.

- (Sharp s): The metadata database is inconsistent when searching for (Sharp s), sometimes treating it as the equivalent of "ss" and sometimes not. The metadata explorer does consistently treat as "ss".

-Unicode in pathnames: On Windows, ExifTool will not process files with non-ASCII Unicode characters in the filename or pathname. (This includes accented characters such as ,
, , , , and other non-English characters.) This is due to an underlying lack of support for Unicode filenames in the Windows standard C I/O libraries. (This problem does not exist on Linux.) Exiftool 9.79 addresses this problem but FastPhotoTagger has not been modified to support the Exiftool solution.

This version of FastPhotoTagger provides an experimental "workaround" to avoid this problem, but with a performance cost. The workaround causes FastPhotoTagger to copy files containing non-ASCII pathname characters to a simple ASCII temporary path, perform the Exiftool operation there, then copy the file back to its original location. To use this workaround, follow these steps.
1. Copy the file fastphototagger_temp.txt from the distribution file to your home folder. Your home folder will be something like "C:\Users\Dennis".
2. Edit fastphototagger_temp.txt to contain a simple ASCII path to a folder for which you have read and write access. For example, "C:\temp".
When you use this workaround, the File attributes of metadata will reflect the temporary location, not the real location. However, the temporary attributes will never be written to the image file.
If you use this workaround, please email your opinion of its usefulness to the author.


-When importing settings from the Android version of FastPhotoTagger, labels will not be imported unless (on Android) the Screen Label exactly matches a Metadata Screen Label.