Installing OpenJPEG on Windows 1X, Linux, and MacOS

OpenJPEG is an open-source JPEG 2000 codec written in C. There is no GUI. This command-line tool is easy to run and maintain using a command-line friendly OS like Linux, so I recommend installing Linux on your Windows 1X machine, taking advantage of Windows Subsystem for Linux feature.

Below are instructions for compiling OpenJPEG, ImageMagick, and GrokImageCompression from source code.

While it is easier to install OpenJPEG and ImageMagick via pre-compiled versions using apt, I've had issues with prior installations that I resolved by compiling the source code, so that is what I recommend. Note that you do not need to install ImageMagick at all, but it is a very useful utility.

If you'd like to try installing OpenJPEG via the precompiled version first, the following command should do the trick:

sudo apt install libopenjp2-7 libopenjp2-tools

Why install GrokImageCompression?

The original JPEG 2000 standard only accommodated three color encoding declarations: sGray, sYCC, and sRGB. As color management gained popularity and a wider variety of ICC display profiles were being embedded in images, the standard was amended in 2004 to accommodate the use of restricted ICC profiles. Those changes are incorporated into ISO/IEC 15444-1:2016 Information technology — JPEG 2000 image coding system: Core coding system — Part 1, the 2016 update to the standard.

As of the openjp2 library v2.3.1., OpenJPEG does not carry over the ICC display profiles embedded within the source image, but instead converts any color encoding to sRGB on output.

• Example showing how to perform an ICC profile-to-profile conversion using ImageMagick.

GrokImageCompression is an open-source JP2 encoder based on the OpenJPEG code that produces JP2 images encoded with the same colorspace -- includes the same ICC display profile -- resident in the source image.

Want to run Grok Image Compression on a Mac?

It can be installed via Homebrew with the command: brew install grokj2k

1. Install Ubuntu 20.04 LTS

From the Windows App Store, download Ubuntu.

Follow Microsoft's installation instructions.

• Update the installation by running the following command: sudo apt-get update ; sudo apt-get upgrade -y

• Install some additional software modules: sudo apt-get install pkg-config valgrind emacs-nox libltdl-dev libtiff-tools exiftool git git-lfs cmake liblcms2-dev libtiff-dev libpng-dev libheif1 libheif-dev libz-dev unzip libzstd-dev libwebp-dev build-essential hwinfo ; sudo python get-pip.py ; sudo apt-get install python3-jpylyzer.

2. Install OpenJPEG by compiling the source code:

• mkdir ~/install
• cd ~/install
• Download the source code: wget https://github.com/uclouvain/openjpeg/archive/master.zip

Follow the installation instructions, per OpenJPEG installation.

• unzip master.zip
• cd openjpeg-master/
• mkdir build
• cd build
• cmake -DCMAKE_BUILD_TYPE=Release ..
• make
• sudo make install
• sudo make clean

3. Install ImageMagick from source code:

Follow the ImageMagick installation instructions

• cd ~/install
• rm master.zip
• wget https://github.com/ImageMagick/ImageMagick/archive/refs/heads/main.zip
• unzip main.zip
• cd ImageMagick-main

Make sure system sees the libopenjp2.pc file just created by config. To look for the libopenjp2.pc files: find ~ -type f | grep libopenjp2.pc

• sudo pkg-config PKG_CONFIG_PATH=~/install/openjpeg-master/build
• ./configure --enable-shared
• sudo make
• sudo make install
• sudo make clean

4. Install GrokImageCompression

The process of compiling Grok is so fussy that, as of January 2024, we recommend:

sudo apt-get install libgrokj2k1 grokj2k-tools libgrokj2k1-dev libgrokj2k1-doc

5. Test your installation

• mkdir ~/images
• cd ~/images
• wget -O in.tif https://storage.googleapis.com/linked_content/icc/ICC_profile_test_image_Farbkreis_120grad.tif

Run the following commands:

• sudo ldconfig

Testing ImageMagick installation

• convert in.tif out_via_imagemagick.jp2 | exiftool out_via_imagemagick.jp2 | less

Testing OpenJPEG installation (lossy compression example)

• opj_compress -i in.tif -o out_lossy_42db.jp2 -p RLCP -t 1024,1024 -EPH -SOP -I -q 42

Testing GrokImageCompression installation (lossy compression example)

• grk_compress -i in.tif -o grk_out_lossy_42db.jp2 -p RLCP -t 1024,1024 -EPH -SOP -I -q 42

Are the JP2 files you created standard-compliant?

• jpylyzer *.jp2 | grep '<isValid format="jp2">True</isValid>'

