Addon:Image Metadata Gramplet

From Gramps
Revision as of 22:23, 29 March 2010 by Robhealey1 (talk | contribs) (Added examples for using pyexiv2)
Jump to: navigation, search


This is a Third-party plugin. Please treat this as anything else of value to you, use carefully on data that is not backed up, and help make it better by reporting any comments or problems to the author.


Fig. Image Metadata Gramplet

Special Note: Before being able to use this gramplet/ addon, you will need to download and install [ pyexiv2 or install pyexiv2 from your local Linux repository. Windows user, there is an installer for you. Ubuntu, use the Universe repository to find pyexiv2.

The Image Metadata Gramplet offers an easy interface to add, edit, and remove Image Exif Metadata from your images (*.jpg, *.png. *.tiff, *.exv, *.nef, *.psd, *.pgf).

Once you have installed pyexiv2, see above for directions to download and install this addon...

Pyexiv2 can be used from the command line interface (cli) as well, and from within a python script:

  1. import the pyexiv2 library

from pyexiv2 import ImageMetadata, ExifTag

  1. specify your image

image = ImageMetadata("/home/user/image.jpg")

  1. read the image

image.read()

Exif, IPTC, XMP metadata reference tags can be found here:

Example:


image["Exif.Image.Artist"] # Artist
Smith and Johnson's Photography Studio

image["Exif.Image.DateTime"] # DateTime
1826 Apr 12 14:00:00

image["Exif.Image.DateTime"] = datetime.datetime.now() # Add DateTime

image.write() # write the Metadata

My perferred way to use this addon is:
1) install pyexiv2
2) Install this addon
3)) Install Split Views
4) Restart Gramps
5) Click on Split Views from the left-side Navigation Sidebar
6) Click Views from the Menu bar, and select Media Views
7) Close the right side View by clicking the X at the top left side
8) Slide the available empty right view to about half the screen.
9) Right click in the open space, and select Add a Gramplet
10) Select Image Metadata Gramplet
11) Select an image from the left hand MediaView

Data Fields

Photographer:
The name of the person or company taking the image

Select Date
Will bring up a calendar, and double-click on a date. The time will be filled in as the current time

Date
The Date/ Time needs to be typed in as a very specific format:
Year Mon Day Hour:Minutes:Seconds
11826 Apr 12 14:06:00

Copyright
Can be anything that you please... Ex: (C) 2010 Smith and Wesson

Subject
Please enter keywords that describe the picture. Do NOT add a space after the comma. Ex. : Census,Milwaukee,Oregon

Latitude/ Longitude
Latitude/ Longitude data can be entered in one of two ways:
1) Degrees Minutes Seconds Ex.: 10 59 14

In this format, you will need to select latitude reference, and longitude reference

If the Latitude begins with a negative number, select 'S' as Lat. Ref. or 'N' if a positive number. If the Longitude begins with a negative number, select 'W' as the Long. Ref. or 'E' if a positive number.

2) Decimal, Ex. : -34.15954

In this format, the Latitude and Longitude reference will be selected for you after you click Convert GPS Coordinates or press the Save button. For foreign countries that might use a ", " instead of a ".", please use the "."

Description
Type in something about the image, the people in it or the location of the image. Non-latin characters are NOT allowed. ASCII characters only...

Buttons

1) Save
Will write the metadata to the image, and convert latitude/ longitude if it is in decimal format.

2) Clear
Will clear all data fields

3) Convert GPS Coordinates
will convert Latitude/ Longitude if it is in decimal format

My favorite source for GPS Coordinates is: GPS Visualizer

--Rob 06:55, 29 March 2010 (UTC)