Linux Certif

Toute la documentation sur la certification Linux LPI

digicamerge

NAME

digicamerge - manual page for digicamerge 2.00

DESCRIPTION

DigicaMerge v2.00 (C) 2002-2006 C@LL - Conseil Internet & Logiciels Libres A command line tool to merge directories of pictures taken with digital cameras.

If you've got a digital camera, your hard disk probably contains many directories full of pictures all named with the same names. This utility allows you to merge such directories' contents into a new directory, and renames all the pictures on the fly, ensuring no filename clash will occur.

command line usage :

digicamerge [options] srcdir1 [srcdir2 ... srcdirN] destination

options :

-v | --version

Prints DigicaMerge's version number then exits.

-h | --help

Prints this message then exits.

-q | --quiet

Doesn't print progress indicator.

-m | --mode M

Does a chmod to mode M after each file move. M is in octal but may not have a leading 0, for example both 644 and 0644 work.

-n | --nodupes

Remove duplicates.

-p | --pattern P

Uses pattern P to select the files to move to the destination directory. P default value is "*.jpg" which is convenient for most cases.

-s | --scheme S

Defines the naming scheme for the files created in the destination directory. The default naming scheme is "dscf%(count1)04i.jpg" which matches my digital camera default naming scheme.

You can currently use the following named formats, which are all strings except count0 and count1 which are integers :

count0

: file number beginning at 0

count1

: file number beginning at 1

date

: date at which the picture was taken in

the YYYYMMDD format.

isodate : same as above but in ISO8601 format,

i.e. YYYY-MM-DD

year

: year in YYYY format

month

: month in MM format

day

: day in DD format

hour

: hour in hh format

minute

: minute in mm format

second

: second in ss format

time

: time in hhmmss format

srcname

: Complete source filename

srcdir

: Source directory

srcbase

: Source basename

srcprefix : Source basename's prefix srcext : Source extension

You can also use all recognized Exif Tags, like ExposureProgram or ExifImageHeight for example.

A naming scheme MUST contain either %(count0) or %(count1) to avoid duplicate file names.

The default naming scheme produces file names like :

dscf0001.jpg dscf0002.jpg ...

Look at the Python language string formatting capabilities to learn how to create your own naming scheme.

-c | --command C

Launches command C on each picture *after* each picture move, but *before* the access and modification date and time or access mode are modified. The C command can use environment variables to access to the predefined values discussed above, as well as to each Exif tag. All are available under the names listed above prefixed with DGCM, like DGCMcount1 or DGCMExposureProgram. Several additional variables are also defined :

DGCMsrcname : Complete source filename DGCMdstname : Complete destination filename

DGCMsrcdir : Source directory DGCMdstdir : Destination directory

DGCMsrcbase : Source basename DGCMdstbase : Destination basename

DGCMsrcprefix : Source basename's prefix DGCMdstprefix : Destination basename's prefix

DGCMsrcext : Source extension DGCMdstext : Destination extension

-t | --touch

Modifies the file access and modification times according to the date the picture was taken, as stated in the DateTime Exif tag.

-C | --copy

Copy files instead of moving/renaming them.

examples :

$ digicamerge --scheme "%(date)s-%(count0)i.jpeg" christmas newyear 2002end

This will create a new directory named 2002end, and move all *.jpg pictures from the christmas and newyear directories into 2002end, renaming each file with the date at which the picture was taken followed by a number beginning at 0, e.g. : 20021225-45.jpeg

$ digicamerge pics renumbered

This will put all the pictures present in the pics directory into the renumbered directory. Each picture will be renumbered so that no numbering hole will exist anymore (numbering holes might have been created if you deleted some pictures from the pics directory)

$ digicamerge -c "jhead -st ~/thumbnails/\$DGCMdstname \$DGCMdstname" xmas xmas2

This will do like the previous example, but thumbnails will be extracted from each picture using the jhead command and will be put into the ~/thumbnails/xmas2 directory under the same (possibly new) names. NB : Don't forget to escape the variable names with an antislash

if you need to, otherwise they may come undefined !

$ digicamerge --touch --scheme "%(Model)s-%(ExifImageWidth)sx%(ExifImageHeight)s-%(count1)04i.jpg" birthday mybirthday

This will put all the pictures present in the birthday directory into the mybirthday directory. Each file will be renamed with a name which looks like (for my digital camera) : FinePix S304-2048x1536-0001.jpg and the access and modification time of the picture files will be set to the date and time at which each picture was taken.

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 2 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, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

Please e-mail bugs to: Jerome Alet - <alet@librelogiciel.com>