Repository navigation
Releases
v0.2.3 — built with libjxl 0.13.0
The same thumbnails, now built with libjxl 0.13.0: the code is v0.2.2's. Updating is recommended — libjxl 0.13.0 carries security fixes, and jxl-thumb runs it on every .jxl Explorer shows, whoever made the file.
What's new
- libjxl 0.13.0 instead of 0.12.0 (the official static package, SHA-256 checked), with its security fixes: among them Brotli 1.2.1 (CVE-2026-111497) and hardening across the decoder.
- Nothing else changes: same thumbnails, same speed, same files read, same install.
Checked before publishing: on 51 files — the 16 masters of the README's measurements, lossless and lossy modular files, alpha, gray, an animation, a JPEG transcoded to JXL, a rotated file, a 120 px one, files with and without jxl-photo's thumbnail box, two truncated ones — the DLL from GitHub made the same thumbnails as v0.2.2, pixel for pixel, at 256, 768 and 1024 px, reading the same bytes in the same time; the file cut before its DC fails exactly as before. Installed over v0.2.2 from this zip, extracted to a folder with brackets, a space and Japanese in its name: Windows' thumbnail process loaded the new DLL and made the thumbnails of fresh copies.
Install / update
Download jxl-thumb-0.2.3-x64.zip, unzip, run install.cmd (current user, no admin rights). It replaces the old version; Explorer may hold the old DLL until the next sign-out, and the installer removes it on a later run.
Full detail: Version history | Verifying a download | libjxl 0.13.0 | v0.2.2
v0.2.2 — photo details of .jxl files in Explorer
The thumbnails do not change: the DLL's code is v0.2.1's. What is new is a way to make Explorer show a .jxl file's photo details.
What's new
Photo details in Explorer. On some Windows 11 builds Explorer shows only the size and dates of a .jxl file, not its camera, lens, ISO, date taken or title, while a JPEG shows them all. The metadata is in the file and Windows' own JPEG XL decoder reads it; what is missing is the property-handler entry for .jxl.
enable_explorer_details.cmdregisters Windows' own image property handler for.jxl(no code of jxl-thumb's) and the list of details Explorer shows. It asks for administrator rights once. It changes nothing when another program already registered a handler, or when Windows has no JPEG XL decoder.disable_explorer_details.cmdundoes exactly what it did.install.cmdsays when a PC is missing it, and the README's install steps name it.
Checked before publishing, on Windows 11 26H2 with this zip extracted to a folder with brackets, a space and Japanese in its name: disable removed the handler (administrator prompt) and the per-user list, leaving no key behind; enable registered both again; Explorer then showed the camera, lens, ISO, aperture, exposure and date of jxl-photo masters. The DLL from GitHub made the same thumbnails as v0.2.1, byte for byte, at the same speed (~2 ms on jxl-photo outputs).
Install / update
Download jxl-thumb-0.2.2-x64.zip, unzip, run install.cmd (current user, no admin rights). If Explorer shows no camera or ISO for .jxl files, also run enable_explorer_details.cmd.
Full detail: Version history | Photo details in Explorer | Verifying a download | v0.2.1
v0.2.2_beta1 — photo details of .jxl files in Explorer (pre-release)
Pre-release. The thumbnails do not change: the DLL's code is v0.2.1's.
Photo details in Explorer. On some Windows 11 builds Explorer shows only the size and dates of a .jxl file, not its camera, lens, ISO, date taken or title, while a JPEG shows them all. The metadata is in the file and Windows' own JPEG XL decoder reads it; what is missing is the property-handler entry for .jxl.
- New
enable_explorer_details.cmd: registers Windows' own image property handler for.jxl(no code of jxl-thumb's) and the list of details Explorer shows. It asks for administrator rights once. It changes nothing when another program already registered a handler, or when Windows has no JPEG XL decoder. disable_explorer_details.cmdundoes exactly what it did.install.cmdsays when a PC is missing it.
Not checked yet in this pre-release: the administrator step of the two scripts themselves (the same registry entry, made by hand, was checked on Windows 11 26H2).
See the README and the version history.
v0.2.1 — built by GitHub Actions, with a build attestation
Same jxl-thumb as v0.2.0, now built by GitHub instead of on the author's PC. Nothing changes in what it does; there is no need to update from v0.2.0.
What's new
- Built by GitHub Actions from the tagged code, with the same
package.cmdanyone can run locally (workflow). - Build attestation for the zip,
jxl_thumb.dllandthumbtest.exe. With the GitHub CLI:It shows the commit and the workflow run the file came from, and fails for any file that was not built there.gh attestation verify jxl_thumb.dll --repo rsilvabr/jxl-thumb
Before publishing, the DLL from GitHub was checked against the local v0.2.0 build: the same thumbnails, pixel for pixel, on lossy, lossless and jxl-photo-thumbnail files, at the same speed.
Install / update
Download jxl-thumb-0.2.1-x64.zip, unzip, run install.cmd (current user, no admin rights).
Full detail: Version history | Verifying a download
v0.2.0 — thumbnails jxl-photo stores in the file
Lossless JPEG XL files now get their thumbnails in milliseconds too — when jxl-photo v2.16.0+ wrote them (or added the thumbnail later).
What's new
A lossy JXL keeps a small preview of itself, which jxl-thumb has always read. A lossless JXL has none, so its thumbnail meant decoding the whole file: about 1.1 s for a 45 MP photo, 1.8 s from a hard disk.
jxl-photo now stores a small JPEG (768 px, sRGB) inside its lossless outputs, in a section of the file of its own that other programs skip. jxl-thumb 0.2.0 shows it:
| 45 MP photo (SSD, warm) | v0.1.1 | v0.2.0 |
|---|---|---|
| lossless | 1100 ms | 1.7 ms |
| lossy d=0.1 (with the thumbnail) | 52 ms | 1.7 ms |
- It is used only while it still matches the image it was made from, so an edited photo never shows an old thumbnail.
- Larger requests (the preview pane) and every file without it work exactly as before.
- Existing files: jxl-photo's menu option 9 adds it without re-encoding.
Install / update
Download jxl-thumb-0.2.0-x64.zip, unzip, run install.cmd (current user, no admin rights). Updating over 0.1.x works the same way. Thumbnails Windows already cached stay until clear_thumbnail_cache.cmd is run.
Full detail: Version history | How it works
v0.1.1 — About 2.4× Faster Thumbnails
Faster thumbnails; nothing changes on your side. To update, extract the zip and run install.cmd again.
On 16 real 25–45 MP masters (d=0.05), requested through the Windows shell:
| Microsoft extension 1.2.50 | v0.1.0 | v0.1.1 | |
|---|---|---|---|
| 16 photos, 256 px thumbnails | 36.9 s | 2.2 s | 0.91 s |
| 16 photos, 1024 px (preview pane) | 36.9 s | 3.6 s | 2.6 s |
| Per photo, Z7 45 MP | 3.17 s | 165 ms | 62 ms |
| 16 MP lossless (full decode) | — | ~200 ms | 110 ms |
Changes
- The DC is read in one go. The first read is a tenth of the file (1–16 MB) instead of 256 KB steps; further reads double.
- Up to 16 threads per thumbnail (was 8).
- Lighter downscale of the DC image. Lossless thumbnails are byte-identical to v0.1.0's.
What the measurements showed
The code is short, so most of the value is in knowing why it is written this way. Everything below is from instrumented builds on a 32-thread desktop, with the files in the disk cache. The full tables are in docs/performance.md.
-
Explorer asks for one thumbnail at a time. A build that logged every call showed all requests coming from one thread of one
dllhost.exe, never two at once. So the time of a single thumbnail is what you wait for, and spreading one file over several cores is what helps. Explorer also asks again when the icon size changes (96 px, then 256 px), and each request is a separate decode. -
Feeding the file in small steps made the DC decode serial. With only part of the DC in its buffer, libjxl decodes a few groups per call. In 256 KB steps the DC of a 45 MP master took 84 ms whatever the thread count (105 ms with 1 thread, 85 ms with 32). Read in one go, it takes 25 ms.
-
Where the DC ends. On these masters it ends 0.8–3.7 MB in, at 4.8–10.3 % of the file. Reading a tenth of the file got it in one read for all 16 (3.1 MB on average). A sixteenth missed on some files and was slower.
-
16 threads is the sweet spot. Per photo it took 52 ms with 8 threads, 39 ms with 16 and 54 ms with 32 (creating 32 threads costs ~9 ms per call).
-
A persistent thread pool was tried and left out. It saved ~3 ms per thumbnail, but threads that outlive a call keep running inside a DLL that Windows can unload.
-
Colour conversion to sRGB costs nothing measurable. For lossy (XYB) files, libjxl produces sRGB directly.
-
libjxl renders the DC at full resolution. There is no API to flush at 1:8 scale, so a 45 MP photo still comes out as 45 million (upsampled) pixels. Summing all of them took ~19 ms.
- That image holds no finer detail than the DC, so summing every 2nd row and column costs only ~0.6 dB (0.2–1.6 dB) against a full decode.
- Every 4th row and column would save another 1.5 ms but costs 1–5 dB, so it was not used.
- Full decodes still sum every pixel.
-
What is left per 45 MP photo:
- ~15 ms decoding the DC.
- ~17 ms in libjxl's full-size render of it.
- ~15–20 ms of Windows shell overhead, for the out-of-process call and the cache write.
A 1:8 flush in libjxl would remove most of the render.
Colour check against the original TIFF converted to sRGB by ImageMagick: 43.4 dB PSNR (v0.1.0: 44.0 dB).
v0.1.0 — Fast JPEG XL Thumbnails
First release. jxl-thumb is a thumbnail provider for Windows Explorer that builds JPEG XL thumbnails from the small 1:8 image every lossy JXL stores at the start of the file, instead of decoding the whole photo.
What you get
- About 14× faster thumbnails than the Microsoft JPEG XL extension: 16 real 25–45 MP masters (
d=0.05) went from 36.9 s to 2.6 s. - The preview pane too. Explorer draws it from the thumbnail provider, so it gets faster and colour-correct as well.
- Only the start of each file is read (5–15 %). That helps most on hard disks and network drives.
- Works on the files you already have. No re-encode and no special
cjxloption are needed. - Correct colours (everything converted to sRGB), plus orientation, alpha, grayscale, animation (first frame) and truncated files.
- Lossless files have no 1:8 image, so they are decoded in full with libjxl's multi-threaded decoder.
Install
Download jxl-thumb-0.1.0-x64.zip, extract it and run install.cmd. It installs for your Windows user only and needs no admin rights. uninstall.cmd gives Explorer back its previous handler. Thumbnails Windows has already cached stay until the cache is cleared (clear_thumbnail_cache.cmd or Disk Cleanup → Thumbnails).
The Photos app and other programs keep using whatever JPEG XL support they have.
Built with libjxl 0.12.0. Windows 10/11, 64-bit.
Full detail: README · How it works · Version history