World's Leading Open Source JPEG 2000 Codec

★ 300⑂ 63👁 15⑃ 0● 75▤ 63
C++NOASSERTIONCreated 2016-01-31
Download: v20.4.25v20.4.25 ↓20.4.252026-11-02
+1
Daily
300
stars
63
forks
15
watchers
0
prs
75
issues
63
releases

README

Grok

[![badge-license]][link-license]
[![badge-actions]][link-actions]
[![badge-oss-fuzz]][link-oss-fuzz]


 
  
 



Grok is an open-source JPEG 2000 codec licensed under AGPL v3.

 Performance

Grok is integrated into GDAL.
Benchmark results (16 threads, GDAL release build, Fedora 42):

| Workflow                     | Grok (JP2Grok) | Kakadu (JP2KAK) | OpenJPEG     |
|------------------------------|----------------|------------------|--------------|
| Spot 6 (Network Storage)    | 35.17 s        | 344 s            | 85 s         |
| Spot 6 (Local Storage)      | 26.92 s        | 30.57 s          | 52.09 s      |
| Pleiades (Region)           | 0.74 s         | 1.41 s           | 4.28 s       |

 Features
- High Throughput JPEG 2000 (HTJ2K) support
- Random-access sub-image decoding (TLM + PLT markers)
- Multi-level tile cache with LRU eviction and compressed chunk caching
- S3 / cloud storage with network fetch caching and disk spillover
- ICC color profiles, XML/IPTC/XMP/EXIF metadata
- Monochrome, sRGB, palette, YCC, extended YCC, CIELab, CMYK
- 1–16 bit precision
- Compression accepts GRK_INT_32 and GRK_INT_16 input. GRK_INT_16 supports signed precision up to 16 bits and unsigned precision up to 15 bits. Use grk_compress_get_recommended_data_type() to detect the direct 16-bit compression path.
- JPEG/PNG/BMP/TIFF/RAW/PNM/PAM I/O
- Linux (x86-64/AArch64), Windows, macOS, WebAssembly

For direct API compression, call grk_compress_get_recommended_data_type() after configuring compression and plugin state, then use its result when allocating component data. It returns GRK_INT_16 only when compression retains a 16-bit tile buffer.

For standard MCT, query all three components and use GRK_INT_32 for all three if any query returns it. GRK_INT_32 remains valid when the function recommends GRK_INT_16.

Multi-tile callers may still choose accepted GRK_INT_16 input outside the direct path to reduce source-buffer memory, at the cost of widening each tile.

 Transcoding (grk_transcode)

grk_transcode rewrites JP2/J2K files at the packet level — no full decompression required. Supported operations:

- Insert TLM (Tile-part Length) and PLT (Packet Length) markers for random access
- Inject SOP / EPH markers
- Truncate quality layers (--max-layers)
- Strip resolution levels (--max-res)
- Reorder packet progression (LRCP, RLCP, RPCL, PCRL, CPRL)

Example — add TLM + PLT markers to an existing file:

grk_transcode -i input.jp2 -o output.jp2 -X -L


 Testing
- 2,000+ unit tests
- Continuous fuzzing via OSS-Fuzz

 Language Bindings
- Python, C, Java (SWIG)
- Rust (bindgen)

 Links
- Installation
- Testing
- Tile Cache Architecture
- S3 / Cloud Storage
- Language Bindings
- Wiki & Docs
- GitHub

 Quick Build

git clone --recursive https://github.com/GrokImageCompression/grok.git
cd grok
cmake -B build
cmake --build build --parallel


---

[badge-license]: https://img.shields.io/badge/License-AGPL%20v3-blue.svg
[link-license]: https://github.com/GrokImageCompre

Top issues

Latest release

v20.4.25 v20.4.25 2026-11-02

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON