Please switch to jExifToolGUI
ExifToolGUI is a GUI front-end for exiftool to view metadata information with some editing features. There are many tools for viewing/editing metadata inside image files. In my opinion, ExifTool by Phil Harvey, is the best I've found so far. “Camera Digital Exif Info” is a free info viewer, provides you to check your digital camera (most of the SLR) shutter count and basic EXIF info. There are various EXIF tools around of course, but cool GUI application and simplicity are always a plus. ExifToolGUI is best (portable windows 64 version) Metadata use too ‘exiftool.exe’ for editor Thanks. D James Reply AnalogExif will not work on a Mac.
Table of Contents
- 1 Overview
- 2 Installation
- 2.2 Installation on Mac OS X
- 3 General usage
- 5 Edit Data
- 5.7 Example workflows
- 6 Extra Menu
pyExifToolGUI
This manual is for pyExifToolGUI (version 0.32, January 2013).pyExifToolGui is a python pySide QT4 script program that reads and writes metadata likeexif, xmp, gps, gpano tags from/to image files. It can use a 'reference' image as source image tocopy data from. A strong point of this software is the ability to write the data,copied or not from a source image, to multiple images at once.
1 Overview
pyExifToolGui is a python pySide QT4 script program that reads and writesexif, gps, xmp, gpano (and a very limited set of IPTC) tags from/to image files using exiftool. pyExifToolGUI: py for python, GUI for Graphical User Interface to ExifTool.
pyExifToolGui is a graphical frontend for the excellent open sourcecommand line tool ExifTool by Phil Harvey.pyExifToolGui is not a complete ExifTool Gui, far from that.I needed a tool to add gps data to my images and couldn't find oneand decided to write my own. So the main goal for this tool was the ability to write gps data to photos as I photograph a lot in buildings like Churches/Cathedrals and Musea (when allowed), which means that the gps functionality of the camera doesn't function.In the mean time the functionality of pyExifToolGUI has expanded and also supports reading, writing and exporting all kind of metadata. Next to that it now contains also extended photo file renaming functionality based on the exif info in your photos.By now pyExifToolGUI is a general exiftool Gui but it is still far from complete.
This pyExifToolGUI tool is also a geotagging tool since version 0.4!
IPTC tags are only partly supported. IPTC is an older and slowly deminishing metadata standard being replaced by xmp. Whereapplicable, e.g. redundant tags in xmp, the iptc tags will be updated simultaneously.
This program is Open Source and completely free and will always stay that way, but you can donate any amount to me to showyour appreciation. See the Help menu in the program or the donate button below.
1.1 This manual and the pyExifToolGUI version
This manual and the pyExifToolGUI version might not always run synchronously. If new functionality is added to the program which requires a new chapter or paragraph, the manual will be updated for that new section.However, not all parts of the manual will/might be updated which might lead to older program screens in the manual that might slightly deviate from the program version you will be working with.
Note also that you will see screen captures from several operating systems (Linux/Windows/Mac OS X) and/or window managers (on Linux).
2 Installation
This tool is written for Linux and primarily aimed at Linux.However, it runs fine and functions fine on Mac OS X and Windows as well for which, respectively, a program bundle and an executable is available for download.pyExifToolGUI is currently not part of any Linux distribution and I'm currently lacking the skills to write a distutils or exportutils (or good automake/configure) script to package it for Ubuntu (or any other Debian based linux), or (Open)Suse or Fedora/Redhat.This also means that it doesn't do any dependency checks for necessarylibraries and so on. I wrote a simple 'setup' script that takes care of installation and removal. This setup script is for Linux but can also be used on Mac OS X.
Note: pyExifToolGUI comes without exiftool which you need to download yourself from Phil Harvey's exiftool site if you want the latest version. On Linux you can also use the version belonging to your distribution.
For Mac OS X you can either run the simple pyExifToolGUI.app bundle (via the setup script) from the tar.gz and install the dependencies yourself, or you can download the full bundle which includes everything internally.
For Windows a python executable has been created (Note to Windows users: Currently there is the closed sourced but free exiftoolgui for windows. pyexiftoolgui contains the functionality of applying your changes to a selected set of images at once, exiftoolgui only has this on a limited set of tags. The total 'functionality set' of exiftoolgui is currentlymore then that of pyexiftoolgui, but it misses the new GPano functionality (see paragraph 5.4).
You can run pyexiftoolgui without installing it: see paragraph 2.4 below theinstallation instructions.
2.1 Installation on Linux
Dependencies (Meaning that you need to install them yourself):
- python: part of every linux system, so always available, but >=2.6 required.
- pyside: Install via your distribution's package manager. Otherwise download it from www.pyside.org
- python-pyside (qtcore, qtgui and qtuitools are required): Install via your distribution's package manager.
Otherwise download it from www.pyside.org - ExifTool: Install via your distribution's package manager.
Installation:
- Untar the package to some folder.
- Open a terminal and move into the folder where you untarred the pyExifToolGui-x.y.tgz
- pyExiftoolGUI <= 0.31: Run the setup script from the command line with .
- pyExiftoolGUI >= 0.32: Run the setup script from the command line with .
- pyExifToolGUI will be installed and you should have an icon in your menu under the Graphics sub menu or in your Dash (Ubuntu).
- Start and enjoy.
2.2 Installation on Mac OS X
You have two options for installation on Mac OS X
2.2.1 Full application bundle
Download the dmg with the full pyexiftoolgui.app bundle. Open the dmg and copy the pyexiftoolgui.app to a place of your liking where /Applications is of course the most suitable location.
2.2.2 Simple application bundle (install dependencies yourself)
Dependencies (Meaning that you need to install them yourself):
- python: part of every linux system, so always available, but 2.7 required.
- (Snow) Leopard: Download python 2.7 from python.org and install. Then run the 'Update Shell Profile.command' from /Applications/Python 2.7
- (Mountain) Lion comes with python 2.7
- pyside: Download it from www.pyside.org. (You can also install it from MacPorts but this will give issues most of the time.)
- pyX.Y-pyside: Install via MacPorts. (XY needs to be 2.7).
- ExifTool: Download the DMG from the ExifTool website (highly preferred) or install via MacPorts.
Installation:
- Untar the package to some folder.
- Open a terminal and move into the folder where you untarred the pyExifToolGui-x.y.tgz
- pyExiftoolGUI <= 0.31: Run the setup script from the command line with .
- pyExiftoolGUI >= 0.32: Run the setup script from the command line with .
- The script will install a 'bare bones' pyExifToolGUI.app in your Applications folder. Note that the pyExifToolGUI.app is NOT a complete self contained application. It needs the mentioned dependencies.
- Start and enjoy.
2.3 Installation on Windows
For windows an executable has been created. This could be easily packaged with someopen source installer like INNOsetup, but for the moment it is simply packaged in a zip file. Unzip the zip archive to some folder of your liking and start it. This also meansthat the package does not create registry entries.Note: As mentioned in the intro: pyExifToolGUI comes without exiftool itself. If you download it, the default version for windows is called exiftool(-k).exe. Always rename this to exiftool.exe as the exiftool(-k).exe version pauses after every screen of output and requires a keypress to continue: You don't want that.(Tip: If you only see exiftool(-k) without an extension in you file manager then simply rename it to exiftool).
2.4 Run pyexiftoolgui from download folder (No Installation)
You can run pyexiftoolgui without installing it.
- Linux/MacOSX
- Make sure you have the dependecies installed as described above in the subsections.
- From this folder, start in a terminal:
- Windows
- Make sure you have the dependecies installed as described above in the Windows subsection.
- From this folder, start in a command-box (dos-box): python bin/pyexiftoolgui (If python is not in your path, provide the full path to it)
Uninstall / Removal
- Open a terminal
- Move into the folder where you untarred the pyExifToolGUI.
.tgz (You might need to download again if your removed everything). - pyExiftoolGUI <= 0.31: run the setup script from the command line with .
- pyExiftoolGUI >= 0.32: run the setup script from the command line with .
- On Mac OS X simply remove pyExifToolGUI.app from /Applications
- On Windows simply remove the folder containing the pyexiftoolgui.exe application.
3 General Usage
The program consists of a left pane containing your photos, and a right pane which consists of a set of tabs. One of these tabs contains a subset of tabs.Next to the tabs on the right the program also has an 'Extra' menu which contains another set of functionalities.A number of buttons and functions will not work, and are disabled, untill you have loaded at least one photo.Most actions on your images which you perform in the right tabs or in the Extra menu, only work after having selected at least one, or more of the loaded photos in the left pane.
View data
Select an image and simply click one of the radiobuttons. If you have multiple images selected, the metadata for the last selected image will be displayed.
Edit data
Here as well: All actions in the right 'Edit' tab only work after having selected one or more of the loaded photos.
- You can select one image and modify the data for it.
- You can select multiple images at once and modify the data for all these images at once.
- You can select one image, copy data from it, then select multiple images, and paste the (copied) data to these multiple images at once.
'Extra' menu
This is not a tab, but a sub-menu from the main menu. A few options can only be used in conjunction with the Context menu.
3.1 Context menu
The program also contains 'context menu' functionality, which is more generally known as 'right-click' functionality. This functionality can be very handy in some situations as it reduces mouse (kilo)meters.Without photos loaded, you will have a 'mini' menu. With photos loaded you will get a larger context menu containing image related functions.Context menu without photos loaded. | Context menu with photos loaded. |
4 View Data
The 'View Data' tab gives you the option to display all available meta data from a photo (image).You select a photo on the left side and click the radiobutton on the right side to see all or a selected set of data of the photo.As ExifTool supports a large number of image formats, but also movie formats, all available metadata thatExifTool can read, can be displayed by pyExifToolGUI as well. The file filter, used to select files from the file dialog, is by default set to all image types pexiftool supports, but can also be set to the total set of file extensions that exiftool supports (and simply to 'All files (*.*)'). Note that some of the data, or subsets of data, is simply not available in the non-image formats.
pyExifToolGUI will try to make a preview (thumbnail) of the image, but will not always succeed as most RAW formats are not supported. In case of other formats like movies and so on, the creation of a preview will almost certain not function.
Note that the 'Display Image' button will display the selected image in the default image viewer. If this 'image' happens to be a movie, the movie will be displayed in the default movie/media viewer if the format is supported. (Right-click ->Display image works as well).
Image rotation is not always correctly 'interpreted' by the underlying QT image plugins that create the preview thumbnails. If you think it is not correct you can simply select the image, click on the 'Display Image' button and see whether your 'normal' image viewer displays it correctly, meaning that your image has the correct setting.
5 Edit Data
The application is a so called 'tabbed' application. The 'Edit Data' tab is the (obvious) tabthat contains the sub tabs with all the edit options. Currently a moderate set of tabs have been defined but the order, number and even content can change during the further development of this application.
5.1 Edit gps Data
This tab is used to add GPS data to your images. This tab works on a combination ofexif, xmp and iptc gps data as latitude, longitude and altitude are covered in both the exif andin the xmp metadata structure. The Location metadata details (Country, Province/State, city, Location) are covered by xmp and IPTC. This tab therefore acts on multiple tag categories (exif, xmp and iptc) at once and simply tries to make your gps/location data as complete as possible in the several tag categories.
Buttons working on image(s):
- Copy from selected image: This will copy all the (available) gps data fromthe selected image into the input fields.
- Save to selected image(s): This will save the gps data to your selected image(s).
Note: When the 'Save' checkbox is enabled, empty fields will write empty values to your image(s). Take this into account!
General buttons:
- Reset fields: This will empty all fields and set radiobuttons and checkboxes to their defaults.
- Open MapCoordinates.net: This will open the mapcoordinates.net website enabling you to get and copy latitude, longitude and altitude data for your photo(s). MapCoordinates is based on Google Maps.
Note that the altitude is mostly correct. but sometimes completely wrong. - Help: This button opens the manual you are currently reading.
Calculator buttons:
- Copy to input fields: This copies the calculated values (bottom half) to the input fields (top half).
- Decimal to Minutes-Seconds: Convert decimal longitude/latitude values to deg-min-sec.
- Minutes-Seconds to Decimal: Convert deg-min-sec to decimal latitude/longitude (necessary for input).
5.2 Edit exif Data
This tab is used to add (a limited amount of) exif data to your selected image(s).
Things to take into account!
As you can see the options all have a Save checkbox behind their input fields.It means that this option will be saved when checked, even when the field is empty.This also means that you can:
- overwrite existing data with empty data 'by accident'.
- deliberately overwrite existing data with data from empty fields.
Available buttons:
- Copy from selected image: This will copy all the (available) exif data fromthe selected image into the input fields.
- Save to selected image(s): This will save the 'checked' exif data to your selected image(s).
- Copy Defaults: This will copy the default Artitst and Copyright data which you provided in the Preferences tab.
- Reset fields: This will empty all fields and set checkboxes to their defaults.
- Help: This button opens the manual you are currently reading.
5.3 Edit xmp Data
This tab is used to add (a limited amount of) xmp data to your selected image(s).
Things to take into account!
As you can see the options all have a Save checkbox behind their input fields.It means that this option will be saved when checked, even when the field is empty.This also means that you can:
- overwrite existing data with empty data 'by accident'.
- deliberately overwrite existing data with data from empty fields.
Available buttons:
- Copy from selected image: This will copy all the (available) xmp data fromthe selected image into the input fields.
- Save to selected image(s): This will save the 'checked' exif data to your selected image(s).
- Copy Defaults: This will copy the default creator and rights data which you provided in the Preferences tab.
- Reset fields: This will empty all fields and set checkboxes to their defaults.
- Help: This button opens the manual you are currently reading.
5.4 Edit GPano (Google Photosphere) data
This tab is used to add GPano Google PhotoSphere data to your selected image(s).
The Google PhotoSphere functionality has been added in November 2012 to PicasaWeb and Google+ to enable the useof auto-rotating panoramic photos inside these products. For more info see this Google page
This functionality is only available if you have exiftool 9.07 or newer. You can always downloadthe latest exiftool version.On Windows and Mac OS X simply install it. On Linux you simply unpack the tar.gz to some folder. After the install/unpack you can use the Preferences tab to select that untarred version.
Things to take into account!
As you can see the options all have a Save checkbox behind their input fieldsIt means that this option will be saved when checked, even when the field is empty.This also means that you can:
- overwrite existing data with empty data 'by accident'.
- deliberately overwrite existing data with data from empty fields.
Available buttons:
- Copy from selected image: This will copy all the (available) exif data fromthe selected image into the input fields.
- Save to selected image(s): This will save the 'checked' exif data to your selected image(s).
- Reset fields: This will empty all fields and set checkboxes to their defaults.
- Help: This button opens the manual you are currently reading.
5.5 Geotagging
Geotagging adds GPS data to your images based on data from a GPS track log file. This GPS track file can be used from your phone, gps device, navigation device, or whatever you have providing such a GPS track.
The GPS track log file is loaded, and linear interpolation is used to determine the GPS position at the time of the image, then the following tags are written to the image (if the corresponding information is available).It means that your camera needs to be set correctly with regard to the date/time of the location where you are.
PyExifToolGUI also supports the 'Geosync' feature of ExifTool. The Geosync tag is only needed when the image timestamps are not properly synchronized with GPS time.
For example, a value of '+1:20' specifies that 1 minute and 20 seconds is added to the Geotime value before checking with the GPS track file. This is for a camera running 1 minute 20 seconds slower than the GPS clock.
The Geosync time is specified as 'SS', 'MM:SS', 'HH:MM:SS' or 'DD HH:MM:SS' (where SS=seconds, MM=minutes, HH=hours and DD=days), and a leading '+' or '-' may be added for positive or negative differences.
Note: Do not use (double) quotes around the geosync time in pyExifToolGUI. Simply use something like -25 or +1:20
In pyExifToolGUI you have 2 options:
- Use (a selection of) the images you loaded in the left images pane.
- Specify a folder containing a set of images to be tagged.
In case of the first option you need to leave the folder empty. If the 'Folder containing the images:' is not left empty, it will always be the first option used.
Note that pyExifToolGui will write both the EXIF GPS tags as well as the XMP GPS tags.
5.6 IPTC data (not directly supported)
IPTC is an older metadata information standard.It stands for 'International Press Telecommunications Council', also with a combination with the Newspaper Association of America (NAA) Information Interchange Model (IIM).This already shows the primary goal of this standard which is perhaps not what an amateur photograph is aiming for.Next to that: IPTC is being phased out in favor of XMP.
On some of the edit tabs the IPTC data is automatically updated when (for example) the xmp data is updated.
5.7 Example workflows
5.7.1 General workflow
Below you'll find an example of how you can use the program to edit the metadata of your images.Click the images for a full size version.| Load your image(s) via 'File -> Load Images', via the 'Load Images' button or via the right-click option in the context menu. Go to the 'Edit -> Gps' tag. If one of your images contains the info you need for your other image(s), select that image. Use the 'Copy from selected image'. The available gps information will be copied into the relevant input fields. |
The xmp/iptc location info (location, country, state, city) is hardly ever available, but you can add the info yourself. In case your images don't contain any information at all, but you do know the location, you can click the 'Open MapCoordinates.net' button. This will open the mapcoordinates.net website in your default webbrowser. mapcoordinates.net is based on google maps and you can search for the location and landmarks, like 'Eiffel tower' (in Paris) or 'machu picchu' (Peru). The website will display a popup with the decimal altitude and longitude coordinates and the altitude. Note that this altitude is mostly correct, but sometimes completely wrong. |
After you have added or altered the information, you need to pay attention to which information you want to save to your image(s). The Save checkboxes determine which information will be stored upon saving. Note that when an input field is empty, you can by accident, or deliberately write 'clean' the data in your images for the relevant tags. |
Now select the photos on the left side where you want the information to be saved into. Note that Shift and Control works in selecting the photos. Once you have selected the images click the 'Save to selected images' button. |
Once the button 'Save to selected images' has been clicked you will see a message displayed describing which image is processed and a progress bar displaying the complete progress. |
5.7.2 After scanning: Correcting Date/time and Renaming workflow
The following workflow shows an example where (in this case) old diapositives out of 1977 were scanned. We start with the scanned images and the workflow is as follows:
- Set the datetime metatags (We don't know the exact the date so we estimate the date as precise as possible.)
- We set the file date based on the datetime metatags we have just set in the previous set.
- We rename the photos based on metadata tags and possible string (like the occasion, location or whatever you want to use to identify/classify the photos).
The following workflow consists of a mix-and-match of Mac OS X screens and Ubuntu Unity screens (the latter with Mac OS X windowing icon theme as I don't like Ubuntu Unity's default orange icons).
After you have loaded your image(s) and made your selection, you select the 'Modify Date/time' option by either right-clicking and selecting it from the context menu or from the Extra menu. |
Note: If you have a photo with the correct datetime tags, you can select it from your photo-selection, right-click that photo and select the option 'Select photo as reference for 'Extra' menu'. You can then use the copied data in a number of edit screens. It will remain available after a new 'load image(s)' session. |
Set the date and time in the 'ModifyDate' field to the correct date (In this case of old scanned photos as accurate as possible). When done click the 'Save' button. Note: If you did select a reference photo with correct datetime metadata tags, you can now use that data by checking the 'Use date and time from reference image'. It will immediately fill/update the three datetime fields. |
Right-click somewhere in your selection and select from the context-menu the option 'Set file date to DateTimeOriginal' or select that option from the 'Extra' menu. |
If you scanned your old photos, negatives or diapositives, your scanned images will get the file date time of the moment of scanning while your images itself are (most certainly) much older.This function will now take the 'exif:DateTimeOriginal' from the metadata datetime tags in your image(s) you just added in the previous step and use that as file date/time.Note: exiftool can go back as far as 01-01-1970 for file dates (metadata can be any date/time). If your images are from e.g. 26 December 1958 (mid day) you need to use the 'touch' function on linux/Mac OS X like 'touch -t 195812261200.00 name_of_image(s)' |
Renaming your photos requires that your photos must contain metadata as that is where exiftool renaming is based upon. Right-click somewhere in your image selection and select the option 'Rename photos' from the context menu or select that option from the 'Extra' menu. |
In this screen you can rename your photos based upon a selection from the main screen, or from an entire folder which you can select here. In this example workflow the renaming is based on the main screen selection so we leave the source folder empty. (Click the info button in this dialog for more info) |
6 Extra Menu
The extra menu gives a set of exiftool command options which will be explained in the following subsections.
6.1 Rename photos
Exiftool Gui Windows 10
The functionality of this screen is also partially described in the 5.6.2 After scanning: Correcting Date/time and Renaming workflow above.
The way of working is described in the last subsection of 5.6.2. = Selecting a source folder in this renaming screen. = What are the differences? |
6.2 Create args file(s)
Exiftool has the option to output information in the form of exiftool arguments. If you create an args file by exporting the information from your photo(s), you can use this args file as an 'exiftool commands' file to write to another (set of) photo(s). pyExifToolGUI (currently) only supports the creation of these args files. pyExifToolGUI can't use these files (yet) to write to other photos. |
6.3 Export metadata
Exiftool can export the metadata inside images to a number of output formats. From this popup screen you can export the metadata from your selected image(s) to files in these export formats. Note that per selected image an output (export) file is written (1 photo gives 1 export file). The only exception to this is the 'csv' format. The 'csv' format is an LibreOffice/OpenOffice/Excel compatible format which contains one row of metadata per image in one 'output.csv'file. Note also that the output files are written to the same folder as where the images are. |
6.4 Modify Date/time
As the popup mentions: This dialog gives you the option to modify the several date/time tags in the exif information like in the 'Edit->Exif' tab. It works on the images you selected in the main screen. This dialog gives you more date/time functionality (and only date/time functionality) compared to the exif->edit tab: You can use the 'shift above date/times' function to shift the date/time forward or backward (in the future or in the past) for the selected fields. This function also respects whether you selected the specific tag (field) to save or not, and also works on the selected images from the main screen. The corresponding xmp values can be updated at the same time. |
6.5 Set file date to DateTimeOriginal
If you modified your images in a 'sloppy' image editor or copied them around or whatever other action(s), the file date/time of your images might have changed to the date when you did your action/modification on the photo(s). In such a situation the real filedate(= creation date) of your images is (much) older. You might want to change the file date back to what it really should be based on the metadata when you took the photo. This 'Set file/date time to DateTimeOriginal' function will take the original date/time when the photo was taken from the exif:DateTimeOriginal and use that (again) as file date/time. |
6.6 Repair JPG(s) with corrupted metadata
As the popup on the left already mentions: If exiftool can't write to your photo it might be due to corrupted metadata. Exiftool can fix a lot of the metadata but only for the tags that are still readible. In a jpeg the image data is separated from the meta data. Exiftool will create a clean metadata structure and write as much metadata back to the metadata part of the JPG. |
6.7 Copy all metadata to xmp format
XMP stands for 'Extensible Metadata Platform', an XML/RDF-based metadata format which is being pushed by Adobe. Information in this format can be embedded in many different image file types including JPG, JP2, TIFF, GIF, EPS, PDF, PSD, IND, INX, PNG, DJVU, SVG, PGF, MIFF, XCF, CRW, DNG and a variety of proprietary TIFF-based RAW images, as well as in MOV, AVI, ASF, WMV, FLV, SWF and MP4 videos, but also in WMA and audio formats supporting ID3v2 information. XMP is a 'growing' and easy extensible metadata format and already incorporates a lot of EXIF and IPTC metadata. It also allows for software products to define their own set of XMP tags, like the Google photosphere, microsoft face recognition and Digikam xmp tags. |
6.8 Remove metadata
This function (on the left) is the most dangerous one of the program. Therefore it is one of the few functions using a second 'Are you sure?' popup (see below) and that's also why it makes a backup of your images by default. |
7 Your Commands
On this tab you can define your own parameters to 'send to' exiftool. The parameters will be executed on the images you have selected on the left.
You can both specify read parameters as well as write parameters but not in one command: write actions take precedence. You can also combine several parameters. Note: You don't need (must not) provide the exiftool command itself. The Gui will take care of that.
One thing YOU need to take care of is the use of either single quotes or double quotes around some commands. If you want to set the file date to the date the photo was taken, you need the command -FileModifyDate<DateTimeOriginal.On Windows you need to double-quote this and on Linux and Mac OS X you need to single-quote this, like
- Linux/Mac OS X: '-FileModifyDate<DateTimeOriginal'
- Windows: '-FileModifyDate<DateTimeOriginal'
| -exif:all | will display all exif tags for the selected images |
| -exif:all= | will remove(!) all exif tags from the selected images |
| -Exif:Artist='My Name' | Will put 'Your Name' into the selected images |
| -Xmp:City=Zwolle -Xmp:Country=Netherlands | Will write your city and country into the xmp tags of your image(s) |
8 Preferences
The Preferences tab gives you the option to select some defaults for this application.
ExifTool:
- Windows: You always have to specify where exiftool.exe is. Please rename exiftool(-k).exe to exiftool.exe. If you stick to exiftool(-k).exe the program will pause after every screen of output and wait for a key to continue. That will give problems in pyExifToolGUI (in any GUI for that matter).
- Linux and Mac OS X: The program will check for an installed exiftool in the standard program folders. If not found you have to specify where exiftool is. You can also use this option to specify a newer exiftool version then standard available for your distribution. At this moment most Linux distributions ship with some 8.xy exiftool version.
For the Gpano functionality you really need a version equal or newer then 9.07. See also '5.4 Edit GPano (Google Photosphere) data'.
Default values:
Exiftool Gui
These fields give you the option to specify your name (for example) and some copyright notice (for example: Spiderman (c) 2012).They can be copied into the relevant exif, xmp and iptc fields for these values.
Appendix A GNU Free Documentation License
Version 1.2, November 2002
- PREAMBLE
The purpose of this License is to make a manual, textbook, or otherfunctional and useful document free in the sense of freedom: toassure everyone the effective freedom to copy and redistribute it,with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a wayto get credit for their work, while not being considered responsiblefor modifications made by others.
This License is a kind of “copyleft”, which means that derivativeworks of the document must themselves be free in the same sense. Itcomplements the GNU General Public License, which is acopyleft license designed for free software.
We have designed this License in order to use it for manuals for freesoftware, because free software needs free documentation: a freeprogram should come with manuals providing the same freedoms that thesoftware does. But this License is not limited to software manuals;it can be used for any textual work, regardless of subject matter orwhether it is published as a printed book. We recommend this Licenseprincipally for works whose purpose is instruction or reference.
- APPLICABILITY AND DEFINITIONS
This License applies to any manual or other work, in any medium, thatcontains a notice placed by the copyright holder saying it can bedistributed under the terms of this License. Such a notice grants aworld-wide, royalty-free license, unlimited in duration, to use thatwork under the conditions stated herein. The “Document”, below,refers to any such manual or work. Any member of the public is alicensee, and is addressed as “you”. You accept the license if youcopy, modify or distribute the work in a way requiring permissionunder copyright law.
A “Modified Version” of the Document means any work containing theDocument or a portion of it, either copied verbatim, or withmodifications and/or translated into another language.
A “Secondary Section” is a named appendix or a front-matter sectionof the Document that deals exclusively with the relationship of thepublishers or authors of the Document to the Document's overallsubject (or to related matters) and contains nothing that could falldirectly within that overall subject. (Thus, if the Document is inpart a textbook of mathematics, a Secondary Section may not explainany mathematics.) The relationship could be a matter of historicalconnection with the subject or with related matters, or of legal,commercial, philosophical, ethical or political position regardingthem.
The “Invariant Sections” are certain Secondary Sections whose titlesare designated, as being those of Invariant Sections, in the noticethat says that the Document is released under this License. If asection does not fit the above definition of Secondary then it is notallowed to be designated as Invariant. The Document may contain zeroInvariant Sections. If the Document does not identify any InvariantSections then there are none.
The “Cover Texts” are certain short passages of text that arelisted, as Front-Cover Texts or Back-Cover Texts, in the notice thatsays that the Document is released under this License. A Front-CoverText may be at most 5 words, and a Back-Cover Text may be at most 25words.
A “Transparent” copy of the Document means a machine-readable copy,represented in a format whose specification is available to thegeneral public, that is suitable for revising the documentstraightforwardly with generic text editors or (for images composed ofpixels) generic paint programs or (for drawings) some widely availabledrawing editor, and that is suitable for input to text formatters orfor automatic translation to a variety of formats suitable for inputto text formatters. A copy made in an otherwise Transparent fileformat whose markup, or absence of markup, has been arranged to thwartor discourage subsequent modification by readers is not Transparent. An image format is not Transparent if used for any substantial amountof text. A copy that is not “Transparent” is called “Opaque”.
Examples of suitable formats for Transparent copies include plainascii without markup, Texinfo input format, LaTeX inputformat, SGML or XML using a publicly availableDTD, and standard-conforming simple HTML,PostScript or PDF designed for human modification. Examplesof transparent image formats include PNG, XCF andJPG. Opaque formats include proprietary formats that can beread and edited only by proprietary word processors, SGML orXML for which the DTD and/or processing tools arenot generally available, and the machine-generated HTML,PostScript or PDF produced by some word processors foroutput purposes only.
The “Title Page” means, for a printed book, the title page itself,plus such following pages as are needed to hold, legibly, the materialthis License requires to appear in the title page. For works informats which do not have any title page as such, “Title Page” meansthe text near the most prominent appearance of the work's title,preceding the beginning of the body of the text.
A section “Entitled XYZ” means a named subunit of the Document whosetitle either is precisely XYZ or contains XYZ in parentheses followingtext that translates XYZ in another language. (Here XYZ stands for aspecific section name mentioned below, such as “Acknowledgements”,“Dedications”, “Endorsements”, or “History”.) To “Preserve theTitle” of such a section when you modify the Document means that itremains a section “Entitled XYZ” according to this definition.
The Document may include Warranty Disclaimers next to the notice whichstates that this License applies to the Document. These WarrantyDisclaimers are considered to be included by reference in thisLicense, but only as regards disclaiming warranties: any otherimplication that these Warranty Disclaimers may have is void and hasno effect on the meaning of this License.
- VERBATIM COPYING
You may copy and distribute the Document in any medium, eithercommercially or noncommercially, provided that this License, thecopyright notices, and the license notice saying this License appliesto the Document are reproduced in all copies, and that you add noother conditions whatsoever to those of this License. You may not usetechnical measures to obstruct or control the reading or furthercopying of the copies you make or distribute. However, you may acceptcompensation in exchange for copies. If you distribute a large enoughnumber of copies you must also follow the conditions in section 3.
You may also lend copies, under the same conditions stated above, andyou may publicly display copies.
- COPYING IN QUANTITY
If you publish printed copies (or copies in media that commonly haveprinted covers) of the Document, numbering more than 100, and theDocument's license notice requires Cover Texts, you must enclose thecopies in covers that carry, clearly and legibly, all these CoverTexts: Front-Cover Texts on the front cover, and Back-Cover Texts onthe back cover. Both covers must also clearly and legibly identifyyou as the publisher of these copies. The front cover must presentthe full title with all words of the title equally prominent andvisible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preservethe title of the Document and satisfy these conditions, can be treatedas verbatim copying in other respects.
If the required texts for either cover are too voluminous to fitlegibly, you should put the first ones listed (as many as fitreasonably) on the actual cover, and continue the rest onto adjacentpages.
If you publish or distribute Opaque copies of the Document numberingmore than 100, you must either include a machine-readable Transparentcopy along with each Opaque copy, or state in or with each Opaque copya computer-network location from which the general network-usingpublic has access to download using public-standard network protocolsa complete Transparent copy of the Document, free of added material. If you use the latter option, you must take reasonably prudent steps,when you begin distribution of Opaque copies in quantity, to ensurethat this Transparent copy will remain thus accessible at the statedlocation until at least one year after the last time you distribute anOpaque copy (directly or through your agents or retailers) of thatedition to the public.
It is requested, but not required, that you contact the authors of theDocument well before redistributing any large number of copies, togive them a chance to provide you with an updated version of theDocument.
- MODIFICATIONS
You may copy and distribute a Modified Version of the Document underthe conditions of sections 2 and 3 above, provided that you releasethe Modified Version under precisely this License, with the ModifiedVersion filling the role of the Document, thus licensing distributionand modification of the Modified Version to whoever possesses a copyof it. In addition, you must do these things in the Modified Version:
- Use in the Title Page (and on the covers, if any) a title distinctfrom that of the Document, and from those of previous versions (whichshould, if there were any, be listed in the History section of theDocument). You may use the same title as a previous version if theoriginal publisher of that version gives permission.
- List on the Title Page, as authors, one or more persons or entitiesresponsible for authorship of the modifications in the ModifiedVersion, together with at least five of the principal authors of theDocument (all of its principal authors, if it has fewer than five),unless they release you from this requirement.
- State on the Title page the name of the publisher of the ModifiedVersion, as the publisher.
- Preserve all the copyright notices of the Document.
- Add an appropriate copyright notice for your modifications adjacent tothe other copyright notices.
- Include, immediately after the copyright notices, a license noticegiving the public permission to use the Modified Version under theterms of this License, in the form shown in the Addendum below.
- Preserve in that license notice the full lists of Invariant Sectionsand required Cover Texts given in the Document's license notice.
- Include an unaltered copy of this License.
- Preserve the section Entitled “History”, Preserve its Title, and addto it an item stating at least the title, year, new authors, andpublisher of the Modified Version as given on the Title Page. Ifthere is no section Entitled “History” in the Document, create onestating the title, year, authors, and publisher of the Document asgiven on its Title Page, then add an item describing the ModifiedVersion as stated in the previous sentence.
- Preserve the network location, if any, given in the Document forpublic access to a Transparent copy of the Document, and likewise thenetwork locations given in the Document for previous versions it wasbased on. These may be placed in the “History” section. You mayomit a network location for a work that was published at least fouryears before the Document itself, or if the original publisher of theversion it refers to gives permission.
- For any section Entitled “Acknowledgements” or “Dedications”,Preserve the Title of the section, and preserve in the section all thesubstance and tone of each of the contributor acknowledgements and/ordedications given therein.
- Preserve all the Invariant Sections of the Document, unaltered intheir text and in their titles. Section numbers or the equivalent arenot considered part of the section titles.
- Delete any section Entitled “Endorsements”. Such a section may notbe included in the Modified Version.
- Do not retitle any existing section to be Entitled “Endorsements” orto conflict in title with any Invariant Section.
- Preserve any Warranty Disclaimers.
If the Modified Version includes new front-matter sections orappendices that qualify as Secondary Sections and contain no materialcopied from the Document, you may at your option designate some or allof these sections as invariant. To do this, add their titles to thelist of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any other section titles.
You may add a section Entitled “Endorsements”, provided it containsnothing but endorsements of your Modified Version by variousparties—for example, statements of peer review or that the text hasbeen approved by an organization as the authoritative definition of astandard.
You may add a passage of up to five words as a Front-Cover Text, and apassage of up to 25 words as a Back-Cover Text, to the end of the listof Cover Texts in the Modified Version. Only one passage ofFront-Cover Text and one of Back-Cover Text may be added by (orthrough arrangements made by) any one entity. If the Document alreadyincludes a cover text for the same cover, previously added by you orby arrangement made by the same entity you are acting on behalf of,you may not add another; but you may replace the old one, on explicitpermission from the previous publisher that added the old one.
The author(s) and publisher(s) of the Document do not by this Licensegive permission to use their names for publicity for or to assert orimply endorsement of any Modified Version.
- COMBINING DOCUMENTS
You may combine the Document with other documents released under thisLicense, under the terms defined in section 4 above for modifiedversions, provided that you include in the combination all of theInvariant Sections of all of the original documents, unmodified, andlist them all as Invariant Sections of your combined work in itslicense notice, and that you preserve all their Warranty Disclaimers.
The combined work need only contain one copy of this License, andmultiple identical Invariant Sections may be replaced with a singlecopy. If there are multiple Invariant Sections with the same name butdifferent contents, make the title of each such section unique byadding at the end of it, in parentheses, the name of the originalauthor or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list ofInvariant Sections in the license notice of the combined work.
In the combination, you must combine any sections Entitled “History”in the various original documents, forming one section Entitled“History”; likewise combine any sections Entitled“Acknowledgements”, and any sections Entitled “Dedications”. Youmust delete all sections Entitled “Endorsements.”
- COLLECTIONS OF DOCUMENTS
You may make a collection consisting of the Document and otherdocuments released under this License, and replace the individualcopies of this License in the various documents with a single copythat is included in the collection, provided that you follow the rulesof this License for verbatim copying of each of the documents in allother respects.
You may extract a single document from such a collection, anddistribute it individually under this License, provided you insert acopy of this License into the extracted document, and follow thisLicense in all other respects regarding verbatim copying of thatdocument.
- AGGREGATION WITH INDEPENDENT WORKS
A compilation of the Document or its derivatives with other separateand independent documents or works, in or on a volume of a storage ordistribution medium, is called an “aggregate” if the copyrightresulting from the compilation is not used to limit the legal rightsof the compilation's users beyond what the individual works permit. When the Document is included in an aggregate, this License does notapply to the other works in the aggregate which are not themselvesderivative works of the Document.
If the Cover Text requirement of section 3 is applicable to thesecopies of the Document, then if the Document is less than one half ofthe entire aggregate, the Document's Cover Texts may be placed oncovers that bracket the Document within the aggregate, or theelectronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed covers that bracket the wholeaggregate.
- TRANSLATION
Translation is considered a kind of modification, so you maydistribute translations of the Document under the terms of section 4. Replacing Invariant Sections with translations requires specialpermission from their copyright holders, but you may includetranslations of some or all Invariant Sections in addition to theoriginal versions of these Invariant Sections. You may include atranslation of this License, and all the license notices in theDocument, and any Warranty Disclaimers, provided that you also includethe original English version of this License and the original versionsof those notices and disclaimers. In case of a disagreement betweenthe translation and the original version of this License or a noticeor disclaimer, the original version will prevail.
If a section in the Document is Entitled “Acknowledgements”,“Dedications”, or “History”, the requirement (section 4) toPreserve its Title (section 1) will typically require changing theactual title.
- TERMINATION
You may not copy, modify, sublicense, or distribute the Documentexcept as expressly provided for under this License. Any otherattempt to copy, modify, sublicense or distribute the Document isvoid, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you underthis License will not have their licenses terminated so long as suchparties remain in full compliance.
- FUTURE REVISIONS OF THIS LICENSE
The Free Software Foundation may publish new, revised versions of theGNU Free Documentation License from time to time. Such newversions will be similar in spirit to the present version, but maydiffer in detail to address new problems or concerns. Seehttp://www.gnu.org/copyleft/.
Each version of the License is given a distinguishing version number. If the Document specifies that a particular numbered version of thisLicense “or any later version” applies to it, you have the option offollowing the terms and conditions either of that specified version orof any later version that has been published (not as a draft) by theFree Software Foundation. If the Document does not specify a versionnumber of this License, you may choose any version ever published (notas a draft) by the Free Software Foundation.