Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

exifcom(1) [debian man page]

EXIFCOM(1)						      General Commands Manual							EXIFCOM(1)

NAME

       exifcom - display or set the UserComment tag contained in a JPEG Exif section

SYNOPSIS

       exifcom [ -bfinv ] [ -w comment ] [ -s delim ] file ...

DESCRIPTION

       When  invoked  without  arguments,  the exifcom utility displays the contents of the Exif UserComment tag contained in file to the standard
       output.	Otherwise, depending on the options specified, exifcom will blank the tag or set it to comment.

       Some digital cameras include a standard UserComment tag in the Exif data added to the image files they produce.	This comment tag is fixed-
       length and supports multi-byte character sets (though exifcom does not).  Note that not all cameras will include the tag.

       The utility is conservative in its approach to writing the UserComment tag.  It does not modify, extend, or otherwise adulterate an image's
       Exif metadata structure.  When writing the tag it merely changes pre-allocated bytes.  Therefore, exifcom is at the mercy of the Exif  data
       creator	for both the presence of the tag and its length.  It cannot create a UserComment tag when the camera does not include one, nor can
       it write a comment longer than the space pre-allocated by the camera.  exifcom only displays and writes ASCII character set comments.

OPTIONS

       -b     Blank the UserComment tag, overwriting both the character code and comment fields with NUL.  The character code  specifies  how  the
	      comment  is  represented;  it  is "undefined" when blank.  This is the state to which many cameras initialize the tag.  When used in
	      conjunction with the -w option, exifcom will blank the comment prior to setting it to comment.

       -f     Overwrite or blank existing or unsupported comments without prompting for confirmation.

       -i     Write a prompt to standard error before overwriting or blanking an existing or unsupported comment.  If the response from the  stan-
	      dard input begins with 'y' or 'Y', the comment is overwritten.  This option is default behavior.

       -n     Do  not overwrite or blank existing or unsupported comments and do not prompt for confirmation (i.e., automatically answer 'no' to a
	      confirmation prompt).  This option takes precedence over both the -f and -i options.

       -s     Separate field name and value in the verbose and multiple file cases with the string delim.  The default is ': '.

       -v     Be verbose when printing the contents of the UserComment tag.  Besides the comment itself (if present and supported),  exifcom  will
	      display the maximum comment length supported, the character code of the comment, and the length of the comment.

       -w     Set UserComment to the ASCII string comment.  If comment is longer than what the tag supports, it will be truncated to fit.

DIAGNOSTICS

       The  exifcom  utility  exits 0 on success.  When displaying a comment from a single file, if the UserComment tag is missing, it exits 1; if
       blank, it exits 2; if in an unsupported character code, it exits 3.  Otherwise, it exits 1 if an error occurs.

SEE ALSO

       exiftags(1), exiftime(1)

STANDARDS

       The exifcom utility was developed using the January 2002 Exif standard, version 2.2 (http://tsc.jeita.or.jp/).

BUGS

       If the tag doesn't exist or is too short, too bad.

AUTHOR

       The exifcom utility and this man page were written by Eric M. Johnston <emj@postal.net>.

																	EXIFCOM(1)

Check Out this Related Man Page

TAGGREPPER(1)							   User Commands						     TAGGREPPER(1)

NAME

       taggrepper - search and match tags of media file for regular expressions

SYNOPSIS

       taggrepper [--tag-label regexp]... [--display-taglabel]... [FILE/DIRECTORY]...

DESCRIPTION

       Perform a regular expression search on the tags of specified media files.

       Mandatory  arguments  to  long options are mandatory for short options too. All regular expressions are Perl Compatible Regular expressions
       supported by the PCRE libraries. Note that all matches are ANDed, meaning that for a successful match, matches against all tags must occur.

       Support exists for MP3 files, and, if compiled in, for Ogg Vorbis and FLAC files as well.

       -t, --title=REGEXP
	      Match the title tag against REGEXP

       -a, --artist=REGEXP
	      Match the artist tag against REGEXP

       -l, --album=REGEXP
	      Match the album, tag against REGEXP

       -y, --year=REGEXP
	      Match the year tag against REGEXP

       -g, --genre=REGEXP
	      Match the genre tag against REGEXP

       -c, --comment=REGEXP
	      Match the comment tag against REGEXP

       --track=REGEXP
	      Match the track tag against REGEXP

       -c, --composer=REGEXP
	      Match the composer tag against REGEXP

       -o, --orig-artist=REGEXP
	      Match the original artist tag against REGEXP

       -c, --copyright=REGEXP
	      Match the copyright tag against REGEXP

       -u, --url=REGEXP
	      Match the URL tag against REGEXP

       -e, --encoded-by=REGEXP
	      Match the encoded-by tag against REGEXP

       --any-tag=REGEXP
	      Match the encoded-by tag against REGEXP.	Using this option makes every one of the above options to be ignored

       --display-title
	      display title tag of matching files

       --display-artist
	      display artist tag of matching files

       --display-album
	      display album tag of matching files

       --display-year
	      display year tag of matching files

       --display-genre
	      display genre tag of matching files

       --display-comment
	      display comment tag of matching files

       --display-track
	      display track tag of matching files

       --display-composer
	      display composer tag of matching files

       --display-orig-artist
	      display orig-artist tag of matching files

       --display-copyright
	      display copyright tag of matching files

       --display-url
	      display url tag of matching files

       --display-encoded-by
	      display encoded-by tag of matching files

       -0, --print0,
	      Use null character as delimiter. This option can be used with -0 option of xargs.

       -r, --recursive
	      Search directories recursively

       -v, --version
	      Display version and exit

       -h, --help
	      Display this help message

       All regular expressions are PCRE regular expressions.  Refer  to  the  PCRE  documentation  for	details.   Report  comments  and  bugs	to
       a.kumar@alumni.iitm.ac.in

COPYING

       Copyright (C) Kumar Appaiah

       License: BSD License (see COPYING file in the distribution tarball for details)

       This  program  is  free	software;  you	can  distribute  it  under  the  terms of the BSD License. See the file COPYING in the tarball, or
       /usr/share/common-licenses/BSD on Debian-based systems.

SEE ALSO

       pcre(3)

taggrepper 0.01 						     July 2009							     TAGGREPPER(1)
Man Page