Skip to content

Tags

You can tag photos with arbitrary tags. There is only basic support for tags right now, but they form a foundation for many other features.

WARNING

Tags are currently in an alpha state and can be volatile. They are not yet stored in the photos themselves, only in the "cache" database.

Tags needs to be enabled in the tags section of the configuration the server needs to be restarted.

yaml
tags:
  enable: true

Tagging Photos

If tags are enabled, the following features are shown.

  1. The photo view # (hash) button allows for editing tags.
  2. The photo view 🤍 (heart) button toggles the fav tag to serve as simple "liking" functionality.
  3. On the collection view, if you select photos, you can add tags to all selected photos at once using the # (hash) button in the toolbar.

Selection

You can select photos by holding Ctrl / Cmd and clicking on a photo or dragging to select.

INFO

Selections are stored as temporary tags that can be used for filtering or other operations.

You can filter photos in the collection by searching for tag:TAG.

For example, you can search for tag:fav to only show favorited photos, or tag:hello tag:world to only show photos with both hello and world tags. This is an early version of filtering and should be more user-friendly in the future.

See the search documentation for more on search.

EXIF

Automatically add tags from EXIF data.

The only EXIF tags are the currently hardcoded make and model, and they are added to the file as exif:make:<make> and exif:model:<model> tags respectively.

To enable the automatic addition of these tags, you need to enable it in the config.

yaml
tags:
  enable: true
  exif:
    enable: true