JPEGINFO(1)

💖 JPEGINFO 💖

okay bestie, welcome to jpeginfo — she lives in section 1 of the general commands manual and she is literally your new fave. periodt ✨

---

✨ NAME ✨

jpeginfo — prints information and tests integrity of JPEG/JFIF files. 🖼️💅

---

🌸 SYNOPSIS 🌸

jpeginfo [ options ] [ filenames ]

---

🦋 DESCRIPTION 🦋

so jpeginfo is the girl who does two things and does them flawlessly: she generates informative listings of jpeg files, and she checks jpeg files for errors. no cap. she also supports automatic deletion of broken jpegs, which is giving "we don't keep toxic files in this house" 💀✂️

---

🎀 OUTPUT FORMATS 🎀

jpeginfo supports several different output formats, because she contains multitudes. 💖 The default formats are meant to be displayed on screen, while there's also CSV and JSON formats that are easier to parse by another program. iykyk 🧚

While CSV and JSON formats always display all "columns", the other formats don't display columns that do not have any data. for example, if the -c option is not used to check JPEG integrity, then the status (and details) columns won't be displayed. 🙈

Similarly, if the MD5/SHA-2 checksum (hash) is not calculated, then that column will not be shown. it's giving "if you didn't ask for it, you don't get it." 💅

⭐ Default Format ⭐

the default output format, bestie:

<filename> <image_width> x <image_height> <colordepth> <progressive_vs_normal> <markers> <size>

Example, because visuals matter:

$ jpeginfo *.jpeg
IMG_1439.jpeg                    3282 x 3024 24bit N JFIF,Exif
2961607
IMG_1560.jpeg                    3815 x 2862 24bit N JFIF
1045063
IMG_2520.jpeg                    3964 x 2900 24bit N JFIF,Exif,ICC
4712099

🌈 Extra information format 🌈

additional info can be displayed using the -i option, because sometimes you want the lore:

<filename> <image_width> x <image_height> <colordepth> <progressive_vs_normal> <markers> <extra_info> <size>

Example:

$ jpeginfo -i *.jpeg
IMG_1439.jpeg                    3282 x 3024 24bit N JFIF,Exif
Huffman,300dpi       2961607
IMG_1560.jpeg                    3815 x 2862 24bit N JFIF
Huffman,300dpi       1045063
IMG_2520.jpeg                    3964 x 2900 24bit N JFIF,Exif,ICC
Huffman,300dpi       4712099

💜 Ls command style output format 💜

option -l moves the filename to be the last column, resulting in output that's a bit like output from the ls -l command (iconic behavior honestly):

<image_width> x <image_height> <colordepth> <progressive_vs_normal> <markers> <size> <filename>

Example:

$ jpeginfo -l *.jpeg
3282 x 3024 24bit N JFIF,Exif                2961607 IMG_1439.jpeg
3815 x 2862 24bit N JFIF                     1045063 IMG_1560.jpeg
3964 x 2900 24bit N JFIF,Exif,ICC            4712099 IMG_2520.jpeg

---

💅 OPTIONS 💅

okay so options may be either the traditional POSIX one letter options, or the GNU style long options. POSIX style options start with a single -, while GNU long options start with --. both are valid, both are slaying. ✨

options offered by jpeginfo are the following:

• -c, --check — check files also for errors. (default is just to read the headers). 🔍
• -C, --comments — display file comments (from COM markers). 💬
• -d, --delete — delete files that have errors. (default is not to delete any files). yes she will actually delete them bestie 💀
• -f<filename>, --file<filename> — read filenames to process from the given file. to use standard input (stdin), use - as a filename. this is the alternative to the default where filenames are given as parameters to the program. 📄
• -h, --help — display short usage information and exits. 🆘
• -H, --header — display column names header in output. 🏷️
• -2, --sha256 — calculates SHA-256 checksum for each file. 🔐
• --sha512 — calculates SHA-512 checksum for each file. 🔐
• -5, --md5 — calculates MD5 checksum for each file. 🔐
• -i, --info — displays even more information about each picture. prints image coding (Huffman/Arithmetic), density (in dpi/dpc), and whether CCIR601 sampling was used or not. 🧠
• -j, --json — JavaScript Object Notation (JSON) output format. 🧾
• -l, --lsstyle — uses alternate listing format (ls -l style). 📋
• -v, --verbose — enables verbose mode (positively chatty). 🗣️
• --version — displays program version. 👑
• -q, --quiet — quiet mode, output just the jpeg infos. 🤫
• -s, --csv — comma separated values (CSV) output format. 📊
• -m<mode>, --mode=<mode> — sets the delete mode, meaningful only when used with the -d flag. mode can be one of the following:
  • all — files containing any type of errors/warnings, not necessary preventing the decoding. (default)
  • erronly — only files with serious errors (i.e. cannot be decoded at all).
• -, --stdin — read input from standard input (instead of a file). 🫶

---

🔥 Known JPEG Markers 🔥

jpegoptim scans through application (APP) markers in the JPEG image and will display information about "well known" markers found in the image. markers found in the image are listed in the "markers" column. ✨

ngl the original page says jpegoptim here and we are keeping it exactly as written, bestie. no edits, no notes, that's the vibe. 💖

🌸 Known Application Markers 🌸

currently jpegoptim recognizes the following common application markers found in JPEG images:

• JFIF — JPEG File Interchange Format
• JFXX — JFIF Extension
• Exif — Exchangeable Image File Format
• XMP — Extensible Metadata Platform (Adobe)
• ICC — ICC Color Profile
• IPTC — IPTC (Adobe Photoshop)
• Adobe — Adobe
• AdobeCM — Adobe Color Management
• CIFF — Canon Raw
• AVI1 — AVI Video
• QVCI — Casio QVCI
• FLIR — FLIR
• FPXR — Kodak FlashPix
• MPF — CIPA Multi-Picture Format
• Meta — Kodak Meta
• Stim — CIPA Stereo Still Image
• JPS — JPEG Stereo Image
• Scalado — Scalado
• RMETA — Ricoh Meta
• EPPIM — Toshiba PrintIM
• NITF — National Imagery Transmission Format
• GoPro — GoPro
• SPIFF — JPEG Still Picture Interchange File Format
• AROT — Apple
• HDR — JPEG-HDR

🧚 Other Markers 🧚

if the image contained any unrecognized application (APP) markers, then UNKNOWN is added to the list of found markers. 👀

additionally, if the image contained any comment (COM) markers, then COM is added to the list of found markers. 💬

---

⭐ EXIT STATUS ⭐

the program returns 0 on a successful run. non-zero exit status is returned if there were any errors. not a slay.

when using the --check (or -c) option, the return value is non-zero if one or more of the files checked had any errors. 🚨

---

💖 SEE ALSO 💖

jpegoptim(1)

---

👑 AUTHOR 👑

Timo Kokkonen (tjko@iki.fi)

---

🎀 COPYING 🎀

Copyright (C) 1995-2023 Timo Kokkonen

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.

---

and that's the whole page bestie, we ate and left no crumbs 🍓🧚

4th Berkeley Distribution · 15 Jan 2023 · JPEGINFO(1) — mwah, love u, go check ur jpegs 💖✨🦋