== name ==

Renpics

== category ==

Digital Photography

== author ==

Kevin Layer (mailto(layer@franz.com)).

== author-image ==

== short-description ==

Rename files produced by a digital camera to contain the
date, time and camera name when the picture was taken.

== long-description ==

When you take a lot of digital pictures, finding a particular picture
can be very difficult.  Typically, the raw files that come out of a
digital camera have names like

  IMG_2369.JPG
  IMG_2370.JPG
  IMG_2371.JPG
  IMG_2372.JPG

These are meaningless file names created by the camera.
Renaming the files to contain the date
the picture was taken (as noted by the camera) can be handy.
For example, if your pictures are stored on the C: drive of
a Windows computer,
it would allow quickly finding all the pictures you took on December
25, 2002 by searching for files named italic(20021225*.jpg).

So, instead of the above names, you have names like this:

  20021225-0745-0300-D30.jpg
  20021225-0745-0301-D30.jpg
  20021225-0747-4500-D30.jpg
  20021225-0801-2800-D30.jpg

== examples ==

The renpics program is meant to be used as a command line tool.

The following could be used to move files off of a CF card:

  renpics -m -o c:/pictures/_TMP/ j:/

bold(-m) means italic(move) instead of italic(copy).
bold(-o c:/pictures/_TMP/) is the
destination directory and bold(j:/) is the source directory,
which might be a CompactFlash reader.
italic(renpics) looks in all subdirectories of bold(j:/) for
files of type italic(jpg).

== instructions ==

italic(renpics) can be used to rename italic(jpg), italic(avi) and
italic(wav) files produced by a digital camera based on exposure date
and time the pictures were taken.
The files are renamed to have the form:

  YYYYMMDD-hhmm-ssnn-cam.jpg

where italic(YYYY) is the year, italic(MM) is the month,
italic(DD) is the day, italic(hh) is the hour,
italic(mm) is the minute, italic(ss) is the second,
italic(nn) is a sequence number
(for when more than one picture was taken in a given second), and
italic(cam) is the camera name.

On Windows, italic(renpics) is a console app.  That is,
it is meant to be run from
a command shell (italic(command.com) or italic(cmd.exe)).

As mentioned above the name of the camera is added to the filename, at
the end.  For those that have different models of digital cameras, it
is often very useful to know from which camera a picture was taken.
If italic(renpics) does not know about your camera, then you can tell it
with the bold(-c) command line argument (see below).

The command line arguments are:

* bold(-c camera) :: set the name of the camera to italic(camera).

* bold(-f) :: use the date italic(of) the file not the date italic(in)
the file.  The date in the file is taken from the EXIF header
created by the camera.

* bold(-o output-directory) :: set the output directory where the renamed
files go.  It can be the same as the input directory, in which case
the files are just renamed in that directory.

* bold(-m) :: move instead of copy the files.

* bold(-n) :: do not rename any files, just print what would have been done.

* bold(-q) :: be quiet, very quiet.  Normally renpics prints informative
messages as to what it is doing.

== tutorial ==

The steps for installation of the binary distribution on Windows are:

* Unpack the binary distribution zip file.

* bold([OPTIONAL]) Either put the files in some directory already in
your PATH, or put the directory in which you unpack the files into
your PATH.  This makes it easier for you to execute italic(renpics).

* Create a batch file and put a shortcut to it on your desktop.  This
makes reading the files from your removable media a simple one-click
operation.  Of course, you should replace bold(c:/pictures/_TMP/) with
the output directory of your choosing, and bold(j:/) with the drive
letter and path to your removable media (if you skip the optional step
above, you will need to give the full path to the italic(renpics)
executable):

   @echo off
   renpics -m -o c:/pictures/_TMP/ j:/
   pause

The steps for installation from sources are:

* Unpack the binary distribution zip file.

* Put href(exifinfo.cl,/source/exifinfo.cl) into a subdirectory 
(of the directory into which you extracted the above zip file)
called italic(exif-utils).

* Edit the italic(makefile) to make sure the path to italic(mlisp) is
correct.  bold(You need Allegro CL Enterprise to build this
application).

* Type bold(make).

* Review what bold(make install) does and run that command, too.

== home-url ==

== doc-url ==

== license ==

href(LLGPL,http://opensource.franz.com/preamble.html)

== book ==

== references ==

== source-fooball ==

* Binary distribution for Windows users: href(renpics-1.8-windows.zip,ftp://ftp.franz.com/pub//examples/renpics/renpics-1.8-windows.zip)

* Source code: href(renpics-1.8-src.zip,ftp://ftp.franz.com/pub//examples/renpics/renpics-1.8-src.zip)

Remember to download href(EXIF info,entry-photog-exifinfo-des), too.

== release-date ==

1/5/2005

== release-version ==

1.8

== status ==

Stable.

== history ==

* 1.0: December 31, 2000: initial version

== acl-dependencies ==

Depends on the href(EXIF info,entry-photog-exifinfo-des) utility.

== other-dependencies ==

== platform ==

Should work on ACL version 6.0 or later.

== ad ==