1JPEGINFO(1)                 General Commands Manual                JPEGINFO(1)
2
3
4

NAME

6       jpeginfo - prints information and tests integrity of JPEG/JFIF files.
7
8

SYNOPSIS

10       jpeginfo [ options ] [ filenames ]
11
12

DESCRIPTION

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
18

OUTPUT FORMATS

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
24
25       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
30
31       Similarly if MD5/SHA-2 checksum (hash) is  not  calculated,  then  that
32       column will not be shown.
33
34
35   Default Format
36       Default output format:
37
38       <filename>   <image_width>   x   <image_height>  <colordepth>  <progre‐
39       sive_vs_normal> <markers> <size>
40
41       Example:
42
43       $ 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
51
52   Extra information format
53       Additional information can be displayed using -i option:
54
55       <filename>   <image_width>   x   <image_height>  <colordepth>  <progre‐
56       sive_vs_normal> <markers> <extra_info> <size>
57
58       Example:
59
60       $ 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
68
69   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
73       <image_width>  x  <image_height>  <colordepth>   <progresive_vs_normal>
74       <markers> <size> <filename>
75
76       Example:
77
78
79       $ 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
84

OPTIONS

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
90       Options offered by jpeginfo are the following:
91
92       -c, --check
93             Check  files  also for errors. (default is just to read the head‐
94             ers).
95
96       -C, --comments
97             Display file comments (from COM markers).
98
99       -d, --delete
100             Delete files that have errors. (default  is  not  to  delete  any
101             files).
102
103       -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
108       -h, --help
109             Display short usage information and exits.
110
111       -H, --header
112             Display column names header in output.
113
114       -2, --sha256
115             Calculates SHA-256 checksum for each file.
116
117       --sha512
118             Calculates SHA-512 checksum for each file.
119
120       -5, --md5
121             Calculates MD5 checksum for each file.
122
123       -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
128       -j, --json
129             JavaScript Object Notation (JSON) output format.
130
131       -l, --lsstyle
132             Uses alternate listing format (ls -l style).
133
134       -v, --verbose
135             Enables verbose mode (positively chatty).
136
137       --version
138             Displays program version.
139
140       -q, --quiet
141             Quiet mode, output just the jpeg infos.
142
143       -s, --csv
144             Comma separated values (CSV) output format.
145
146       -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
150             all    Files containing any type of errors/warnings,  not  neces‐
151                    sary preventing the decoding. (default)
152
153             erronly
154                    Only  files  with serious errors (ie. cannot be decoded at
155                    all).
156
157       -, --stdin
158             Read input from standard input (instead of a file).
159
160
161

Known JPEG Markers

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
167
168   Known Application Markers
169       Currently jpegoptim recognizes  following  common  application  markers
170       found in JPEG images:
171
172                   ┌────────────┬────────────────────────────────────────────┐
173                   │Marker Name │                Description                 │
174                   ├────────────┼────────────────────────────────────────────┤
175JFIF        │ JPEG File Interchange Format               │
176JFXX        │ JFIF Extension                             │
177Exif        │ Exchangeable Image File Format             │
178XMP         │ Extensible Metadata Platform (Adobe)       │
179ICC         │ ICC Color Profile                          │
180IPTC        │ IPTC (Adobe Photoshop)                     │
181Adobe       │ Adobe                                      │
182AdobeCM     │ Adobe Color Management                     │
183CIFF        │ Canon Raw                                  │
184AVI1        │ AVI Video                                  │
185QVCI        │ Casio QVCI                                 │
186FLIR        │ FLIR                                       │
187FPXR        │ Kodak FlashPix                             │
188MPF         │ CIPA Multi-Picture Format                  │
189Meta        │ Kodak Meta                                 │
190Stim        │ CIPA Stereo Still Image                    │
191JPS         │ JPEG Stereo Image                          │
192Scalado     │ Scalado                                    │
193RMETA       │ Ricoh Meta                                 │
194EPPIM       │ Toshiba PrintIM                            │
195NITF        │ National Imagery Transmission Format       │
196GoPro       │ GoPro                                      │
197SPIFF       │ JPEG Still Picture Interchange File Format │
198AROT        │ Apple                                      │
199HDR         │ JPEG-HDR                                   │
200                   └────────────┴────────────────────────────────────────────┘
201
202   Other Markers
203       If image contained any unrecognized application (APP) markers then "UN‐
204       KNOWN" is added to the list of found markers.
205
206       Additionally if image contained any comment (COM) markers then "COM" is
207       added to the list of found markers.
208
209
210
211
212

SEE ALSO

214       jpegoptim(1)
215
216

AUTHOR

218       Timo Kokkonen (tjko@iki.fi)
219
220

COPYING

222       Copyright (C) 1995-2023  Timo Kokkonen
223
224       This program is free software: you can redistribute it and/or modify it
225       under the terms of the GNU General Public License as published  by  the
226       Free  Software Foundation, either version 3 of the License, or (at your
227       option) any later version.
228
229       This program is distributed in the hope that it  will  be  useful,  but
230       WITHOUT  ANY  WARRANTY;  without  even  the  implied  warranty  of MER‐
231       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the  GNU  General
232       Public  License  for  more details.  You should have received a copy of
233       the GNU General Public License along with this  program.  If  not,  see
234       <https://www.gnu.org/licenses/>.
235
236
237
2384th Berkeley Distribution         15 Jan 2023                      JPEGINFO(1)
Impressum