NAME

kimdbtokenmove - Moves kimdaba images from directory to directory

SYNOPSIS

 # lists all Categories in a kimdaba DB file

 % kimdbtokenmove -l -c index.xml
 Category names found in index.xml:
  Keywords
  Locations
  Persons
  Animals
  Events
  Folder
  Tokens

 # lists all values within a given category in a kimdaba DB file

 % kimdbtokenmove -L -c index.xml -C Events
 Values found in category "Events":
  Graduation
  Birthday
  Christmas
  Halloween
  Easter

 # moves all images tagged with 'Birthday' into one directory, and all
 # images tagged with 'Christmas' into another:

 % kimdbtokenmove -c index.xml -C Events \
     -m Birthday=birthdaydir,Christmas=christmasdir

 # the same thing, but only for files originally found in "subdir1"

 % kimdbtokenmove -c index.xml -C Events -p subdir1 \
     -m Birthday=birthdaydir,Christmas=christmasdir

 # the same thing, but only for files that don't contain "dontmove" in
 # the name or path to it.

 % kimdbtokenmove -c index.xml -C Events -p subdir1 -r dontmove \
     -m Birthday=birthdaydir,Christmas=christmasdir

-c KIMDB: The kimdaba database file to look at and modify.
-m tag1=dir1,tag2=dir2,...: The move specifications. Images tagged with tag1 are moved into dir1, etc. A special keyword of "none" means move it if no tags exist for it. If a '-' sign is prepended to a tag, a file is only moved if it does not contain that tag.
-C CATEGORY: The category that the tags in the -m flag should match in. This defaults to 'Tokens'.
-l: List categories found in a kimdaba db file (eg index.xml)
-L: List values found in a given category in a kimdaba db file (eg index.xml). You should specify the category using the -C switch.
-p PATHREGEX: Only consider moving files matching the PATHREGEX.
-r PATHREGEX: Ignore any file matching PATHREGEX
-v: Verbose mode
-n: Don't actually do anything. Useful with the -v flag to verify it's going to do what you want.
-h: Usage information.