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).