Created by Iain Ferguson, last modified on Oct 08, 2025

Image Addresses

All images in the archive have a unique address and name. The address corresponds to the date the image is stored under. For example, an image stored in 2021 with a month of 04 and a day of 13 would have an address of 2021-04-13. The image name will be unique for that day, such as 5167.png.

To fully address an image in the archive, the format would be <date address>/<image name>. In this case, it would be 2021-04-13/5167.png.

Address Scope

Address scope refers to the method of addressing a single image or a range of images. To select an image or multiple images in the archive, you need to use their image address, and for selecting multiple images, an address scope. Several commands require the address scope argument to specify a range of images in the archive.

Address scope in the form of two parts: the date and the filename/extention. these take the form:

<date>/<filename/extention>

These are then sub divided into:

  • The date <year>-<month>-<day>.

  • The filename <filename>.<extention>

So the full Address Scope will be:

<year>-<month>-<day>/<filename>.<extention>

for example:

2025-05-11/DSC89678.nef

This will

Wildcards

Wildcards are powerful tools in search templates. In ImgArchive, the asterisk (*) represents all values in any field within the scope.

Dates are formatted as <year>-<month>-<day>. For example, 2021-04-13 selects all images taken on April 13, 2021. To broaden the selection, the wildcard can be used to include any group in the address. For instance, "*-*-*" selects all images in the archive, while "2022-01-*" selects all images from January 2022.

Filenames and extentions are formatted as <filename>.<extention> however like dates, to broaden the selection, the wildcard can be used to include any group of filenames and extentions