Difference between revisions of "Addon:Edit Image Exif Metadata"

From Gramps
Jump to: navigation, search
m
(43 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
{{Third-party plugin}}
 
{{Third-party plugin}}
{{man note|Was originally included in Gramps 3 and earlier}}
+
{{man note|Edit Exif Metadata|was originally included in [[Gramps_3.4_Wiki_Manual_-_Gramplets#Image_Metadata|Gramps 3.4.x and earlier]]}}
{{man warn|Gramplet does nt work.|Needs converting from pyexiv2 to GExiv2 see: {{bug|6606}}}}
+
[[File:EditExifMetadata-Gramplet-detached-example-51.png|thumb|right|450px|Edit Exif Metadata Gramplet - detached example]]
{{stub}}<!-- image is not of this gramplet-->
+
[[File:EditExifMetadata-Gramplet-edit-dialog-example-51.png|thumb|right|450px|Edit Exif Metadata Gramplet - Edit dialog example]]
<!--[[File:ImageMetadata-Gramplet-detached-50.png|thumb|right|400px|Fig. Image Metadata Gramplet]]-->
+
The {{man label|Edit Exif Metadata}} Gramplet offers an easy interface to add, edit, and remove Image [https://wikipedia.org/wiki/Exif Exif (Exchangeable image file format) Metadata] from your images (*.jpg, *.png. *.tiff, *.exv, *.nef, *.psd, *.pgf).
The {{man label|Edit (Image) Exif Metadata}} Gramplet offers an easy interface to add, edit, and remove Image Exif Metadata from your images (*.jpg, *.png. *.tiff, *.exv, *.nef, *.psd, *.pgf).
 
  
See also the builtin:
+
See also the built-in:
 
* [[Gramps_{{Version manual}}_Wiki_Manual_-_Gramplets#Image_Metadata|Image Metadata Gramplet]] that only displays the Exif information.
 
* [[Gramps_{{Version manual}}_Wiki_Manual_-_Gramplets#Image_Metadata|Image Metadata Gramplet]] that only displays the Exif information.
{{-}}
 
  
 
==Usage==
 
==Usage==
# Click Views from the Menu bar, and select Media Views
+
 
# Right click in the open space, and select Add a Gramplet
+
===Add the gramplet===
# Select Image Metadata Gramplet
+
* Initially needs to be added as a Gramplet in the Media List View category, either on bottom bar or on the side bar. Click {{man menu|Views}} from the Menu bar, and select {{man menu|Media Views}}
# Select an image from the left hand MediaView
+
* Select {{man label|Edit Exif Metadata}} Gramplet  
 +
 
 +
===General usage===
 +
* Select an image from the {{man label|{{icon|medi}}[[Gramps_{{man version}}_Wiki_Manual_-_Categories#Media_List_View|Media List View]]}} to edit its Exif  Metadata.
  
 
==The interface==
 
==The interface==
 +
===Summary section===
 +
The top section displays a summary of the selected media object. Typically the filename, file type and image dimensions.
 +
 +
===Buttons===
 +
* {{man button|Thumbnail}} - will produce a popup showing the thumbnail.
 +
* {{man button|<-- Image Types --> V}} - Select from a drop- down box the image file type that you would like to convert your non- Exiv2 compatible media object to.
 +
* {{man button|Convert}} - If your image is not of an image type that can have Exif metadata read/written to/from, convert it to a type that can?
 +
* {{man button|Help}} - brings your to this page.
 +
* {{man button|Edit}} - This will open up a new window to allow you to edit/modify this images's Exif metadata. It will also allow you to be able to Save the modified metadata.
 +
** {{man button|Save}} - Will write the metadata to the image, and convert latitude/longitude if it is in decimal format.
 +
** {{man button|Clear}} - Will clear all data fields
 +
** {{man button|Copy}}
 +
** {{man button|Close}}
 +
* {{man button|Clear GPS}} - coordinates
 +
* {{man button|Delete}} - WARNING: This will completely erase all Exif metadata from this image! Are you sure you want to do this?
 +
 
===Data Fields===
 
===Data Fields===
  
Photographer:
+
;Photographer:
 
:The name of the person or company taking the image
 
:The name of the person or company taking the image
  
Select Date
+
;Select Date
 
:Will bring up a calendar, and double-click on a date. The time will be filled in as the current time<br>
 
:Will bring up a calendar, and double-click on a date. The time will be filled in as the current time<br>
  
Date
+
;Date
:The Date/ Time 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 24Hour:Minutes:Seconds<br>
:11826 Apr 12 14:06:00<br>
+
:e.g.: <code>1826 Apr 12 14:06:00</code><br>
  
Copyright
+
;Copyright
:Can be anything that you please... Ex: (C) 2010 Smith and Wesson<br>
+
:Can be anything that you please... <br />e.g.: <code>(C) 2010 Smith and Wesson</code> <br>
  
Subject
+
;Subject
:Please enter keywords that describe the picture.  Do NOT add a space after the comma. Ex. : Census,Milwaukee,Oregon
+
:Please enter keywords that describe the picture.  (Do NOT add spaces after commas.)<br />e.g.: <code>Census,Milwaukee,Oregon</code>
  
Latitude/ Longitude
+
;Latitude/Longitude
:Latitude/ Longitude data can be entered in one of two ways:<br>
+
:Latitude/Longitude data can be entered in one of two ways:<br>
:# Degrees Minutes Seconds Ex.: 10 59 14
+
:# Degrees Minutes Seconds<br />e.g.: <code>83 59 14</code>
:#:In this format, you will need to select latitude reference, and longitude reference<br>
+
:#:In this format, you will need to select cardinal direction Latitudinal reference, and longitudinal 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' (South) as Latitudinal Reference or 'N' (North) if a positive number.  If the Longitude begins with a negative number, select 'W' (West) as the Longitudinal Reference or 'E' (East) if a positive number.
:# Decimal, Ex. : -34.15954
+
:# Decimal<br />e.g.: <code>-34.15954</code>
 
:#: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  Coordinates or press the Save button.  For foreign countries that might use a ", " instead of a ".", please use the "."
  
Description
+
;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...
 
: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===
+
==Prerequisites==
 +
{{man tip|Special Note|Before being able to use this Gramplet/Addon, you will need to download and install [https://wiki.gnome.org/Projects/gexiv2 gexiv2]<br>or install gexiv2 from your local Linux repository.<br>MS-Windows users, this is depends on which installer you used.<br>Ubuntu, use the Universe repository to find gexiv2.'''<br>Also see [[GEPS_029:_GTK3-GObject_introspection_Conversion#GExiv2_for_Image_metadata|GExiv2 for Image metadata]]}}
  
#{{man button|Save}}
+
Once you have installed gexiv2, see above for directions to download and install this addon...
#:Will write the metadata to the image, and convert latitude/ longitude if it is in decimal format.
 
#{{man button|Clear}}
 
#:Will clear all data fields
 
#{{man button|Convert GPS Coordinates}}
 
#:will convert Latitude/ Longitude if it is in decimal format
 
  
My favorite source for GPS Coordinates is: [http://www.gpsvisualizer.com/geocode GPS Visualizer]
 
  
==Prerequisites==
+
{{stub}}
{{man note|Special Note:|Before being able to use this gramplet/ addon, you will need to download and install [http://tilloy.net/dev/pyexiv2/ pyexiv2] or install pyexiv2 from your local Linux repository.  Windows user, there is an installer for you.  Ubuntu, use the Universe repository to find python-pyexiv2.}}
+
{{man note|Special Note:|Before being able to use this addon gramplet, you will need to download and install [http://tilloy.net/dev/pyexiv2/ pyexiv2] or install pyexiv2 from your local Linux repository.  Windows user, there is an installer for you.  Ubuntu, use the Universe repository to find python-pyexiv2.}}
  
 
Once you have installed pyexiv2, see above for directions to download and install this addon...
 
Once you have installed pyexiv2, see above for directions to download and install this addon...
Line 92: Line 104:
 
** <code>2018-04-02 10:33:07.872: WARNING: _manager.py: line 295: Plugin error (from 'editexifmetadata'): No module named 'pyexiv2'</code>
 
** <code>2018-04-02 10:33:07.872: WARNING: _manager.py: line 295: Plugin error (from 'editexifmetadata'): No module named 'pyexiv2'</code>
  
 +
==See also==
 +
* [[Gramps_{{man version}}_Wiki_Manual_-_Gramplets#Image_Metadata|Image Metadata]] - built-in Gramplet to view [https://ewikipedia.org/wiki/Exchangeable_image_file_format Exchangeable Image Format (Exif) Metadata]
 +
* [[Addon:MediaReport|Media Report]] - Gramps "Report" addon by Matthias Kemmer
 +
* [[Addon:Photo_Tagging_Gramplet|Photo Tagging]] - Gramps "Gramplet" addon
 +
* [[Addon:Edit Image Exif Metadata|Edit Image Exif Metadata]] - Gramps "Gramplet" addon
 +
 +
* [https://wiki.gnome.org/Projects/gexiv2 gexiv2] - GObject wrapper around the Exiv2 photo metadata library (a prerequisite for the '''Image Metadata''' Gramplet)
 +
* Family History Metadata Working Group ([https://github.com/fhmwg GitHub repository], [https://www.facebook.com/groups/3798831010168985 Facebook], [https://www.linkedin.com/groups/12468534/ LinkedIn] [https://fhmwg.wordpress.com/ Website])
 +
** Metadata Standards v1.0 ([https://docs.google.com/presentation/d/1gVhyERiZHFWpOUZaohUNqDSqb1V8WiTjir0xz3hhgCY/edit?fbclid=IwAR2zKBWuOpfvEic3kRA-jIbTBLQ_Y3rllfA2LZM9v9eGFeAVJPPFxLwMTVc#slide=id.g6d58486565_1_15 Exec Summary])
 +
** Metadata Standards v1.0 ([https://github.com/fhmwg/current-tags/blob/master/stage1-overview.md Technical Summary])
 +
** Metadata Standards v1.0 ([https://github.com/fhmwg/current-tags/blob/master/stage1.md Full Normative Specification])
 +
* [https://www.loc.gov/standards/mix/ NISO Metadata for Images in XML (NISO MIX)]
  
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]
 
[[Category:Gramplets]]
 
[[Category:Gramplets]]

Revision as of 00:31, 31 January 2022

Gramps-notes.png

Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager.

Gramps-notes.png
Edit Exif Metadata

was originally included in Gramps 3.4.x and earlier

Edit Exif Metadata Gramplet - detached example
Edit Exif Metadata Gramplet - Edit dialog example

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

See also the built-in:

Usage

Add the gramplet

  • Initially needs to be added as a Gramplet in the Media List View category, either on bottom bar or on the side bar. Click Views from the Menu bar, and select Media Views
  • Select Edit Exif Metadata Gramplet

General usage

The interface

Summary section

The top section displays a summary of the selected media object. Typically the filename, file type and image dimensions.

Buttons

  • Thumbnail - will produce a popup showing the thumbnail.
  • <-- Image Types --> V - Select from a drop- down box the image file type that you would like to convert your non- Exiv2 compatible media object to.
  • Convert - If your image is not of an image type that can have Exif metadata read/written to/from, convert it to a type that can?
  • Help - brings your to this page.
  • Edit - This will open up a new window to allow you to edit/modify this images's Exif metadata. It will also allow you to be able to Save the modified metadata.
    • Save - Will write the metadata to the image, and convert latitude/longitude if it is in decimal format.
    • Clear - Will clear all data fields
    • Copy
    • Close
  • Clear GPS - coordinates
  • Delete - WARNING: This will completely erase all Exif metadata from this image! Are you sure you want to do this?

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 24Hour:Minutes:Seconds
e.g.: 1826 Apr 12 14:06:00
Copyright
Can be anything that you please...
e.g.: (C) 2010 Smith and Wesson
Subject
Please enter keywords that describe the picture. (Do NOT add spaces after commas.)
e.g.: Census,Milwaukee,Oregon
Latitude/Longitude
Latitude/Longitude data can be entered in one of two ways:
  1. Degrees Minutes Seconds
    e.g.: 83 59 14
    In this format, you will need to select cardinal direction Latitudinal reference, and longitudinal reference
    If the Latitude begins with a negative number, select 'S' (South) as Latitudinal Reference or 'N' (North) if a positive number. If the Longitude begins with a negative number, select 'W' (West) as the Longitudinal Reference or 'E' (East) if a positive number.
  2. Decimal
    e.g.: -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...

Prerequisites

Tango-Dialog-information.png
Special Note

Before being able to use this Gramplet/Addon, you will need to download and install gexiv2
or install gexiv2 from your local Linux repository.
MS-Windows users, this is depends on which installer you used.
Ubuntu, use the Universe repository to find gexiv2.
Also see GExiv2 for Image metadata


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


Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.


Gramps-notes.png
Special Note:

Before being able to use this addon gramplet, 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 python-pyexiv2.

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
  2. specify your image
    image = ImageMetadata("/home/user/image.jpg")
  3. 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

Issues

  • 6606 Gramplet does not work ( Needs converting from pyexiv2 to GExiv2. (Was originally included in Gramps 3 and earlier) )
    • 2018-04-02 10:33:07.872: WARNING: _manager.py: line 295: Plugin error (from 'editexifmetadata'): No module named 'pyexiv2'

See also