eAtlas Image Metadata Editor Application - Tag photos with metadata

Download Button
Version 0.8.1 - 18/05/2015

The eAtlas Image Metadata Editor application is a Java program that allows information about the photos, such as title, description, attribution, location, etc., to be recorded and saved in the images themselves. When these images are then uploaded to the eAtlas this metadata is then maintained and displayed on the site. A web page is created for each image using the metadata added to the photo by the Image Metadata Editor. This application is intended to be used by eAtlas content administrators and those wishing to submit lots of photos to the eAtlas.

The metadata is recorded in the photo files themselves and so this information is maintained when they are copied across computers.

The eAtlas Image Metadata Editor application allows the metadata to be edited for individual images or handled in bulk by using its Export EXIF to CSV and Import EXIF from CSV.

Note: The Image Metadata Editor can only attach metadata to JPEG images, not PNG or PDFs. If you have a bunch of PNGs to submit then you can convert these to JPEGs using a bulk convertion tool as part of the Image Metadata Editor.

How to use the Image Metadata Editor tool

  1. Install Java
    The Image Metadata Editor is a Java FX application. You will need Java 7 or higher to be able to run it. Please, visit Oracle website to install a recent version of Java if you don't already have it installed.

  2. Make a backup of your images
    The Image Metadata Editor is very stable and reliable. But, as any other programs, it may happen to fail during its execution, which may lead to file corruption. Even if this is very unlikely, it's preferable to create a backup of your images before modifying their metadata.

  3. Download the Image Metadata Editor tool
    Save the Jar file to a convenient place to later run the application. The tool is easier to use when it's located in the same folder as the images. Copy the tool inside the folder containing the images. The tool does not need any installation. It should run directly if Java is installed.

    Where to copy the Image Metadata Editor
  4. Run the Image Metadata Editor
    Double click the Image Metadata Editor icon to run the tool.

    Execution the Image Metadata Editor

    If it doesn't run, try to "Right-click" it and select the option "Open width...". Windows should offer you the option to open the tool using "Java".

    Execution the Image Metadata Editor manually

    If this option is not listed, you will have to install Java (Step 1).
    NOTE: The Image Metadata Editor tool is safe to use. It does not install any files on your computer and does not share any personal information over the internet.

  5. Load your images in the tool (Note: JPEGs only, use conversion tool for PNGs, see below)
    Simply "Drag and drop" all your images in the center of the application.

    Loading images in the Image Metadata Editor
    >
    Images loaded in the Image Metadata Editor

    NOTE: Only JPEG images has support for EXIF metadata. If you wish to submit PNG or GIF images then the editor has a bulk conversion tool. See the section on converting PNG images below. For PDF, etc., please use the e-Atlas Image Submission Form.

  6. Edit the images metadata
    You can either edit the metadata of each images one by one, or export the metadata as a CSV file that you can edit using a spreadsheet editor. To edit the image metadata individually, simply double click a file from the list. Edit the metadata, and apply them to the image using the save button to the bottom right corner.

    Editing the metadata of an image using the Image Metadata Editor
  7. Edit all images metadata in bulk (CSV)
    If you have many images to edit, exporting the metadata as CSV is probably a better idea. It may save you considerable time, especially if some metadata are the same for each images, like the photographer for example.

  8. ​Export as CSV
    After loading all your image in the Image Metadata Editor, go to the "Import / Export" menu and choose "Export EXIF to CSV..."

    Exporting images metadata using the Image Metadata Editor

    Choose a name for the file, using the "csv" extension. For example: "metadata.csv". Save the file in the same folder as the Image Metadata Editor tool. The location of the CSV file is important, it will determine the starting point for the file path of every images.

    Exporting images metadata using the Image Metadata Editor

    You can quit the Image Metadata Editor for now.

    Closing the Image Metadata Editor
  9. Open the CSV file using a spreadsheet editor such as Excel or LibreOffice
    Double click the "csv" file saved in the previous step. It should open using your default spreadsheet editor.

    Metadata CSV file

    If you do not already have a spreadsheet editor installed, you will need to install one. We suggest you to install LibreOffice, because it is free and easy to install.
    LibreOffice official website
    Once it's installed, open the CSV file using LibreOffice. Ensure that you only have "Comma" selected in the "Selector options".

    Loading a CSV file in LibreOffice
  10. Edit the metadata
    Add the metadata in the spreadsheet. Each column has a description to which tells you what information expect. You can add columns if you desire, but don't reuse the existing column names. These extra columns can be used to bring in additional data that is used in spreadsheet forumulas to generate the metadata for the photo. These extra columns are ignored by the Image Metadata Editor

    Editing images metadata in LibreOffice

    When you are done, same the file. If you have used spreadsheet formulas then save it as both a native spreadsheet file (.xls for example) then also save it as a CSV file. The spreadsheet file will remember the formulas and the CSV file is what is needed by the Image Metadata Editor.

  11. Run the Image Metadata Editor again
    Double click the Image Metatada Editor icon to re-launch the application.

    Selecting the Image Metadata Editor
  12. Load the edited metadata CSV file
    Drag and drop the edited CSV file in the Image Metadata Editor.

    Loading a CSV file in the Image Metadata Editor

    You will see all your image files, loaded back in the application.

    CSV file loaded in the Image Metadata Editor
  13. Verify the values for a few images, if wanted
    You can double click any files from the list to verify its metadata.

    Editing the metadata of an image using the Image Metadata Editor
  14. Apply the modifications to the images
    When you are satisfy with the result, apply all the metadata to the images using the "File" menu, "Save EXIF to images".

    Saving images metadata from the Image Metadata Editor

    The metadata get applied once you approve the confirmation window.

    Comfirming before saving images metadata from the Image Metadata Editor
  15. Organise into Galleries
    If you wish your photos to be organised into galleries on the eAtlas then please organise the photos into folders, each corresponding to a gallery. When you submit these files please provide a text description (a paragraph) to outline what the gallery contains. This text can simply be provided in the email to the eAtlas team.

  16. Submit the photos to the eAtlas.
    Now that the photos have been tagged with metadata they are ready to be submitted to the eAtlas. These can be sent to the eAtlas using email (if the total size is less than approximately 30MB), by using Dropbox or Cloudstor+. If you use the cloud storage options then simply share the files with e-atlas@aims.gov.au.

    If you want the photos to be organised into galleries please include the description of each gallery.

    Upon receiving the images the eAtlas team will check the metadata associated with the images to ensure that key attributes have been set, then they will upload each folder as a gallery in the system, associating the photos with the project that provided the images.

