Difference between revisions of "Addon:Image Metadata Gramplet"

From Gramps
Jump to: navigation, search
(Re-write Wiki Page to make it better than it has been before!)
Line 8: Line 8:
 
[[Image:Image_Metadata_Gramplet.gif|thumb|right|150px|Fig. Image Metadata Gramplet]]
 
[[Image:Image_Metadata_Gramplet.gif|thumb|right|150px|Fig. Image Metadata Gramplet]]
  
'''Special Note: Before being able to use this gramplet/ addon, you will need to download and install pyexiv2 from its[http://tilloy.net/dev/pyexiv2/ website] or install pyexiv2 from your local Linux repository.'''<br><br>
+
    * '''''Special Note: Before being able to use this gramplet/ addon, you will need to download and install pyexiv2 from its [http://tilloy.net/dev/pyexiv2/ website] or install pyexiv2 from your local Linux repository. Windows user, there is an installer for you.'''''<br><br>
  
Windows Users<br>
+
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).
<hr>
 
Following my work on cross compiling pyexiv2 for windows on linux, I just merged in the master branch an NSIS script that generates a windows installer. This will allow distributing pyexiv2 in a user-friendly manner.
 
  
For those interested, the cross compilation and build of the installer processes are fully documented in the developers documentation (not published yet, see http://bazaar.launchpad.net/~osomon/pyexiv2/pyexiv2-0.2/annotate/head%3A/doc/developers.rst).
+
Once you have installed pyexiv2, see above for directions to download and install this addon...
  
*** NOTE: For those interested in the cross-compilation process itself for windows using linux, the script I used is at:  
+
My perferred way to use this addon is:
[http://tilloy.net/cross_compile_pyexiv2.sh cross_compile_pyexiv2.sh] .  I used linux to compile this one...<br>
+
1) install pyexiv2
 
+
2) Install this addon
The Image Metadata Gramplet offers an easy interface to add, edit, and remove Image Exif Metadata from your images.
+
3)) Install [http://www.gramps-project.org/wiki/index.php?title=Split_Views Split Views ]
 
+
4) Restart Gramps
'''''Option One'''''<br>
+
5) Click on Split Views from the left-side Navigation Sidebar
To use this addon/ gramplet, you will need to first download and install it from the directions on the 3.2 Addons page.
+
6) Click Views from the Menu bar, and select Media Views
 
+
7) Close the right side Views by clicking the X
1) Select Gramplets on your sidebar<br>
+
8) Slide the available empty right view to about half the screen.
2) In an open space, click right mouse button<br>
+
9) Right click in the open space, and select Add a gramplet
3) Select add a gramplet, click on Image Metadata Gramplet<br>
+
10) Select Image Metadata Gramplet
Now you will see it on the GrampletView from the sidebar.
+
11) Select an image from the left hand Media View
 
 
To add, edit, or remove image Metadata, there are two ways to do it: <br>
 
'''Number One:'''<br>
 
1) Select Media from your sidebar<br>
 
2) Click on an image from the database<br>
 
3) Select Gramplets on the sidebar<br>
 
 
 
'''Number Two:'''<br>
 
1) Select Gramplets from the sidebar<br>
 
2) Add Image Metadata Gramplet to the view from the steps above<br>
 
3) Click the detach button<br>
 
4) Select media from the sidebar, and the Image Metadata Gramplet will be hanging in mid air.<br>
 
5) Select an image<br>
 
 
 
'''''Option Two'''''<br>
 
1) Download and install SplitView from the 3.2 Addons Page<br>
 
2) Click on SplitView<br>
 
3) in the open pane, click right mouse button<br>
 
4) select Image Metadata Gramplet<br>
 
5) Click View on the Menu bar<br>
 
6) Select MediaView<br>
 
  
 
'''Data Fields'''<br>
 
'''Data Fields'''<br>
Line 59: Line 36:
  
 
Date<br>
 
Date<br>
The DateTime needs to be typed in as a very specific format:<br>
+
The Date/ Time needs to be typed in as a very specific format:<br>
 
Year Mon Day Hour:Minutes:Seconds<br>
 
Year Mon Day Hour:Minutes:Seconds<br>
1969 Oct 01 14:06:00<br>
+
11826 Apr 12 14:06:00<br>
  
 
Copyright<br>
 
Copyright<br>
 
Can be anything that you please... Ex: (C) 2010 Smith and Wesson<br>
 
Can be anything that you please... Ex: (C) 2010 Smith and Wesson<br>
 +
 +
Subject<br>
 +
Please enter keywords that describe the picture.  Do NOT add a space after the comma. Ex. : Census,Milwaukee,Oregon
  
 
Latitude/ Longitude<br>
 
Latitude/ Longitude<br>
 
Latitude/ Longitude data can be entered in one of two ways:<br>
 
Latitude/ Longitude data can be entered in one of two ways:<br>
1) Degrees Minutes Seconds<br>
+
1) Degrees Minutes Seconds Ex.: 10 59 14<br>
a) 47 9 15<br>
+
 
b) 122 6 31<br>
+
  * In this format, you will need to select latitude reference, and longitude reference<br>
In this format, you will need to select latitude reference, and longitude reference<br>
 
 
** 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.
 
** 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<br>
+
2) Decimal, Ex. : -34.15954<br>
a) -34.154180<br>
+
 
b) 84.108620<br>
+
    * 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 .
In this format, the Latitude and Longitude reference will be selected for you after you click Convert GPS or Save button.
 
  
 
Description<br>
 
Description<br>
Type in something about the image, the people in it or the location of the image.
+
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 '''<br>
 
'''Buttons '''<br>
Line 90: Line 68:
 
Will clear all data fields
 
Will clear all data fields
  
3) Convert GPS<br>
+
3) Convert GPS Coordinates<br>
 
will convert Latitude/ Longitude if it is in decimal format
 
will convert Latitude/ Longitude if it is in decimal format
  
My favorite source for GPS Coordinates: [http://www.gpsvisualizer.com/geocode GPS Visualizer ]
+
My favorite source for GPS Coordinates is: [http://www.gpsvisualizer.com/geocode GPS Visualizer]
 
 
You can download this plugin by following the directions at [[3.2_Addons]].
 
  
 
<br clear="all"/>
 
<br clear="all"/>

Revision as of 06:51, 29 March 2010


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.


File:Image Metadata Gramplet.gif
Fig. Image Metadata Gramplet
   * Special Note: Before being able to use this gramplet/ addon, you will need to download and install pyexiv2 from its website or install pyexiv2 from your local Linux repository.  Windows user, there is an installer for you.

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...

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 Views by clicking the X 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 Media View

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