|<B>-cB> or <B>--config-fileB> FILE||Path to the configuration file.|
|<B>-dB> or <B>--work-directoryB> DIR||Define the working directory.|
|<B>--excludeB> FILE||Specify files to exclude. Wildcards are not allowed. If a set of files is given, there must be as many occurrences of this option as there are files in the set.|
|<B>--sub-filesetB> FILE||Get names of files to operate upon from FILE. The file must contain a file name per line. This option is useful when you need to process only a set of X from Y files in the directory. If specified, the rest of files given in the command line is ignored.|
|<B>-eB> or <B>--extensionB> EXTENSION||Process the files with given EXTENSION (JPG, jpeg, CRW, crw, etc). Depending on the operating system, the extension search might or might not be case-sensitive.|
|<B>--mtimeB>, <B>--no-mtimeB>||Defines whether to set the files mtime, using DateTimeOriginal tag value. Use <B>--no-mtimeB> to set it to current time stamp after processing.|
|<B>--no-renrotB> or <B>--nochgB>||Do not rename, rotate, tag and mtime images. It saves files from any changes while allows to do aggregation, contact sheet generation e.t.c.|
|<B>--use-colorB>, <B>--no-use-colorB>||Colorize output. This does NOT work under Windows.|
|<B>--dry-runB>||Do not do anything, only print would have been done.|
|<B>-gB> or <B>--generate-thumbB>||Generation and writing ThumbnailImage tag. The original value of the ThumbnailImage tag remains intact. To rewrite it you need to delete it first (look exiftool examples).|
|<B>--use-ipcB>, <B>--no-use-ipcB>||Rotate thumbnails using pipe, rather than files. This does NOT work under Windows.|
|<B>-vB>||Increase debugging level by 1. Debugging levels from 1 to 4 are internal levels, the levels from 5 till 9 are equivalent to levels 1-5 levels ExifTool with the maximum verbosity for <B>renrotB>.|
|<B>-?B> or <B>--helpB>||Display short usage summary and exit.|
|<B>--versionB>||Output version information and exit.|
<B>--aggr-modeB> MODE Run aggregation process in given MODE. Possible values are: none, delta or template. <B>--aggr-deltaB> NUMBER Aggregation time delta, in seconds. Files with DateTimeOriginal and ones of the previous file delta, greater than <B>--aggr-deltaB> are placed in the directories, with the names are constructed by concatenating the value of the <B>--aggr-directoryB> option and the directory name counter. <B>--aggr-directoryB> DIR Aggregation directory name prefix (default is Images), have to be on the same file system (or on the file system which supports symbolic links in case of virtual aggregation), relative to the current working directory or an absolute path. <B>-aB> or <B>--aggr-templateB> TEMPLATE File name template to use for file aggregation. Images are aggregated by date/time patterns. You may use combination of <B>B>%d<B>B>, <B>B>%H<B>B>, <B>B>%M<B>B>, <B>B>%m<B>B>, <B>B>%S<B>B>, <B>B>%Y<B>B>, and <B>B>%y<B>B> meta-characters. The template can also be defined in the configuration file (see Aggregation Template variable). The default is %Y%m%d. For the detailed description, refer to <B>--name-templateB> option. For practical uses, see TEMPLATE EXAMPLES section. <B>--aggr-virtualB>, <B>--no-aggr-virtualB> Defines virtualization for existent aggregation modes. The main effect of <B>--aggr-virtualB> is that any files to be aggregated remain untouched in their places, and relative symbolic links pointing to them are stored in the directory tree created. Use <B>--no-aggr-virtualB> to prevent virtualization.
Options bellow are native ImageMagic montage options look ImageMagick documentation for montage options: montage --help and http://www.imagemagick.org/
<B>--contact-sheetB>, <B>--no-contact-sheetB> or <B>--csB>, <B>--no-csB> Create the contact sheet. Currently it works with ThumbnailImage EXIFs and the files defined as thumbnails (see the option <B>--contact-sheet-thmB>, below) <B>--contact-sheet-fileB> or <B>--cs-fileB> FILE Base file name for montage files. <B>--contact-sheet-dirB> or <B>--cs-dirB> DIR Temporary directory for montage (created in the begining and deleted at the end of the process) <B>--contact-sheet-thmB> or <B>--cs-thmB> Files for the montage are already thumbnails
Note please, for COLOR use RGB triplets only like 000 for the black or F00 for the red.
<B>--contact-sheet-tileB> or <B>--cs-tileB> GEOMETRY Tile MxN (IM: -tile) <B>--contact-sheet-titleB> or <B>--cs-titleB> STRING Set the title of the contact sheet (IM: -title). <B>--contact-sheet-bgB> or <B>--cs-bgB> COLOR Background color (IM: -background). <B>--contact-sheet-bdB> or <B>--cs-bdB> COLOR Border color (IM: -bordercolor). <B>--contact-sheet-mtB> or <B>--cs-mtB> COLOR Frame color (IM: -mattecolor). <B>--contact-sheet-fnB> or <B>--cs-fnB> STRING Render text with this font (IM: -font). <B>--contact-sheet-flB> or <B>--cs-flB> COLOR Color to fill the text (IM: -fill). <B>--contact-sheet-lbB> or <B>--cs-lbB> STRING Assign a label to an image (IM: -label). <B>--contact-sheet-frB> or <B>--cs-frB> GEOMETRY Surround image with an ornamental border in N pixels (IM: -frame). <B>--contact-sheet-pntszB> or <B>--cs-pntszB> NUMBER Font point size (IM: -pointsize). <B>--contact-sheet-shadowB> or <B>--cs-shadowB> Set the shadow beneath a tile to simulate depth (IM: -shadow). <B>--contact-sheet-thm-flB> or <B>--cs-thm-flB> COLOR Color to fill the text in generated thumbnail. <B>--contact-sheet-thm-fnB> or <B>--cs-thm-fnB> STRING Render the generated thumbnail text with this font (IM: -font). <B>--contact-sheet-thm-grfrB> or <B>--cs-thm-grfrB> COLOR Generated thumbnail background gradient COLOR-from <B>--contact-sheet-thm-grtoB> or <B>--cs-thm-grtoB> COLOR Generated thumbnail background gradient COLOR-to <B>--contact-sheet-thm-textB> or <B>--cs-thm-textB> STRING Generated thumbnail text <B>--contact-sheet-rankB> or <B>--cs-rankB> Run ranking process according to the ranks defined with <B>--contact-sheet-rank-fileB> The result is the colored frames of the thumbnails of contact sheets. <B>--contact-sheet-rank-fileB> or <B>--cs-rank-fileB> Path to the file with ranks. Its format is a file rankcolor per line. Filename separated from the color by space or tabulation.
Only the files found in the file will be ranked.
<B>--keywordsB>, <B>--no-keywordsB> Whether to fill Keywords tag. Default is to not. Be careful, since with this option enabled, the existing keywords are rewriten. The keywords are taken from .keywords file or file specified with option <B>--keywords-fileB>. <B>-kB> or <B>--keywords-fileB> FILE Path to the file with keywords. Its format is a keyword per line. The CR and LF symbols are removed. Empty (only whitespace) lines are ignored. Any leading and trailing whitespace is removed. For example, the line _Test_ CRLF is read as _Test_. <B>--keywords-replaceB>, <B>--no-keywords-replaceB> Replace existing Keywords tag list rather than add new values to it. Default is not to replace.
<B>-nB> or <B>--name-templateB> TEMPLATE A template to use for creating new file names while renaming. It can also be defined in the configuration file (variable Name Template). The default is %Y%m%d%H%M%S. For practical uses, see TEMPLATE EXAMPLES section.
Interpreted sequences are:
<B>%%B> a literal %
<B>B>%C<B>B> Numeric part of the original file name. Implemented for the sake of cameras, that do not supply FileNumber EXIF tag (currently all makes, except Canon). Such cameras generate file names starting with letters and ended with digits. No other symbols are allowed in file names, except -, . and _.
Be careful, since any binary EXIF (like ThumbnaiImage) can produce totally unexpected results.
<B>--no-renameB> Do not rename files (default is to rename them to YYYYmmddHHMMSS.ext) <B>--counter-fixed-fieldB>, <B>--no-counter-fixed-fieldB> Set fixed length for file counter, used in file name templates (see <B>B>%c<B>B>). It is enabled by default. Use <B>--no-counter-fixed-fieldB> to undo its effect. <B>--counter-startB> NUMBER Initial value for the file counter (default is 1) <B>--counter-stepB> NUMBER Step to increment file counter with (default is 1)
<B>-rB> or <B>--rotate-angleB> ANGLE Define the angle to rotate files and thumbnails. Allowed values for ANGLE are 90, 180 or 270. It is useful for files not having Orientation tag. <B>--rotate-thumbB> ANGLE Rotate only thumbnails. Allowed values for ANGLE are 90, 180 or 270 degrees. Use if the files which were already rotated, but their thumbnails were not. <B>--only-orientationB> Rotate by changing the value of Orientation tag, no real rotation will be made. The sequence of values to rotate an image from normal (0 degrees) by 90 degrees clockwise is: 0 -> 90 -> 180 -> 270 -> 0. It means. set Orientation tag to 90cw after the first rotation, and increase that value by 90 each time the rotation is applied. For 270cw the rotation algorithm uses the reverted sequence. Rotation by 180cw triggers values in two pairs: 0 <-> 180 and 90 <-> 270. This option cannot be applied to mirror values of Orientation tag. <B>--trimB>, <B>--no-trimB> Pass the -trim option to jpegtran(1), to trim if needed. By default, trimming is enabled. Use <B>--no-trimB> to disable it. <B>--no-rotateB> Do not rotate images (default is to rotate according to EXIF data).
<B>--comment-fileB> FILE File with commentaries. It is a low priority alias to TagFile = Comment: FILE. <B>--user-commentB> STRING A low priority alias to --tag UserComment: STRING <B>-tB> or <B>--tagB> TAG See the section TAGS, for the detailed description <B>--no-tagsB> No users defined tags will be written.
The name template 01.%c.%Y%m%d%H%M%S.%i.shtr-%E.f-%F.wb-%W.iso-%I (where F stays for FNumber, E for ExposureTime, I for ISO and W for WhiteBalance) can produce the following names:
The name template 01.%c.%Y%m%d%H%M%S.%i.shtr-#ExposureTime#.f-#FNumber#.wb-#WhiteBalance#.iso-#ISO# can produce the following names:
The aggregation template %Y%m%d produces the following aggregation:
these three files
will be stored in the directory 20030414, and
will be stored in the directory 20040131.
A configuration file can be used to set some variables. <B>RenrotB> looks for its configuration file, named renrot.conf, in system configuration directories /etc/renrot and /usr/local/etc/renrot, and in subdirectory .renrot. of the current user home directory. An alternate configuration file can also be explicitly given using the <B>--config-fileB> option.
The configuration file consists of a set of case-insensive keywords and their values separated by equal sign. Each such keyword/value pair occupies a separate line. Boolean variables can have one of the following values: 0, No, False, Off, Disable for false, and 1, Yes, True, On, Enable for true.
The variables defined for use in the configuration file are, for example:
<B>mtimeB> Set to Yes for synchronize mtime with tags, otherwise set it to No. <B>name templateB> File name template (see <B>--name-templateB>, for the description). <B>trimB> Set to Yes to trim rotated images when using jpegtran(1). <B>aggregation modeB> Aggregation mode, possible values are: none, delta or template. <B>aggregation templateB> Aggregation template, which defines the file aggregation (see <B>--aggr-templateB>, for the description). <B>aggregation virtualB> Defines virtualization for the existing aggregation modes (see the <B>--aggr-virtualB> option). <B>TagB>, <B>TagFileB> Refer to the section TAGS, for the detailed description <B>includeB> Include the named file.
A TAG is defined by the following combination: TagName [Group]: value. The defined tags are selected to be set and writen to the EXIF tree using the command line option <B>--tagB> and/or configuration file options <B>TagB>.
The parameters TagName and Group are passed to ExifTool as is. The name of the group must be enclosed in square brackets. Its value (after the semicolon) can be enclosed in single quotes.
The TagFile keyword allows to set multi-line tags from a file. Its syntax is:
Additionally, you can add any known tag here, using <B>TagB> or <B>TagFileB> options as described above.
<B>CopyrightB> Copyright notes. <B>CommentB> General comment. <B>UserCommentB> Anything you would like to put as a comment. <B>CreatorContactInfoCiAdrCityB> A city tag. <B>CreatorContactInfoCiAdrCtryB> A country tag. <B>CreatorContactInfoCiAdrExtadrB> Extended address (usually includes street and apartment number). <B>CreatorContactInfoCiAdrPcodeB> Zip code. <B>CreatorContactInfoCiAdrRegionB> Region. <B>CreatorContactInfoCiEmailWorkB> Email. <B>CreatorContactInfoCiTelWorkB> Phone number. <B>CreatorContactInfoCiUrlWorkB> URL.
o The main configuration file <B>renrot.confB> is searched in the following locations (in the order of their appearance):
<B>~/.renrot/B> directory under users home place <B>/usr/local/etc/renrot/B> system directory <B>/etc/renrot/B> system directory
Take into consideration, the files which are found will be loaded and parsed in the order when users configuration has maximal priority.
o Other configuration files with additional options could be included into main file:
<B>colors.confB> colors setup for different output facilities <B>tags.confB> different tags setup o The following files could be placed locally in the working directory:
<B>.keywordsB> file with keywords (see <B>--keywords-fileB>) <B>.rankB> file with ranks (see <B>--contact-sheet-rank-fileB>)
If you found some bug or have some nice propositions, you are welcome. Additionally, please, read the section RESTRICTIONS in file README.
1. It seems that on FreeBSD 6, Perl versions 5.8.x exhibits a bug that causes <B>renrotB> to crash. The overal amount of memory for the perl process increasing up to the user datasize limit (in FreeBSD default is 512M).
It seems to be a bug in perls own malloc implementation. The bug should not occur in any perl which uses the system malloc (unless the system malloc has the same bug).
Out of memory during large request for XXXX bytes ...
This, however, does not happen with Perl v.5.6.x
2. Some versions of ImageMagick render contact sheets incorrectly. it seems it is the question to ImageMagick.
Copyright 2005-2012, Zeus Panchenko, Andy Shevchenko.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Image::ExifTool(3pm), exiftool(1), jpegtran(1), Image::Magick(3pm)
|perl v5.20.3||RENROT (1)||2013-06-08|