README.md

jxl-winthumb

A JPEG XL (*.jxl) WIC decoder to render thumbnails on Windows File Explorer or view images on any WIC-capable image viewers.

How to install

1. Download the dll file from https://github.com/saschanaz/jxl-winthumb/releases
   1. ARM 64bit Windows gets _aarch64.dll
   2. Intel/AMD 64bit Windows gets _x86_64.dll
   3. Intel/AMD 32bit Windows gets _i686.dll
2. Open a terminal window as administrator
3. Move to your download directory
4. regsvr32 jxl_winthumb_(arch).dll, or to uninstall, regsvr32 /u jxl_winthumb_(arch).dll.

You might need to restart explorer.exe or any programs that use the dll before updating it. Get the list of such programs using tasklist /m jxl_winthumb.dll and kill them e.g. with taskkill /f /im explorer.exe && start explorer.exe.

Build environment

Use the stable Rust toolchain. Current toolchain as of 26th February 2024 is 1.75.0.

Helpful resources

• Integration with Windows Photo Gallery and Windows Explorer
• Using Kind Names

Inspired by

• Intercom thumbnail provider example
• FlifWICCodec
• flif_windows_plugin
• jpegxl-wic