NAME

       pictor-unload  -  unload  pictures from a SOURCE removable media to DESTINATION directory,
       and rename each file, prepending the timestamp

SYNOPSIS

       pictor-unload SOURCE DESTINATION

DESCRIPTION

       The  pictor-unload  utility  is  useful  for  unloading  pictures  from  removable  media,
       collating, and interleaving them with other pictures.

       The tool takes two arguments, the SOURCE directory, and the DESTINATION directory.

       Each file in the SOURCE directory is copied (preserving all attributes) to the DESTINATION
       directory.  At the destination, the file is renamed, prepending a timestamp in the form of
       "YYYY-MM-DD_HH:MM:SS__"  to  the  beginning of the filename.  The timestamp is taken to be
       that of the file's original modification time, as determined by the  stat(1)  utility.   A
       "double-underscore",  ie,  "__"  separates the timestamp from the original filename.  File
       permissions at the destination are also adjusted, removing the  executable  bit  which  is
       typically set in the source, since the source is usually a VFAT filesystem.

       If  you  perfectly  synchronize the embedded clock on each of several cameras, you can use
       pictor-unload to conveniently combine and interleave pictures from these cameras.

       The SOURCE directory is renamed, appending the  current  timestamp  to  the  folder,  thus
       noting  "when"  these  pictures were unloaded.  Your camera will create a new directory on
       the media when you take a new picture.  pictor-unload assumes that it is  your  right  and
       responsibility to delete pictures from the media or reformat the card.

       Finally,  if  the source directory is in /media, then you are prompted, asking if you want
       to unmount the source filesystem.  Note  that  this  will  required  root  privileges  via
       sudo(8).

SEE ALSO

       stat(1), sudo(8)

AUTHOR

       This  manpage and the utility were written by Dustin Kirkland <kirkland@canonical.com> for
       Ubuntu systems (but may be used by others).  Permission is  granted  to  copy,  distribute
       and/or  modify  this document under the terms of the GNU General Public License, Version 3
       published by the Free Software Foundation.

       On Debian systems, the complete text of the GNU General Public License  can  be  found  in
       /usr/share/common-licenses/GPL.