| 1 |
.\" Copyright © 2002-2012 by Thomas Pircher (tehpeh at gmx dot net), |
| 2 |
.\" Dan Fandrich et. al. |
| 3 |
.\" |
| 4 |
.\" Permission is granted to make and distribute verbatim copies of this |
| 5 |
.\" manual provided the copyright notice and this permission notice are |
| 6 |
.\" preserved on all copies. |
| 7 |
.\" |
| 8 |
.\" Permission is granted to copy and distribute modified versions of this |
| 9 |
.\" manual under the conditions for verbatim copying, provided that the |
| 10 |
.\" entire resulting derived work is distributed under the terms of a |
| 11 |
.\" permission notice identical to this one |
| 12 |
.\" |
| 13 |
.\" Formatted or processed versions of this manual, if unaccompanied by |
| 14 |
.\" the source, must acknowledge the copyright and authors of this work. |
| 15 |
.\" License. |
| 16 |
.\" |
| 17 |
.TH exif 1 "2012-07-13" "exif 0.6.21.1" "command line front-end to libexif" |
| 18 |
.SH "NAME" |
| 19 |
exif \- shows EXIF information in JPEG files |
| 20 |
.SH "SYNOPSIS" |
| 21 |
.BI "exif [ " "OPTION" " ] [ " "file..." " ]" |
| 22 |
.SH DESCRIPTION |
| 23 |
.B "exif" |
| 24 |
is a small command-line utility to show and change EXIF information in JPEG |
| 25 |
files. |
| 26 |
.PP |
| 27 |
Most digital cameras produce EXIF files, which are JPEG files with extra tags |
| 28 |
that contain information about the image. The |
| 29 |
.B "exif" |
| 30 |
command-line utility allows you to read EXIF information from and write EXIF |
| 31 |
information to those files. |
| 32 |
.B "exif" |
| 33 |
internally uses the |
| 34 |
.B "libexif" |
| 35 |
library. |
| 36 |
.PP |
| 37 |
Each input file given on the command line is acted upon in turn, using |
| 38 |
all the options given. Execution will be aborted immediately if one |
| 39 |
file is not readable or does not contain EXIF tags. |
| 40 |
.PP |
| 41 |
As EXIF tags are read, any unknown ones are discarded and known ones are |
| 42 |
automatically converted into the correct format, if they aren't already. |
| 43 |
Corrupted MakerNote tags are also removed, but no format changes are made. |
| 44 |
.SH "OPTIONS" |
| 45 |
.TP |
| 46 |
.BI "\-v, \-\-version" |
| 47 |
Display the |
| 48 |
.B exif |
| 49 |
version number. |
| 50 |
.TP |
| 51 |
.BI "\-i, \-\-ids" |
| 52 |
Show ID numbers instead of tag names. |
| 53 |
.TP |
| 54 |
.BI "\-t, \-\-tag=" "TAG" |
| 55 |
Select only this |
| 56 |
.IR "TAG" . |
| 57 |
.I "TAG" |
| 58 |
is the tag title, the short tag name, or the tag number |
| 59 |
(hexadecimal numbers are prefixed with 0x), from the IFD specified |
| 60 |
with \-\-ifd. The tag title is dependent on the current locale, whereas |
| 61 |
name and number are locale-independent. |
| 62 |
.TP |
| 63 |
.BI "\-\-ifd=" "IFD" |
| 64 |
Select a tag or tags from this |
| 65 |
.IR "IFD" . |
| 66 |
Valid IFDs are "0", "1", "EXIF", "GPS", and "Interoperability". |
| 67 |
Defaults to "0". |
| 68 |
.TP |
| 69 |
.BI "\-l, \-\-list\-tags" |
| 70 |
List all known EXIF tags and IFDs. A JPEG image must be provided, and |
| 71 |
those tags which appear in the file are shown with an asterisk in the |
| 72 |
corresponding position in the list. |
| 73 |
.TP |
| 74 |
.BI "\-|, \-\-show\-mnote" |
| 75 |
Show the contents of the MakerNote tag. The contents of this tag are nonstandard |
| 76 |
(and often undocumented) and may therefore not be recognized, or if they are |
| 77 |
recognized they may not necessarily be interpreted correctly. |
| 78 |
.TP |
| 79 |
.BI "\-\-remove" |
| 80 |
Remove the tag or (if no tag is specified) the entire IFD. |
| 81 |
.TP |
| 82 |
.BI "\-s, \-\-show\-description" |
| 83 |
Show description of tag. The \-\-tag option must also be given. |
| 84 |
.TP |
| 85 |
.BI "\-e, \-\-extract\-thumbnail" |
| 86 |
Extract the thumbnail, writing the thumbnail image to the file specified |
| 87 |
with \-\-output. |
| 88 |
.TP |
| 89 |
.BI "\-r, \-\-remove\-thumbnail" |
| 90 |
Remove the thumbnail from the image, writing the new image to the file specified |
| 91 |
with \-\-output. |
| 92 |
.TP |
| 93 |
.BI "-n, \-\-insert\-thumbnail=" "FILE" |
| 94 |
Insert |
| 95 |
.I "FILE" |
| 96 |
as thumbnail. No attempt is made to ensure that the contents of |
| 97 |
.I "FILE" |
| 98 |
are in a valid thumbnail format. |
| 99 |
.TP |
| 100 |
.BI "\-\-no-fixup" |
| 101 |
Do not attempt to fix EXIF specification violations when reading tags. |
| 102 |
When used in conjunction with \-\-create-exif, this option inhibits the |
| 103 |
creation of the mandatory tags. |
| 104 |
.B exif |
| 105 |
will otherwise remove illegal or unknown tags, add some mandatory tags using |
| 106 |
default values, and change the data type of some tags to match that required |
| 107 |
by the specification. |
| 108 |
.TP |
| 109 |
.BI "\-o, \-\-output=" "FILE" |
| 110 |
Write output image to |
| 111 |
.IR "FILE" . |
| 112 |
If this option is not given and an image file must be written, the |
| 113 |
name used is the same as the input file with the suffix ".modified.jpeg". |
| 114 |
.TP |
| 115 |
.BI "\-\-set\-value=" "VALUE" |
| 116 |
Set the data for the tag specified with \-\-tag and \-\-ifd to |
| 117 |
.IR "VALUE" . |
| 118 |
Compound values consisting of multiple components are separated with |
| 119 |
spaces. |
| 120 |
.TP |
| 121 |
.BI "\-c, \-\-create-exif" |
| 122 |
Create EXIF data if it does not exist. Mandatory tags are created with |
| 123 |
default values unless the \-\-no-fixup option is given. |
| 124 |
This option can be used instead of specifying an input file name in most |
| 125 |
cases, to operate on the default values of the mandatory set of EXIF tags. |
| 126 |
In this case, the \-\-output option has no effect and no file is written. |
| 127 |
.TP |
| 128 |
.BI "\-m, \-\-machine\-readable" |
| 129 |
Produce output in a machine-readable (tab-delimited) format. |
| 130 |
The \-\-xml-output and \-\-machine\-readable options are mutually exclusive. |
| 131 |
.TP |
| 132 |
.BI "\-w, \-\-width=" "N" |
| 133 |
Set the maximum width of the output to N characters (default 80). This does |
| 134 |
not apply to some output formats (e.g. XML). |
| 135 |
.TP |
| 136 |
.BI "\-x, \-\-xml-output" |
| 137 |
Produce output in an XML format (when possible). |
| 138 |
The \-\-xml-output and \-\-machine\-readable options are mutually exclusive. |
| 139 |
Note that the XML schema changes with the locale, and it sometimes produces |
| 140 |
invalid XML. This option is not recommended. |
| 141 |
.TP |
| 142 |
.BI "\-d, \-\-debug" |
| 143 |
Show debugging messages. Also, when processing a file that contains corrupted |
| 144 |
data, this option causes |
| 145 |
.B exif |
| 146 |
to attempt to continue processing. Normally, |
| 147 |
corrupted data causes an abort. |
| 148 |
.SS "Help options" |
| 149 |
.TP |
| 150 |
.BI "\-?, \-\-help" |
| 151 |
Show help message. |
| 152 |
.TP |
| 153 |
.BI "\-\-usage" |
| 154 |
Display brief usage message. |
| 155 |
.SH "EXAMPLES" |
| 156 |
Display all recognized EXIF tags in an image and the tag contents, with bad |
| 157 |
tags fixed: |
| 158 |
.LP |
| 159 |
.RS |
| 160 |
exif image.jpg |
| 161 |
.RE |
| 162 |
.LP |
| 163 |
Display a table listing all known EXIF tags and whether each one exists in the |
| 164 |
given image: |
| 165 |
.LP |
| 166 |
.RS |
| 167 |
exif \-\-list-tags \-\-no-fixup image.jpg |
| 168 |
.RE |
| 169 |
.LP |
| 170 |
Display details on all XResolution tags found in the given image: |
| 171 |
.LP |
| 172 |
.RS |
| 173 |
exif \-\-tag=XResolution \-\-no-fixup image.jpg |
| 174 |
.RE |
| 175 |
.LP |
| 176 |
Display the raw contents of the "Model" tag in the given image (with a newline |
| 177 |
character appended): |
| 178 |
.LP |
| 179 |
.RS |
| 180 |
exif \-\-ifd=0 \-\-tag=Model \-\-machine-readable image.jpg |
| 181 |
.RE |
| 182 |
.LP |
| 183 |
Extract the thumbnail into the file thumbnail.jpg: |
| 184 |
.LP |
| 185 |
.RS |
| 186 |
exif \-\-extract-thumbnail \-\-output=thumbnail.jpg image.jpg |
| 187 |
.RE |
| 188 |
.LP |
| 189 |
Display a list of the numeric values of only the EXIF tags in the thumbnail IFD |
| 190 |
(IFD 1) and the tag values: |
| 191 |
.LP |
| 192 |
.RS |
| 193 |
exif \-\-ids \-\-ifd=1 \-\-no-fixup image.jpg |
| 194 |
.RE |
| 195 |
.LP |
| 196 |
Display the meaning of tag 0x9209 in the "EXIF" IFD according to the EXIF |
| 197 |
specification: |
| 198 |
.LP |
| 199 |
.RS |
| 200 |
exif \-\-show-description \-\-ifd=EXIF \-\-tag=0x9209 |
| 201 |
.RE |
| 202 |
.LP |
| 203 |
Add an Orientation tag with value "Bottom-left" (4) to an existing image, |
| 204 |
leaving the existing tags untouched: |
| 205 |
.LP |
| 206 |
.RS |
| 207 |
exif \-\-output=new.jpg \-\-ifd=0 \-\-tag=0x0112 \-\-set-value=4 \-\-no-fixup image.jpg |
| 208 |
.RE |
| 209 |
.LP |
| 210 |
Add a YCbCr Sub-Sampling tag with value 2,1 (a.k.a YCbCr 4:2:2) to an |
| 211 |
existing image and fix the existing tags, if necessary: |
| 212 |
.LP |
| 213 |
.RS |
| 214 |
exif \-\-output=new.jpg \-\-tag=YCbCrSubSampling \-\-ifd=0 \-\-set-value='2 1' image.jpg |
| 215 |
.RE |
| 216 |
.LP |
| 217 |
Remove the "User Comment" tag from an image: |
| 218 |
.LP |
| 219 |
.RS |
| 220 |
exif \-\-output=new.jpg \-\-remove \-\-tag="User Comment" \-\-ifd=EXIF image.jpg |
| 221 |
.RE |
| 222 |
.LP |
| 223 |
Display a table with all known EXIF tags, highlighting mandatory ones: |
| 224 |
.LP |
| 225 |
.RS |
| 226 |
exif \-cl |
| 227 |
.RE |
| 228 |
.LP |
| 229 |
.SH "AUTHOR" |
| 230 |
.B exif |
| 231 |
was written by Lutz Mueller <[email protected]> |
| 232 |
and numerous contributors. |
| 233 |
This man page is Copyright \(co 2002-2012 Thomas Pircher, |
| 234 |
Dan Fandrich and others. |
| 235 |
.SH "SEE ALSO" |
| 236 |
.UR "https://libexif.github.io/" |
| 237 |
.BR "https://libexif.github.io/" |
| 238 |
.UE |