Application Guide#

This page describes how to use the main features of the Naturtag desktop application.

Typically there will be three steps:

  1. Select photos

  2. Select an observation or species

  3. Tag images

Note

Currently, the UI is meant for tagging one set of related photos at a time, but batch tagging features are planned for future updates.

Selecting Images#

The Photos tab is the main interface for selecting and tagging images:

Screenshot

To select images:

  • Drag & drop images or folders into the window

  • Select files with the Open button in the toolbar (or Ctrl+O)

Mouse actions:

  • Left-click an image for a fullscreen view

  • Middle-click an image to remove it

  • Right-click an image for a context menu with more actions:

Use the button in the toolbar (or Ctrl+Shift+X) to clear all selected images.

Screenshot

Selecting a Metadata Source#

Next, you will specify an observation or species to use as a metadata source There are a few ways to do this:

  • Paste an iNaturalist URL anywhere (with Ctrl+V or the Paste button from the toolbar)

  • Enter an iNaturalist observation ID or taxon ID

  • Use the Species Search page

Tagging Images#

Once you have selected images and a metadata source, click the Run button in the toolbar (or Ctrl+R) to generate and save image metadata.

Refreshing Metadata#

In many cases, you might upload an observation with only a rough identification (order, family, etc.), and later get a more specific (or corrected) ID on iNaturalist. In these cases, you can use the Refresh button in the toolbar (or F5) to quickly update all of your selected images that have been previously tagged. When using Refresh, you can select images for multiple observations and taxa.

Refresh has the following behavior depending on the metadata source:

  • For observations, this will update your image metadata with the latest observation details from iNaturalist, and fill in any additional missing information.

  • For taxa, this will update your image metadata with any missing taxonomy information (for example if an image has been tagged with only a taxon ID)

Note

If you would like to use a different tool to add taxon IDs to your photos, and then use Naturtag to fill in the rest of the details, you can add it as an EXIF or XMP keyword in the format:

taxon_id:12345

Keyboard Shortcuts#

Some keyboard shortcuts are included for convenience:

Key(s)

Action

Tab/Screen

Ctrl+O

Open file browser

Photos

Ctrl+V

Paste photos or iNat URLs

Photos

Ctrl+R

Run image tagger

Photos

Ctrl+Shift+X

Clear selected images

Photos

F5

Refresh photo metadata

Photos

Ctrl+Enter

Run search

Species

Alt+Left

View previous taxon

Species

Alt+Right

View next taxon

Species

Alt+Up

View parent taxon

Species

Left

View previous image

Fullscreen image (local photo or taxon)

Right

View next image

Fullscreen image (local photo or taxon)

Escape

Exit fullscreen view

Fullscreen image (local photo or taxon)

Del

Remove image from selection

Fullscreen image (local photo)

Ctrl+Tab

Cycle through tabs

All

Ctrl+Shift+F

Add a directory to favorites

All

Ctrl+Shift+T

Toggle toolbar visibility

All

F11

Toggle fullscreen

All

Ctrl+Q

Quit

All