Encoding JP2 files

Command: opj_compress, OpenJPEG

• Switches, partial list:

  • -i <inputFile.ext>
  • -p RLCP (progression order)
  • -t 1024,1024 (tile size, width,height)
  • -EPH (End of Packet Header marker)
  • -SOP (Start of Packet)
  • -ImgDir <image dir> (cannot be used with -i switch)
  • -OutFor <ext> (extension for output files)
  • -o <outputFile.ext>
  • -I (specifies lossy encoding)
  • -q <quality in db>
  • -r <compression ratio>
  • -OutFor [J2K|J2C|JP2]

  Output format used to compress the images read from the directory specified with-ImgDir. Required when-ImgDiroption is used. Supported formats areJ2K,J2C, andJP2.

  • -InFor [pbm|pgm|ppm|pnm|pam|pgx|png|bmp|tif|raw|rawl|jpg]

  Input format. Will override file tag.

Command: grk_compress, Grok

• Switches, partial list:
  • -i <inputFile.ext>
  • -p RLCP (progression order)
  • -t 1024,1024 (tile size, [width,height])
  • -EPH (End of Packet Header marker)
  • -SOP (Start of Packet)
  • -batch_src <input dir> (cannot be used with -i switch)
  • -out_dir <output dir> (required with batch_src is used)
  • -o <outputFile.ext>
  • -I (specifies lossy encoding)
  • -q <quality in db>
  • -r <compression ratio>
  • -out_fmt [J2K|J2C|JP2]
  • -V (transfer Exif tags)
  • -logfile <output file name>
  • -num_threads <number of threads>
  • -comment <comment>

Lossless example

• opj_compress -i in.tif -o out_lossless.jp2 -p RLCP -t 1024,1024 -EPH -SOP

• grk_compress -i in.tif -o grk_out_lossless.jp2 -p RLCP -t 1024,1024 -EPH -SOP

Lossy example

• opj_compress -i in.tif -o out_lossy_42db.jp2 -p RLCP -t 1024,1024 -EPH -SOP -I -q 42
• opj_compress -i in.tif -o out_lossy_r10.jp2 -p RLCP -t 1024,1024 -EPH -SOP -r 10

• grk_compress -i in.tif -o grk_out_lossy_42db.jp2 -p RLCP -t 1024,1024 -EPH -SOP -I -q 42
• grk_compress -i in.tif -o grk_out_lossy_r10.jp2 -p RLCP -t 1024,1024 -EPH -SOP -r 10

Decompress: converting JP2 files to other formats

• opj_decompress -i infile.j2k -o outfile.png

• opj_decompress -ImgDir images/ -OutFor tif

• grk_decompress -i infile.j2k -o outfile.png

• grk_decompress -batch_src images/ -out_fmt tif

—

Encoding entire directories

• opj_compress -OutFor jp2 -ImgDir /images/in -p RLCP -t 1024,1024 -EPH -SOP -OutDir /images/out

• grk_compress -out_fmt jp2 -batch_src /images/in -p RLCP -t 1024,1024 -EPH -SOP -out_dir /images/out

Shell scripts

Lossless compression

#!/bin/bash
# Grok Image Compression JP2 JPEG2000 codec encoder lossless compression
# https://github.com/GrokImageCompression/grok
find . -type f | grep --extended-regexp ".*\.tif$" | sed -E "s/.tif//g" > tiffNameStem.txt
ls -1 *.tif | wc -l | xargs echo "TIFF count: "
while read line
do
    grk_compress -i $line".tif" -o $line"_lossless.jp2" -p RLCP -t 1024,1024 -EPH -SOP
    echo "converting "$line".tif"
done < tiffNameStem.txt
echo "
     ~~~ FIN ~~~
"
ls -1 *.jp2 | wc -l | xargs echo "JP2 count: "

Lossy compression

#!/bin/bash
#Grok Image Compression JP2 JPEG2000 codec encoder lossy compression
#https://github.com/GrokImageCompression/grok
find . -type f | grep --extended-regexp ".*\.tif$" | sed -E "s/.tif//g" > tiffNameStem.txt
ls -1 *.tif | wc -l | xargs echo "TIFF count: "
while read line
do
    grk_compress -i $line".tif" -o $line"_lossy.jp2" -p RLCP -t 1024,1024 -EPH -SOP -I -q 42
    echo "converting "$line".tif"
done < tiffNameStem.txt
echo "
     ~~~ FIN ~~~
"
ls -1 *.jp2 | wc -l | xargs echo "JP2 count: "

end