tags

Synopsis

photohack tags images tags +/-tags

If no +/-tags are provided, this command prints the images selected by the images and tags. If tag names preceded by + are provided, then those tags are added to the selected images. If tag names preceded by – are provided, then those tags are removed from the selected images.

Description

This command is the primary one for setting tags on images, and for querying images based on their tags. Anywhere a tag appears (in most photohack commands), it selects all images that have that tag. Tags must start with a letter or underscore, and can contain numbers, letters, and underscores.

There are two special tags that are “predefined” by photohack:

all

All images

untagged

Images that have no tags

Examples

Print the tags in use in this album:

$ photohack tags

Print the images that have the “selected” tag:

$ photohack tags selected

Add the tag “selected” to images 12 and 17:

$ photohack tags 12 17 +selected

Remove the tag “friendly” from all images:

$ photohack tags friendly -friendly

Replace all occurrences of tag “friendly” with “portrait”

$ photohack tags friendly -friendly +portrait