xenial (1) pecomato.1.gz

Provided by: pecomato_0.0.15-7_amd64 bug

NAME

       pecomato - a portable picture-embedded metadata processor

SYNOPSIS

       pecomato [OPTION...] OP [EXPR] FILE [FILE...]

       pecomato [OPTION...] OP [EXPR] @FILE

       usage of form OP EXPR only concerns OP mode dump-value, see below.

       use  @file  to read a list of files from that file. the file must contain exactly one filename to process
       per line (don't escape anything, filenames are taken as-is).

DESCRIPTION

       pecomato is basically designed to display any kind of information embedded in picture files, as  well  as
       checking,  filtering,  extracting,  removing,  adding and fixing such information. In other words, it's a
       metadata processor.

       It supports the following file formats: JPEG/JFIF, Adobe PSD and FFO, raw IPTC.  And it knows  about  the
       following metadata formats: JFIF, IPTC, Exif, Adobe and Fotostation. More file and metadata formats might
       be supported later: TIFF, etc.

       One of its main goals is to check the validity of parsed metadata as well as optionally check the  strict
       compliance  to  official  standards.  On  another  hand,  it aims to provide ways of fixing broken or not
       compliant chunks as well as providing general basic functions to manipulate the metadata.

       Please visit the program  homepage  at  http://www.mollux.org/projects/pecomato/.  Thanks  for  reporting
       issues at https://www.mollux.org/services/bugzilla/.

OPTIONS

       general options:

        -v, --version
              show version number then exit

        -h, --help
              show this usage help then exit

            --list
              list all supported embedded data structures

        -l, --log-level NUM
              define verbosity (see possible values below)

        -c, --check-compliance
              perform full checks to test the strict validity and compliance of structures to official formats

       filtering and extracting options:

        -b, --backup
              create backup files of (re)written files if necessary

        -d, --target-dir DIRNAME
              target directory for all written files

        -f, --fix
              fix metadata inconsistencies when possible

       extracting options:

        -x, --extract TYPE
              extract and save metadata to a standalone file (see below for a list of metadata types that can be
              extracted)

        -t, --ext EXTENSION
              define what filename extension to use when writing metadata that is extracted (default: .iptc)

        -a, --append-ext
              append extension to original  filename  when  saving  the  extracted  metadata  (default:  replace
              original file extension)

       filtering options:

        -i, --include EXPR
              a filter expression describing the datasets to keep

        -i, --include @FILE
              or  a file containing a list of datasets to keep, all other datasets will be filtered out.  if not
              used, all datasets will be kept

        -e, --exclude EXPR
              a filter expression describing the datasets to filter out

        -e, --exclude @FILE
              a file containing a list of datasets to filter out, all other datasets will be kept. if  not  used
              all datasets will be kept

        --edit EXPR
              a filter edit expression describing the datasets to add

        --edit @FILE
              or  a  file  containing  a  list  of  datasets  to add.  datasets won't be inserted if that breaks
              compliance to the standards

        --test
              don't override original file, create *.rewrite file.  this option only affects rewriting of source
              files

       dump options:

        -w, --wrap NUM
              max column for wrapping (num must be in range [8-1024]). default is to dump unwrapped

POSSIBLE OPS

        check just check embedded data structures

        dump  show embedded data (headers only)

        dump-full
              show all embedded data (including values)

        dump-value
              show requested value (headers only)

        filter
              filter embedded data (see -i, -e and --edit)

DUMP-VALUE EXPRESSIONS

       IPTC.<record>

       same as filter include/exclude expression, see below:

FILTER INCLUDE/EXCLUDE EXPRESSIONS

       IPTC.<record>

       where <record> can be either:

       all:               *

       hexadecimal unary: 0xhhhh

       hexadecimal range: 0xhhhh-0xhhhh

       decimal unary:     nnn:nnn

       decimal ranges:    nnn:nnn-nnn

                          nnn:*

       examples:

       IPTC.0x0219

       IPTC.0x0300-0x0364

       IPTC.3:0-100

FILTER EDIT EXPRESSIONS

       IPTC.<record>=<type>:<value>

       where <record> can be either:

       hexadecimal unary: 0xhhhh

       decimal unary:     nnn:nnn

       where <type> can be either:

       hex

       text

       and <value> is:

       hex:  [a-zA-Z0-9] pairs

       text: any char (even widechars) on the line is taken as text, until

             a newline is found

       examples:

       IPTC.0x0200=hex:0002

       IPTC.0x0219=text:this is a keyword

SUPPORTED METADATA FOR EXTRACTION

        iptc  IPTC datasets

POSSIBLE LOG LEVELS

        0     quiet, no output at all

        1     error messages only (default)

        2     warning and error messages

        3     informative, warning and error messages

        4     all messages including debug ones

SUPPORTED INPUT FILES

        JPEG files (commonly .jpeg, .jpg, .jpe, .jfif, .jif)

        Adobe Photoshop files (commonly .psd, .pdd, .ffo)

        FotoStation files (commonly .fdp, .ipt)

        standalone IPTC metadata (commonly .iptc)

EXIT CODES

        0     normal exit

        1     usage error

        2     asynchronous signal termination

        3     normal exit, with warning(s)

        4     normal exit, with error(s)

        5     fatal error encountered

EXAMPLES

       Check metadata structures of a JPEG file, only report errors
              $ pecomato check file.jpg

AUTHOR

       Written by Tristan Chabredier "wwp" <subscript@free.fr>.

       Copyright (C) 2005-2007 Tristan Chabredier.

       This  program  is  free  software;  you  can  redistribute it and/or modify it under the terms of the GNU
       General Public License as published by the Free Software Foundation; either version 3 of the License,  or
       (at your option) any later version.

       This  program  is  distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even
       the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General  Public
       License for more details.

       You  should  have  received a copy of the GNU General Public License along with this program. If not, see
       <http://www.gnu.org/licenses/>.

                                                                                                             (1)