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

VORBISCOMMENT(1)						 Ogg Vorbis Tools						  VORBISCOMMENT(1)

NAME

       vorbiscomment - List or edit comments in Ogg Vorbis files

SYNOPSIS

       vorbiscomment [-l] [-R] [-e] file.ogg
       vorbiscomment -a [ -c commentfile | -t "name=value" ] [-q] [-R] [-e] in.ogg [out.ogg]
       vorbiscomment -w [ -c commentfile | -t "name=value" ] [-q] [-R] [-e] in.ogg [out.ogg]

DESCRIPTION

       vorbiscomment Reads, modifies, and appends Ogg Vorbis audio file metadata tags.

OPTIONS

       -a, --append
	      Append comments.

       -c file, --commentfile file
	      Take comments from a file. The file is the same format as is output by the -l option or given to the -t option: one element per line
	      in 'tag=value' format. If the file is /dev/null and -w was passed, the existing comments will be removed.

       -h, --help
	      Show command help.

       -l, --list
	      List the comments in the Ogg Vorbis file.

       -t 'name=value', --tag 'name=value'
	      Specify a new tag on the command line. Each tag is given as a single string. The part before the '=' is treated as the tag name  and
	      the part after as the value.

       -w, --write
	      Replace  comments  with  the new set given either on the command line with -t or from a file with -c. If neither -c nor -t is given,
	      the new set will be read from the standard input.

       -R, --raw
	      Read and write comments in UTF-8, rather than converting to the user's character set.

       -e, --escapes
	      Quote/unquote newlines and backslashes in the comments. This ensures every comment is exactly one line in  the  output  (or  input),
	      allowing	to  filter and round-trip them. Without it, you can only write multi-line comments by using -t and you can't reliably dis-
	      tinguish them from multiple one-line comments.

	      Supported escapes are c-style "
", "
", "\" and "". A backslash followed by anything else is an error.

	      Note: currently, anything after the first "" is thrown away while writing.  This is a bug -- the Vorbis format	can  safely  store
	      null characters, but most other tools wouldn't handle them anyway.

       -V, --version
	      Display the version of vorbiscomment.

EXAMPLES

       To just see what comment tags are in a file:

	   vorbiscomment -l file.ogg

       To edit those comments:

	   vorbiscomment -l file.ogg > file.txt
	   [edit the comments in file.txt to your satisfaction]
	   vorbiscomment -w -c file.txt file.ogg newfile.ogg

       To simply add a comment:

	   vorbiscomment -a -t 'ARTIST=No One You Know' file.ogg newfile.ogg

       To add a set of comments from the standard input:

	   vorbiscomment -a file.ogg
	   ARTIST=No One You Know
	   ALBUM=The Famous Album
	   <ctrl-d>

TAG FORMAT

       See  http://xiph.org/vorbis/doc/v-comment.html  for documentation on the Ogg Vorbis tag format, including a suggested list of canonical tag
       names.

AUTHORS

       Program Authors:
	      Michael Smith <msmith@xiph.org>
	      Ralph Giles <giles@xiph.org>

       Manpage Author:
	      Christopher L Cheney <ccheney@debian.org>

SEE ALSO

       oggenc(1), oggdec(1), ogg123(1), ogginfo(1)

Xiph.Org Foundation						 December 30, 2008						  VORBISCOMMENT(1)
Man Page