1JPEGINFO(1) General Commands Manual JPEGINFO(1)
2
6 jpeginfo - prints information and tests integrity of JPEG/JFIF files.
7
10 jpeginfo [ options ] [ filenames ]
11
14 jpeginfo is used to generate informative listings of jpeg files, and
15 also to check jpeg files for errors. Program also supports automatic
16 deletion of broken jpegs.
17
20 jpeginfo supports several different output formats. Default formats are
21 meant to be displayed on screen, while there is also CSV and JSON for‐
22 mats that are easier to parse by another program.
23 While CSV and JSON formats always display all "columns", other formats
26 don't display columns that do not have any data. For example if -c op‐
27 tion is not used to check JPEG integrity, then the `status` (and `de‐
28 tails`) columns won't be displayed.
29 Similarly if MD5/SHA-2 checksum (hash) is not calculated, then that
32 column will not be shown.
33 Default Format
36 Default output format:
37 <filename> <image_width> x <image_height> <colordepth> <progres‐
39 sive_vs_normal> <markers> <size>
40 Example:
42 $ jpeginfo *.jpeg
44 IMG_1439.jpeg 3282 x 3024 24bit N JFIF,Exif
45 2961607
46 IMG_1560.jpeg 3815 x 2862 24bit N JFIF
47 1045063
48 IMG_2520.jpeg 3964 x 2900 24bit N JFIF,Exif,ICC
49 4712099
50 Extra information format
53 Additional information can be displayed using -i option:
54 <filename> <image_width> x <image_height> <colordepth> <progres‐
56 sive_vs_normal> <markers> <extra_info> <size>
57 Example:
59 $ jpeginfo -i *.jpeg
61 IMG_1439.jpeg 3282 x 3024 24bit N JFIF,Exif
62 Huffman,300dpi 2961607
63 IMG_1560.jpeg 3815 x 2862 24bit N JFIF
64 Huffman,300dpi 1045063
65 IMG_2520.jpeg 3964 x 2900 24bit N JFIF,Exif,ICC
66 Huffman,300dpi 4712099
67 Ls command style output format
70 Option -l moves filename to be last column, resulting output that is
71 bit like output from `ls -l` command:
72 <image_width> x <image_height> <colordepth> <progressive_vs_normal>
74 <markers> <size> <filename>
75 Example:
77 $ jpeginfo -l *.jpeg
80 3282 x 3024 24bit N JFIF,Exif 2961607 IMG_1439.jpeg
81 3815 x 2862 24bit N JFIF 1045063 IMG_1560.jpeg
82 3964 x 2900 24bit N JFIF,Exif,ICC 4712099 IMG_2520.jpeg
83
86 Options may be either the traditional POSIX one letter options, or the
87 GNU style long options. POSIX style options start with a single ``-'',
88 while GNU long options start with ``--''.
89 Options offered by jpeginfo are the following:
91 -c, --check
93 Check files also for errors. (default is just to read the head‐
94 ers).
95 -C, --comments
97 Display file comments (from COM markers).
98 -d, --delete
100 Delete files that have errors. (default is not to delete any
101 files).
102 -f<filename>, --file<filename>
104 Read filenames to process from given file. To use standard input
105 (stdin) use '-' as a filename. This is alternative to default
106 where filenames are given as parameters to the program.
107 -h, --help
109 Display short usage information and exits.
110 -H, --header
112 Display column names header in output.
113 -2, --sha256
115 Calculates SHA-256 checksum for each file.
116 --sha512
118 Calculates SHA-512 checksum for each file.
119 -5, --md5
121 Calculates MD5 checksum for each file.
122 -i, --info
124 Displays even more information about each picture. Prints image
125 coding (Huffman/Arithmetic), density (in dpi/dpc), and whether
126 CCIR601 sampling was used or not.
127 -j, --json
129 JavaScript Object Notation (JSON) output format.
130 -l, --lsstyle
132 Uses alternate listing format (ls -l style).
133 -v, --verbose
135 Enables verbose mode (positively chatty).
136 --version
138 Displays program version.
139 -q, --quiet
141 Quiet mode, output just the jpeg infos.
142 -s, --csv
144 Comma separated values (CSV) output format.
145 -m<mode>, --mode=<mode>
147 Sets the delete mode, meaningful only when used with -d flag.
148 Mode can be one of the following:
149 all Files containing any type of errors/warnings, not neces‐
151 sary preventing the decoding. (default)
152 erronly
154 Only files with serious errors (i.e. cannot be decoded at
155 all).
156 -, --stdin
158 Read input from standard input (instead of a file).
159
163 jpegoptim scans through application (APP) markers in the JPEG image and
164 will display information about "well known" markers found in the image.
165 Markers found in image are listed in the "markers" column.
166 Known Application Markers
169 Currently jpegoptim recognizes following common application markers
170 found in JPEG images:
171 ┌────────────┬────────────────────────────────────────────┐
173 │Marker Name │ Description │
174 ├────────────┼────────────────────────────────────────────┤
175 │JFIF │ JPEG File Interchange Format │
176 │JFXX │ JFIF Extension │
177 │Exif │ Exchangeable Image File Format │
178 │XMP │ Extensible Metadata Platform (Adobe) │
179 │ICC │ ICC Color Profile │
180 │IPTC │ IPTC (Adobe Photoshop) │
181 │Adobe │ Adobe │
182 │AdobeCM │ Adobe Color Management │
183 │CIFF │ Canon Raw │
184 │AVI1 │ AVI Video │
185 │QVCI │ Casio QVCI │
186 │FLIR │ FLIR │
187 │FPXR │ Kodak FlashPix │
188 │MPF │ CIPA Multi-Picture Format │
189 │Meta │ Kodak Meta │
190 │Stim │ CIPA Stereo Still Image │
191 │JPS │ JPEG Stereo Image │
192 │Scalado │ Scalado │
193 │RMETA │ Ricoh Meta │
194 │EPPIM │ Toshiba PrintIM │
195 │NITF │ National Imagery Transmission Format │
196 │GoPro │ GoPro │
197 │SPIFF │ JPEG Still Picture Interchange File Format │
198 │AROT │ Apple │
199 │HDR │ JPEG-HDR │
200 └────────────┴────────────────────────────────────────────┘
201 Other Markers
203 If image contained any unrecognized application (APP) markers then "UN‐
204 KNOWN" is added to the list of found markers.
205 Additionally if image contained any comment (COM) markers then "COM" is
207 added to the list of found markers.
208
212 Program returns 0 on successful run. Non-zero exit status is returned
213 if there were any errors.
214 When using --check (or -c) option return value is non-zero if one or
216 more of the files checked had any errors.
217
221 jpegoptim(1)
222
225 Timo Kokkonen (tjko@iki.fi)
226
229 Copyright (C) 1995-2023 Timo Kokkonen
230 This program is free software: you can redistribute it and/or modify it
232 under the terms of the GNU General Public License as published by the
233 Free Software Foundation, either version 3 of the License, or (at your
234 option) any later version.
235 This program is distributed in the hope that it will be useful, but
237 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
238 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
239 Public License for more details. You should have received a copy of
240 the GNU General Public License along with this program. If not, see
241 <https://www.gnu.org/licenses/>.
2424th Berkeley Distribution 15 Jan 2023 JPEGINFO(1)