NAME

iptckeyword - List and manipulate the IPTC keyword metadata stored in an image file.

SYNOPSIS

iptckeyword [--list] args
iptckeyword --add | --set | --remove keyword[,keyword...] args
iptckeyword --match (keywords and booleans) args
iptckeyword --copy source_file args
iptckeyword --synonyms [--synfile file] args
iptckeyword --help | --man
(args can be files or directories)

DESCRIPTION

iptckeyword uses the Image::IPTCInfo module to list and/or manipulate the keyword information that can be stored in the IPTC headers of an image file. iptckeyword can add, set or remove keywords, or match a list of keywords in the list of files/directories given on the command line. It can also expand a list of keyword synonyms and assign those synonyms to files.

OPTIONS

--help

Print a brief help message and exits.

--man

Prints the manual page and exits.

--r

Allows directory recursion in the argument list. Without the -r flag,
iptckeyword will ignore any directories in the arg list.
Warning: this can be dangerous, especially adding, setting, or removing
keywords. You have been warned.

--list

Lists keywords. --list is assumed if no other options are given.
It can also be combined with other options, and will list the keywords after
any other operations (add, remove, etc) are performed.

--add

Adds given keywords to keywords already in the file(s).

--set

Sets keywords in file to exact list given on command line. Use --set '' to
clear the keywords in the file(s).

--remove

Removes given keywords from file. iptckeyword will not complain if the keyword
doesn't exist.

--copy

Copies keywords from file given as argument to --copy to any other file(s) 
specified.

--match

Matches keywords given against file(s) given. Uses Text::Query::ParseAdvanced
to parse the matchwords. This allows matches like 'horse and rider and not saddle'
or '(cougar or puma or mountain lion) and arizona'. Words separated by spaces are
considered to be part of the same phrase. Will match whole words only--however, 
one word from a multi-word phrase will match ('mount' wouldn't match the phrase
'mountain lion', but 'mountain' would). If you wish to avoid this behavior, use
underscores instead of spaces ('mountain_lion' instead of 'mountain lion').

--synonyms

Reads keywords in file(s) given on the command line, and looks in a synonyms file
for a list of synonym keywords to expand out. By default, the synonyms file is the
file .iptc_synonyms in your home directory.
The format of the synonyms file is:
keyword: other, keywords, that, the, first_keyword, expands to
A keyword can expand to another keyword that also has expansions. iptckeywords parses
them recursively, but avoids getting caught in a loop. For example:
patas: monkey, zoo
monkey: primate
primate: animal
So a file with the keyword of 'patas' will end up with patas, zoo, monkey, primate, and animal.
This is a powerful way of adding multiple keywords that iptckeyword (or other programs) can then
use to search by.

--synfile

Takes the argument of an alternative synonyms file when using the --synonyms switch.

AUTHOR

Paul Archer (paul at paularcher dot org)

DEPENDENCIES

Image::IPTCInfo, Getopt::Long, Pod::Usage, File::Finder, Text::Query

BUGS

Probably.

Text::Query::ParseAdvanced throws two warnings. You'll have to modify the subroutines that contain the offending lines by removing the prototyping info in order to get rid of the warnings.

LICENSE

iptckeyword is released under the GNU Public License (GPL).