Notes

The Image Metadata Editor supports complex folder structures.

The example used in this document is very simple. Generaly, we tend to organise our images in folders, creating more complex structure. The Image Metadata Editor can also support those more complex structures.

Loading a complex folder structure in the Image Metadata Editor

Copy the Image Metadata Editor in the folder that contains all image folders, and drag and drop them into the application.

Loading a complex folder structure in the Image Metadata Editor
>
Complex folder structure loaded in the Image Metadata Editor

Just follow the guide from step 7. Edit the images metadata.

How to convert PNGs to JPEGs

Since the Image Metadata Editor can only store the metadata in JPEGs we added a conversion tool that takes other file image types such as PNG and GIF and converts them to JPEGs. JPEG is a lossy file format that does not support transparency like PNG and GIFs and so the conversion is not lossless. As a result this conversion process may not be suitable for all types of imagery. If however the aim is to get PNG maps up on the eAtlas then this conversion will work just fine.

To start the the conversion tool select the Tools/Convert image files to JPEG menu item.

This will bring up the tool. It can be used to convert many files and can convert an entire directory tree of images.

After you have converted the images to JPEG you can then follow the steps above to attach metadata to the images.

How does the Image Metadata Editor work?

The eAtlas Image Metadata Editor application stores the metadata in the image itself using EXIF fields. This way the information will stay with the image as it is copied from computer to computer. The EXIF information can also be read from Windows and other photo applications.

Photo Metadata In Exif Windows Explorer
AttachmentSize
ImageMetadataEditor-0.8.1-jfx.jar914.87 KB