Rechercher une page de manuel
renrot.1p
Langue: en
Version: 2006-10-06 (ubuntu - 07/07/09)
Section: 1 (Commandes utilisateur)
NAME
renrot - rename and rotate images according EXIF dataSYNOPSIS
renrot [OPTIONS] [[--] FILE1 FILE2 ...]DESCRIPTION
RenRot is intended to work with files of --extension extension, containing EXIF data and can do two things with them - rename and rotate. It runs in batch mode in current or set with --work-directory directory, as well as selective mode for separate files given as arguments in command line.RenRot renames files according the DateTimeOriginal and FileModifyDate EXIF tags, if they exists. Otherwise, the name will be set according to the current time stamp and will look as YYYYmmddHHMMSS.XXXX.ext, where XXXX is whether file ID, if exists in EXIF (as for Canon) or incremental suffix to the name YYYYmmddHHMMSS.
Additionally, it rotates files and their thumbnails, accordingly Orientation EXIF tag. When the tag is absent or miss set, the program allows to rotate the file as well as it's thumbnail via --rotate-angle and --rotate-thumb options. Now implemented only for JPEG format.
The script, also, can place the commentary into:
- - Commentary tag from file (see --comment-file option)
- UserComment tag from configuration variable (see ``TAGS'' section)
Personal details could be specified via XMP tags defined in a configuration file, see ``TAGS'' section.
In addition, RenRot can aggregate all files in directories according the given date/time pattern template, set with --aggr-template.
OPTIONS
- -c or --config-file FILE
- path to the configuration file
- -d or --work-directory DIR
- define the working directory
- --exclude FILE
- specify files to exclude. No wildcards are available. For set of files option must be occured same times as files given.
- -e or --extension EXTENSION
- extension of files to be processed, JPG, jpeg, CRW, crw, or any other you need. The given extension is case-sensivity in related filesystems.
- -n or --name-template TEMPLATE
- template, which is used for file name building while renaming. It could be defined in configuration file (the variable Name Template). The default is %Y%m%d%H%M%S. For practical results see ``TEMPLATE EXAMPLES'' section.
Interpreted sequences are:
-
- %% a literal %
%C the numeric part of the original file name. Implemented for the sake
of the cameras, where no FileNumber EXIF tag is present (currently all except Canon). Filename would started by letters and ended by digits. No other symbols are not allowed, except "-", "." and "_".
%c file order number in the processed file set (also see
--counter-fixed-field option)
%d day of the month (01-31)
%E ExposureTime tag value if defined
%e old file extension
%F FNumber tag value if defined
%H hour (00-23)
%I ISO tag value if defined
%i FileNumber tag if exists (otherwise, it'll be replaced by string
"NA")
%M minute (00-59)
%m month (01-12)
%n previous filename (the one before the current processing with renrot)
%O base part of the original filename (see %o). In other words the
first part from the begin to the last dot symbol.
%o the name, file had before first processing with renrot. If the file
was processed with renrot if only once, the tag RenRotFileNameOriginal written with the file name.
%S second (00-59)
%W WhiteBalance tag value if defined
%Y year (1900, 1901, and so on)
%y last two digits of year (00..99)
- %% a literal %
- --no-rename
- no rename needed, default is to rename to the YYYYmmddHHMMSS.ext
- --counter-fixed-field, --no-counter-fixed-field
- set fixed length for file counter (corresponding to %c), where it is used in templates. It's enabled by default. Use --no-counter-fixed-field to set dynamic width of field.
- --counter-start NUMBER
- the number to start count the files, to be renamed, from (default is 1)
- --counter-step NUMBER
- the step for the counter of the files to be renamed (default is 1)
- -r or --rotate-angle ANGLE
- define the angle to rotate file and the thumbnail on 90, 180 or 270. It's for the files where no Orientation tag is set right way.
- --rotate-thumb ANGLE
- rotate only thumbnail by 90, 180 or 270 degree. It's for the files which were rotated, but thumbnail wasn't.
- --only-orientation
- rotate by changing Orientation tag, no real rotation will be made. The sequence of values when rotating image from normal (0 degrees) by 90cw is: 0 -> 90 -> 180 -> 270 -> 0. It means set Orientation tag to 90cw after first usage of rotation by 90cw and so on. For 270cw rotation algorithm uses reversed sequence. Rotation by 180cw triggers values in two pairs: 0 <-> 180 and 90 <-> 270. This option can't be applied to mirror values of Orientation tag.
- --trim, --no-trim
- pass option "-trim" to jpegtran(1) to trim if needed. By default trimming is on. Use --no-trim to negate described behaviour.
- --no-rotate
- no rotation needed, default is to rotate according EXIF data
- --mtime, --no-mtime
- defines, whether to set mtime of the file, using DateTimeOriginal tag value. Use --no-mtime to set it to current time stamp after processing.
- --keywordize, --no-keywordize
- whether to keywordize. Default is to not. Be careful, since this option when on, rewrites existing keywords, not adds. The keywords are taken from .keywords file or file specified with option --keywords-file.
- -k or --keywords-file FILE
- path to the file with keywords (format is each keyword per line). The CR and LF symbols are removed. The empty (only whitespace) lines are skiped. The lead and tail whitespaces are also removed. For example, line " _Test_ CRLF" will be transformed to "_Test_".
- --keywords-replace, --no-keywords-replace
- Replace existing tag Keywords list rather than add the values to it. Default is to not replace.
- --aggr-mode MODE
- run aggregation process in given MODE. Possible values are: none, delta or template.
- --aggr-delta NUMBER
- aggregation time delta in seconds (file with DateTimeOriginal and the one of the previous file delta, greater than --aggr-delta is placed to the --aggr-directory followed by directory name counter).
- --aggr-directory DIR
- counterless aggregation directory name (default is Images)
- -a or --aggr-template TEMPLATE
- template, which is used for file aggregation. Aggregation fulfils according date/time patterns. You may use combination of %d, %H, %M, %m, %S, %Y, and/or %y keys. It could be defined in configuration file (the variable Aggregation Template). The default is %Y%m%d. For detailed description, please, turn to --name-template option. For practical results see ``TEMPLATE EXAMPLES'' section.
- --aggr-virtual, --no-aggr-virtual
- defines virtualization for existent aggregation modes. If set, than results of the aggregation are placed into the directory defined with command line option --aggr-virtual-directory or configuration file option aggregation virtual directory and further occures the things, which have to occure with the choosen aggregation mode but without this option. The difference is that the files to be aggregated are remains untouched in their places, and symlinks are placed to the directory tree created instead. Use --no-aggr-virtual to prevent virtualization.
- --aggr-virtual-directory DIR
- defines the directory, the results of the virtual aggregation to be placed to
- --comment-file FILE
- file with commentary. The low priority alias to TagFile = Comment: FILE.
- --user-comment STRING
- low priority alias to --tag UserComment: STRING
- -t or --tag TAG
- look ``TAGS'' section for the detailed description
- --no-tags
- no tags will be written. Default is to write tags.
- --use-color, --no-use-color
- colorized output. This NOT works under Win32.
- --dry-run
- show what would have been happened (no real actions)
- --use-ipc, --no-use-ipc
- thumbnail rotation via pipe, rather than via file. This NOT works under Win32.
- -v
- one or more "-v" sets debug level. From 1 to 4 - internal levels, 5 till 9 - equal to 1-5 levels for ExifTool plus maximum verbosity for renrot.
- -? or --help
- display quick help and exit
- --version
- output version information and exit
TEMPLATE EXAMPLES
The name template "01.%c.%Y%m%d%H%M%S.%i.%E%F%W%I" may produces following names:- 01.0021.20030414103656.NA.E1by40F2.8WAutoI160.jpg
01.0024.20040131230857.100-0078.E1by320F2.8WAutoI50.jpg
01.0022.20000820222108.NA.jpg
where F stays for FNumber, E for ExposureTime, I for ISO and W for WhiteBalance.
The aggregation template "%Y%m%d" produces following aggregation:
these three files
- 01.11.20030414103656.NA.jpg
01.12.20030414103813.NA.jpg
01.13.20030414103959.NA.jpg
will be put to the directory 20030414, and
- 01.14.20040131130857.100-0078.jpg
01.15.20040131131857.100-0079.jpg
01.16.20040131133019.100-0080.jpg
01.17.20040131135857.100-0083.jpg
will be put to the directory 20040131.
CONFIG
Configuration file could be used to set some variables. Configuration file is just set of case-insensivity keys and its values separated by equal sign. Boolean variables can be defined via following keywords: 0, No, False, Off for false, and 1, Yes, True, On for true. RenRot looks for file named renrot.conf in system directories such as /etc/renrot and /usr/local/etc/renrot, and in home directory of the user in subdirectory .renrot. User defined configuration file can be given via --config-file option. In the last case the given file is used only.These variables could be set via configuration file:
- mtime
- set to "Yes" for synchronize mtime with tags, otherwise set it to "No"
- name template
- name template, which defines the file name look (see --name-template)
- trim
- set to "Yes" to trim rotated images when using jpegtran(1)
- aggregation mode
- aggregation mode, possible values are: none, delta or template
- aggregation template
- aggregation template, which defines the file aggregation (see --aggr-template)
- aggregation virtual
- defines virtualization for existent aggregation modes (see --aggr-virtual option)
- aggregation virtual directory
- defines the directory for virtual aggregation (see --aggr-virtual-directory option>
- Tag, TagFile
- look ``TAGS'' section for the detailed description
- include
- defines the file that would be included in place as part of configuration
TAGS
TAG is defined by the next combination: TagName [Group]: 'value'.Using command line option --tag and/or configuration file options Tag it's possible to choose defined tags to be set and writen to the EXIF tree.
The syntax of the command line option --tag:
- --tag TagName [Group]: 'value'
The syntax of the configuration file option Tag:
- Tag = TagName [Group]: 'value'
Parameters TagName and Group are passed to ExifTool as is. Name of the group have to be enclosed in square brackets. The value (after semicolon) of the tag could be enclosed in tics.
Also the option TagFile was defined to give posibility to fill value of some tags with multi line content from the file. The syntax as follows:
- TagFile = TagName [Group]: FILE
Bellow are the tags to make sense to use with the options --tag and Tag:
- Copyright
- copyright notes
- Comment
- general commentary
- UserComment
- anything you'd wanna put as commentary
- CreatorContactInfoCiAdrCity
- city tag
- CreatorContactInfoCiAdrCtry
- country tag
- CreatorContactInfoCiAdrExtadr
- extended address (usually street and apartments)
- CreatorContactInfoCiAdrPcode
- zip code
- CreatorContactInfoCiAdrRegion
- region
- CreatorContactInfoCiEmailWork
- CreatorContactInfoCiTelWork
- phone
- CreatorContactInfoCiUrlWork
- URL
Additionally you can add any known tag here to be passed by Tag or TagFile options in the format described above.
FILES
Configuration file placement (with high priority first):- ~/.renrot/renrot.conf
- /usr/local/etc/renrot/renrot.conf
- /etc/renrot/renrot.conf
BUGS
If you found some bug or have nice proposition, you are welcome. Additionally, please, read RESTRICTIONS section in README.It seems that for Perl v.5.8.7 and 5.8.8, at least on FreeBSD 6 the bug, which cause crash of the renrot, exists.
In case when total amount of the files size to process is bigger than RAM amount, the renrot falls with error:
- Out of memory during ``large'' request for XXXX bytes ...
This doesn't occure for Perl v.5.6.1.
AUTHORS
Copyright 2005-2006, Zeus Panchenko, Andy Shevchenko.This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
SEE ALSO
Image::ExifTool(3pm),exiftool(1),jpegtran(1)Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre