eAtlas Image Metadata Editor Application - Tag photos with metadata
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
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.
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.
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.
Run the Image Metadata Editor
Double click the Image Metadata Editor icon to run the tool.
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".
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.
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.
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.
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.
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.
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..."
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.
You can quit the Image Metadata Editor for now.
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.
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".
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.
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.
Run the Image Metadata Editor again
Double click the Image Metatada Editor icon to re-launch the application.
Load the edited metadata CSV file
Drag and drop the edited CSV file in the Image Metadata Editor.
You will see all your image files, loaded back in the application.
Verify the values for a few images, if wanted
You can double click any files from the list to verify its metadata.
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".
The metadata get applied once you approve the confirmation window.
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.
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 firstname.lastname@example.org.
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.
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.
Copy the Image Metadata Editor in the folder that contains all image folders, and drag and drop them into the application.
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.