Skip to content
Back to search

SageThumbs-2k

Windows 11 shell extension (Rust): Explorer thumbnails for 331 file types Windows can't show, including camera RAW, PSD, HEIC/AVIF, video, ebooks, comics and CAD. Crash-isolated, source-available rebuild of SageThumbs.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/LunarWerxs/SageThumbs-2k with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/LunarWerxs/SageThumbs-2k'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lunarwerxs--sagethumbs-2k/badge.svg)](/listings/lunarwerxs--sagethumbs-2k)

HTML

<a href="/listings/lunarwerxs--sagethumbs-2k"><img src="/api/listings/lunarwerxs--sagethumbs-2k/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. **[Download `SageThumbs2K-Setup-<version>.exe`](https://github.com/LunarWerxs/SageThumbs-2k/releases)** and run it. 2. That's it: open any folder of exotic images.

- There is **one payload**: the bundled ImageMagick engine is always installed, so every supported format works out of the box. (Older releases offered a cut-down "Compact" choice that dropped it; upgrading replaces that with the complete engine.) - **ARM64** ships as a separate `SageThumbs2K-Setup-<ver>-arm64.exe` for Windows on Arm, running natively rather than emulated, with the same engine as x64, so format coverage is identical on both.

> The installer registers a classic shell extension via `regsvr32` and trusts a self-signed cert for the Win11 modern menu. It's a *classic* extension by design (not an MSIX sandbox) because it spawns ImageMagick as a subprocess.

> **First run / SmartScreen:** every release since 3.0.0 is code-signed by LUNARWERX LLC (right-click the installer, Properties, Digital Signatures). A brand-new signed release can still meet a blue **"Windows protected your PC"** screen while it builds download reputation: click **More info → Run anyway**. Every line of the code is right here for you to inspect.

Installer vs. portable zip

Prefer nothing touching the registry outside your own account, or can't run an installer at all? Grab the **portable zip** from the same [releases page](https://github.com/LunarWerxs/SageThumbs-2k/releases) instead. It covers most of the app, but not quite everything:

| | Installer | Portable zip | |---|---|---| | Explorer thumbnails | ✅ | ✅ (per-user, no admin) | | Classic right-click menu | ✅ | ✅ (per-user, no admin) | | Settings, Convert/Resize, Quick preview, screenshots, OCR, eyedropper, CLI | ✅ | ✅ | | Explorer **preview pane** | ✅ | ❌ | | **Details pane** (columns, EXIF/tags) | ✅ | ❌ | | Modern Windows 11 right-click menu | ✅ | ❌ |

The three ❌ rows all need machine-wide registration, which is exactly what the portable zip is built to avoid. If you want those too, use the installer.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 391 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <img src="assets/logo.png" alt="SageThumbs 2K" width="112" />
  3. # SageThumbs 2K
  4. ### Real thumbnails where Windows shows a blank icon.
  5. A **Windows 11** shell extension that adds Explorer thumbnails, a right-click image toolkit and Quick preview for files Windows can't show. It is a **crash-isolated**, clean-room Rust rebuild of the original [SageThumbs](https://github.com/raspopov/SageThumbs), which has not been developed since 2019.
  6. [![Windows 11](https://img.shields.io/badge/Windows%2011-0078D6?logo=windows11&logoColor=white)](#-install)
  7. [![Built with Rust](https://img.shields.io/badge/Rust-DEA584?logo=rust&logoColor=222)](#-how-it-works)
  8. ![Formats](https://img.shields.io/badge/formats-435-2ea44f)
  9. [![Latest release](https://img.shields.io/github/v/release/LunarWerxs/SageThumbs-2k?sort=semver)](https://github.com/LunarWerxs/SageThumbs-2k/releases)
  10. [![License](https://img.shields.io/badge/license-PolyForm%20Noncommercial-orange)](#-license)
  11. [![CI](https://github.com/LunarWerxs/SageThumbs-2k/actions/workflows/ci.yml/badge.svg)](https://github.com/LunarWerxs/SageThumbs-2k/actions)
  12. [![Discord](https://img.shields.io/badge/Discord-join_the_community-5865F2?logo=discord&logoColor=white)](https://discord.gg/PsWpeNUzhk)
  13. <a href="https://sourceforge.net/projects/sagethumbs-2k/"><img src="https://a.fsdn.com/con/app/syndication/badge_img_direct/oss-rising-star/oss-rising-star/?variant_id=sf" alt="SourceForge Rising Star award" width="110" /></a>
  14. [**⬇ Download**](https://github.com/LunarWerxs/SageThumbs-2k/releases) · [Website](https://sagethumbs.lunarwerx.com/) · [Features](#-features) · [Formats](#-supported-formats) · [FAQ](https://github.com/LunarWerxs/SageThumbs-2k/blob/main/docs/FAQ.md) · [Changelog](https://github.com/LunarWerxs/SageThumbs-2k/blob/main/docs/CHANGELOG.md)
  15. <br/>
  16. <img src="assets/screenshots/settings.gif" alt="SageThumbs 2K Settings dialog cycling its category tabs: Win11-style nav rail, toggle switches, system-following dark mode" width="600" />
  17. &nbsp;
  18. <img src="assets/screenshots/preview2.png" alt="The SageThumbs 2K right-click menu: convert, resize, combine to PDF/CBZ, OCR, set as wallpaper and more" width="200" />
  19. <br/><br/>
  20. <img src="assets/screenshots/convert.png" alt="The SageThumbs 2K Convert dialog: batch convert to JPG/PNG/WebP with resize, quality and output-folder options" width="500" />
  21. <br/><br/>
  22. <img src="assets/screenshots/preview-collage.png" alt="SageThumbs 2K Quick preview, opened by pressing Space in Explorer: a rendered Markdown document, an email showing its headers and attachment list, a shaded 3D-print model, and a syntax-highlighted source file, side by side" width="840" />
  23. <br/><br/>
  24. <img src="assets/screenshots/preview-quicklook.png" alt="SageThumbs 2K Quick preview showing a Rust source file with syntax highlighting, line numbers and the caption toolbar" width="840" />
  25. <br/><br/>
  26. <img src="assets/screenshots/preview-pdf.png" alt="SageThumbs 2K Quick preview as a PDF viewer: continuous scrolling through a multi-page document, a clickable page-thumbnail strip, and Ctrl+F text search that jumped to the matching page" width="840" />
  27. </div>
  28. SageThumbs 2K is for anyone whose folders show blank icons: RAW shooters, Photoshop users, and comic and ebook collectors. It covers 435 file types Windows can't render natively, including camera RAW, Photoshop PSD, HEIC/AVIF, video, ebooks and comics. **Free for home use.** Work use needs a licence: US$5 a month or US$50 a year per PC, as the [website](https://sagethumbs.lunarwerx.com/) states.
  29. ---
  30. ## TL;DR
  31. - 🖼️ Explorer thumbnails for **435 file types it ignores**: camera RAW, Photoshop, HEIC/AVIF, **video (MKV, WebM, MP4, MOV…)**, JPEG-XR, MS Office, DjVu, ebooks & comics, 3D-print files, and the obscure long tail.
  32. - ☁️ **Works in OneDrive, Synology Drive and other cloud folders**, where Windows normally asks only the cloud app for thumbnails. Online-only files are never downloaded just to draw one.
  33. - 🛡️ **A corrupt or malicious file can't crash Explorer**: runs out-of-process, panic-guarded, with a sandboxed decoder.
  34. - ⚡ **Fast even on huge files**: camera RAW thumbnails come from the embedded preview instead of a slow demosaic (3–13× quicker), multi-gigabyte Photoshop files and archives are read straight off the disk, and no file is allowed to hang a folder.
  35. - 🧰 **Right-click toolkit:** convert, resize, lossless rotate, combine-to-PDF/CBZ, system-wide eyedropper, OCR, and more; all non-destructive, and **multi-file jobs run in parallel across every core**.
  36. - 👁️ **Press Space to preview** any file, QuickLook-style: **video & audio play**, code is **syntax-highlighted**, Markdown renders, PDFs page, and **email**, **SQLite databases** and **3D models** open read-only. Works in Explorer, on the Desktop, in **[Everything](https://www.voidtools.com/) search results**, and inside any app's **Open/Save dialog**.
  37. - 🔤 **Copy text off your screen**: drag a region and the words land on your clipboard, in an editable window so you can fix a misread. Uses Windows' own recognizer, so it adds nothing to the download.
  38. - 🎛️ **Make the menu yours**: **drag-reorder** (and show/hide) every right-click entry *and* its dividers; the context menu mirrors your layout exactly.
  39. - 🎨 **Redesigned Settings**: a Win11-style category nav rail with toggle switches, a **search box that finds any setting on any page**, system-following **dark mode**, **36 languages**.
  40. - 🦀 100% clean-room **Rust**, **free for personal use** ([PolyForm Noncommercial](#-license)); no GFL.
  41. > **[Download the installer →](https://github.com/LunarWerxs/SageThumbs-2k/releases)** Two clicks and your File Explorer just... works.
  42. ---
  43. ## Note from the Developer
  44. > I'm a huge fan of SageThumbs. There are 4 things I always install on a new build, Chrome, XnShell, Everything and SageThumbs. Having noticed multiple system crashes from SageThumbs recently and no update in almost a decade, I decided it was time to right this injustice...
  45. >
  46. > After about a week, and an embarrassing amount of tokens, we now have a ground-up, rust native, alternative that now supports hundreds of formats, extensive red teaming, obsessively optimized for speed with carefully audited packaging, dozens of iterations through UI/UX for simplicity, menu editors, a color picker, screenshot tool, etc.
  47. >
  48. > Please tell your friends, star the repo and if you find anything broken, please let me know.
  49. ---
  50. ## The story
  51. The original **SageThumbs** was a Windows legend. It made Explorer show thumbnails for *hundreds* of formats nothing else could. Then it stopped: no updates since 2019, built on the proprietary, frozen **GFL** library.
  52. **SageThumbs 2K rebuilds it from scratch in safe Rust** (a maintained decode pipeline, real crash isolation, and a native Windows 11 look) while keeping the one thing that made it great: **thumbnails for the files nothing else will show.**
  53. ---
  54. ## ✨ Features
  55. | | |
  56. |---|---|
  57. | 🖼️ **435 formats** | Camera RAW (Canon/Nikon/Sony/Fuji/…), PSD, GIMP XCF, DICOM, OpenEXR, FITS, HEIC/AVIF, JPEG-2000/XL/**XR**, Targa, SGI, and more |
  58. | 📚 **Ebooks & comics** | EPUB, MOBI/AZW (Kindle), FB2, CBZ/CB7/CBR/CBT: real covers in Explorer (a native-Rust [DarkThumbs](https://github.com/fire-eggs/DarkThumbs) port). Plain ZIP/RAR/7Z archives within the configured file-size limit get a contact-sheet thumbnail of the images inside, too |
  59. | 🎨 **Art / CAD / 3D / design** | PSD/PSB, Affinity, Clip Studio, Krita, OpenRaster, Blender, 3MF, FreeCAD, G-code, **SketchUp, Rhino, AutoCAD DWG, 3ds Max, Adobe XD, InDesign, Visio, CorelDRAW, Fusion 360 (.f3d)**: preview pulled straight from inside the file (no host app needed) |
  60. | 📄 **DjVu** | Pure-Rust, zero-GPL decode via [`djvu-rs`](https://crates.io/crates/djvu-rs); scanned books show their text |
  61. | 🔊 **Docs & audio** | PDF first page, Microsoft Office (Word/Excel/PowerPoint) & OpenDocument, and album art for MP3/FLAC/Ogg/Opus/M4A/**WMA**/**DSF (DSD)**/… (WMA/ASF and DSD/.dsf via hand-rolled parsers; `lofty` can't read either) |
  62. | 👁️ **Space-bar preview** | Tap **Space** in Explorer or on the Desktop for an instant full-size preview of any supported format, plus **video & audio playback**, **syntax-highlighted** code, **rendered Markdown**, a **PDF viewer** with page thumbnails and **Ctrl+F search**, **font specimens**, **archive listings**, **SQLite databases** and **email** (read-only), a **hex dump** for anything else, **Save (Ctrl+S)**, **Print (Ctrl+P)**, **←/→ folder browsing** and **double-click (or F11) full-screen**. Off by default; opt in from Settings |
  63. | 🧰 **Right-click toolkit** | Convert (29 targets) with an optional **watermark**, resize, shrink-for-email, **lossless** JPEG rotate/flip, combine→PDF/CBZ (or a **searchable PDF** with an invisible OCR text layer), batch rename from EXIF/tags **or from a pattern you write**, eyedropper, set-as-folder-icon, **set as wallpaper (Fill · Fit · Span · …) or lock screen**, OCR, strip metadata, upload & copy the link (it shows when the link expires), **copy as data URI**. A batch that partly fails can be **retried for just the files that failed** |
  64. | ⚡ **Parallel batch** | Multi-file Convert / Resize / Rotate / Strip and Combine-to-PDF fan out across **all CPU cores** (6–15× faster): a tiny dependency-free scoped thread pool, no rayon bloat in the shell DLL |
  65. | 🎛️ **Make the menu yours** | The Settings "Menu items" list lets you **drag-reorder** every right-click entry *and* its group dividers: the menu mirrors your layout exactly (WYSIWYG). Tick items off to hide them, or hit **Reset order** for the default |
  66. | 🤖 **CLI + MCP server** | `st2k.exe`: `thumbnail · convert · batch · rotate · ocr · pdf · cbz · …` as a scriptable/AI-agent toolbox (`st2k --mcp`); **`batch`** parallel-processes whole folders in one process. The MCP server adds **`view`** (decode any supported format to a PNG block so an AI agent can *see* the file) and **`compress`** tools |
  67. | 📇 **Details pane & columns** | An **IPropertyStore** handler surfaces image dimensions, EXIF camera info and audio tags in Explorer's Details pane, hover tooltips, and sortable/groupable columns, for the 435 formats Windows can't read itself. Read-only and panic-isolated, like the thumbnailer |
  68. | 🎨 **Colour management** | Embedded **ICC** profiles and wide-gamut images (**Display P3 / Adobe RGB**) render in correct sRGB instead of over-saturated; AVIF/HEIC read their `colr` box (incl. the iPhone-HEIC CICP Display-P3 signal), and **CMYK JPEGs** are colour-managed through their embedded profile; pure-Rust, no C deps |
  69. | 🔧 **Repair file associations** | One button in **Settings ▸ Diagnostics** re-registers SageThumbs for every enabled format when another app has hijacked the thumbnails, then clears the thumbnail cache |
  70. | 🛡️ **Crash-isolated** | Out-of-process, `catch_unwind` under `panic = "abort"`, sandboxed ImageMagick child (CPU-time budget + kill-timeout), decompression-bomb guards |
  71. | 🌗 **Native Win11 UI** | Redesigned **Settings**: a Win11-style category nav rail (General · Appearance · File types · Ebook/comic · Right-click menu · Screenshots · Quick action · Advanced · Quick preview · Data & Backup) with toggle switches, Common-Controls v6, a **search box that finds any setting on any page**, **light/dark theme** (follow Windows, or pick your own), 36 languages |
  72. | 🔤 **Screen OCR** | **Copy text (OCR)** from the screenshot editor (**Ctrl+T**), the Quick preview toolbar, the tray or a global hotkey: drag a region and the words land on your clipboard *and* in an editable window, so a misread is fixable before you paste |
  73. | 💬 **Send feedback** | A box in the About card mails a suggestion, bug report or format request straight to the developer: no GitHub account, no email address required (leave one only if you want a reply), just a tick promising you are not being a jerk. A failed send puts your text on the clipboard so nothing is lost |
  74. | ⌨️ **Keyboard & screen readers** | The Quick preview's caption toolbar and video controls are reachable with **Tab**, walked with the arrow keys and pressed with Enter or Space, with a visible focus ring; **Escape** returns to the content. Every category in the Settings nav rail reports its name and selected state, so Narrator and NVDA announce where you are |
  75. | 🔍 **True transparency** | Real premultiplied-ARGB alpha, so Explorer shows the folder background through a transparent PNG instead of a baked-in grey grid. Prefer the classic look? One switch puts the checkerboard back |
  76. <div align="center">
  77. <img src="assets/screenshots/preview1.png" alt="Windows Explorer showing real thumbnails for camera RAW, PSD, AVIF, OpenEXR, JPEG-XL, comics and more" width="840" />
  78. </div>
  79. ---
  80. ## 🧹 One install, a whole stack gone
  81. One shell extension and one `st2k.exe` do the jobs of the utilities people reinstall on every new Windows box, with no account and no cloud service.
  82. | Instead of installing... | You already have it |
  83. |---|---|
  84. | A **thumbnail or codec pack** (MysticThumbs, FastPictureViewer, Icaros) | Thumbnails for **hundreds of formats**, crash-isolated |
  85. | A **preview-pane** add-on | A large **preview handler** in the reading pane and Open dialogs |
  86. | A **Space-bar preview** app (QuickLook, Seer) | **Tap Space** for an instant full-size preview |
  87. | An **EXIF viewer** (ExifToolGUI, Opanda IExif) | EXIF, GPS and audio tags as **sortable Explorer columns** |
  88. | A **batch converter** (XnConvert, IrfanView) | Right-click **Convert** to ~29 formats, batched across every core |
  89. | A **resizer** (PowerToys Image Resizer) | Right-click **Resize** presets and **Shrink for email** |
  90. | **jpegtran**, or IrfanView's lossless-rotate plugin | **Lossless JPEG rotate / flip** |
  91. | A **color picker** (PowerToys, Just Color Picker) | A **system-wide eyedropper** with a 10x loupe |
  92. | A **metadata scrubber** (ExifCleaner, BatchPurifier) | Right-click **Strip metadata**, ICC profile kept |
  93. | A **screenshot + annotate** app (ShareX, Greenshot, Snagit) | Region or window **capture** with a delay, annotations and quick-save |
  94. | An **OCR** tool (Capture2Text, PowerToys Text Extractor) | **Copy text** off a file or any region of the screen; tables keep their columns |
  95. | An **image uploader** (ShareX, Imgur apps) | **Upload (copy link)** to a keyless host, no account |
  96. | A **PDF / CBZ maker** (PDF24, manual 7-Zip) | **Combine into PDF** or **CBZ** |
  97. | **ImageMagick** for scripts and AI agents | `st2k.exe`: a full CLI **and an MCP server** |
  98. **A dozen-plus tools in one download**, every decoder isolated from Explorer. Nothing stays running unless you turn on the screenshot hotkey or the Space-bar preview.
  99. <sub>Fine print: a few exotic formats lean on codecs already in Windows (WIC) or the bundled ImageMagick; SageThumbs 2K wires them into Explorer. Several tools above are free too; the point is one install instead of a dozen.</sub>
  100. ---
  101. ## ⭐ Like it? Help it grow
  102. Built in the open by one person, free for personal use, no ads; Supporter adds Quick preview, the screenshot tool, OCR, settings sync and the AI assistant tools. If SageThumbs 2K earns a spot on your "install on every new PC" list, a few seconds of support goes a *long* way:
  103. - ⭐ **[Star the repo](https://github.com/LunarWerxs/SageThumbs-2k)**: the single biggest signal that this is worth maintaining.
  104. - 📝 **[Leave a review on SourceForge](https://sourceforge.net/projects/sagethumbs-2k/)**: helps people find a thumbnailer they can actually trust.
  105. - 👍 **[Like it on AlternativeTo](https://alternativeto.net/software/sagethumbs-2k/about/)**: surfaces it for everyone searching for a SageThumbs / DarkThumbs alternative.
  106. Hit a bug, or a format that won't thumbnail? **[Open an issue](https://github.com/LunarWerxs/SageThumbs-2k/issues)**, that helps just as much.
  107. ---
  108. ## 📦 Install
  109. 1. **[Download `SageThumbs2K-Setup-<version>.exe`](https://github.com/LunarWerxs/SageThumbs-2k/releases)** and run it.
  110. 2. That's it: open any folder of exotic images.
  111. - There is **one payload**: the bundled ImageMagick engine is always installed, so every
  112. supported format works out of the box. (Older releases offered a cut-down "Compact" choice
  113. that dropped it; upgrading replaces that with the complete engine.)
  114. - **ARM64** ships as a separate `SageThumbs2K-Setup-<ver>-arm64.exe` for Windows on
  115. Arm, running natively rather than emulated, with the same engine as x64, so format
  116. coverage is identical on both.
  117. > The installer registers a classic shell extension via `regsvr32` and trusts a self-signed cert for the Win11 modern menu. It's a *classic* extension by design (not an MSIX sandbox) because it spawns ImageMagick as a subprocess.
  118. > **First run / SmartScreen:** every release since 3.0.0 is code-signed by LUNARWERX LLC (right-click the installer, Properties, Digital Signatures). A brand-new signed release can still meet a blue **"Windows protected your PC"** screen while it builds download reputation: click **More info → Run anyway**. Every line of the code is right here for you to inspect.
  119. ### Installer vs. portable zip
  120. Prefer nothing touching the registry outside your own account, or can't run an installer at all? Grab the **portable zip** from the same [releases page](https://github.com/LunarWerxs/SageThumbs-2k/releases) instead. It covers most of the app, but not quite everything:
  121. | | Installer | Portable zip |
  122. |---|---|---|
  123. | Explorer thumbnails | ✅ | ✅ (per-user, no admin) |
  124. | Classic right-click menu | ✅ | ✅ (per-user, no admin) |
  125. | Settings, Convert/Resize, Quick preview, screenshots, OCR, eyedropper, CLI | ✅ | ✅ |
  126. | Explorer **preview pane** | ✅ | ❌ |
  127. | **Details pane** (columns, EXIF/tags) | ✅ | ❌ |
  128. | Modern Windows 11 right-click menu | ✅ | ❌ |
  129. The three ❌ rows all need machine-wide registration, which is exactly what the portable zip is built to avoid. If you want those too, use the installer.
  130. A portable copy never sets itself to start with Windows, since that would outlive its folder. To have its tray helper (screenshot hotkeys, Quick preview's Space key) start when you sign in, put a shortcut in your Startup folder (`shell:startup`) whose target ends in `--screenshot-daemon`, for example `"D:\Apps\SageThumbs2K\SageThumbs2K.exe" --screenshot-daemon`. Without that argument the shortcut opens Settings. Thumbnails need nothing running.
  131. ---
  132. ## 🦀 How it works
  133. ```
  134. IThumbnailProvider → runs in Explorer's isolated dllhost surrogate
  135. │ (first tier that decodes wins; SVG detected up front → resvg)
  136. image crate → WIC (OS codecs) → ImageMagick (sandboxed child) → headerless-Targa
  137. (safe Rust) HEIC/RAW the obscure long tail fallback
  138. AVIF: our own decoder (container + colour code, rav1d for AV1) in a throwaway child
  139. │
  140. ▼ premultiplied-BGRA top-down DIB → Explorer (real alpha)
  141. ```
  142. One DLL exposes three COM coclasses: the thumbnail provider, the modern `IExplorerCommand` menu, and a classic `IContextMenu` fallback. Settings live in `HKCU\Software\SageThumbs2K`.
  143. ---
  144. ## 🛠 Built like it matters
  145. Most thumbnail handlers are a weekend hack. This one's been put through the wringer:
  146. - **Crash-proof by design**: a malformed file can't take down Explorer.
  147. - **Zero runtime dependencies**, pure memory-safe Rust core, installs clean every time.
  148. - **Zero-warning linting, supply-chain audits, fuzzing, Miri, and a full test + render-regression suite** gate every release.
  149. - **Hardened against hostile input** and code-signed by LUNARWERX LLC on every release.
  150. - **Color-managed** (ICC/wide-gamut → sRGB) and **obsessively tuned** for speed, size, and a native feel.
  151. ---
  152. ## 🗂 Supported formats
  153. <details open>
  154. <summary><strong>435 extensions</strong> across Image, RAW, Ebook/comics, Document, Audio and Video</summary>
  155. - **RAW**: 3fr, arw, cr2/cr3/crw, dng, erf, iiq, mef, mrw, nef/nrw, orf, pef, raf, rw2, sr2/srw, x3f, …
  156. - **Pro / scientific**: dcm (DICOM), dpx, cin, exr, fits, hdr, pfm
  157. - **Photoshop / paint**: psd/psb, xcf, **gbr/gih/pat** (GIMP brushes and patterns), **psp/pspimage** (Paint Shop Pro), **iff/ilbm/lbm** (Amiga ILBM / Deluxe Paint), pcx, miff, cut
  158. - **Common + modern**: png, jpg, gif, bmp, tiff, webp, heic/heif, avif, jp2, jxl, **jxr/wdp/hdp** (JPEG XR / HD Photo), **dds** (game textures: every block format BC1 to BC7, HDR BC6H included, decoded natively), **vtf/ktx** (Valve and Khronos textures, through the same decoders), **six/sixel** (terminal graphics), avifs, ico, tga, qoi, svg
  159. - **Vector & metafile**: svg/svgz, wmf, emf/emz, **swf** (Adobe Flash movies)
  160. - **Ebook & comics**: epub, mobi/azw/azw3, **prc** (Mobipocket), fb2/fbz, cbz/cb7/cbr/cbt
  161. - **Project / design / CAD**: psd, afphoto/afdesign/afpub, clip, kra, ora, **pxo** (Pixelorama), **aseprite/ase** (Aseprite, rendered), **spla** (SpriteLoop, rendered), **sldprt/sldasm/slddrw** (SolidWorks), **mcworld/mctemplate/mcpack/mcaddon** (Minecraft Bedrock), blend, 3mf, fcstd (plus FreeCAD's fcbak/fcstd1 backups), gcode, **bgcode** (PrusaSlicer binary), **eps** (embedded raster preview only), **sketch, procreate** (digital art), **skp** (SketchUp), **3dm** (Rhino), **dwg** (AutoCAD), **max** (3ds Max), **c4d** (Cinema 4D), **xd** (Adobe XD), **cdr/cdt/cmx** (CorelDRAW / Corel Exchange), **dxf** (AutoCAD preview), **xmind** (mind maps), **nupkg/vsix/appx/msix/appxbundle/msixbundle/crx** (package and extension icons)
  162. - **Retro**: **pi1–pi3/pc1–pc3** (Atari ST DEGAS), **tny/tn1–tn3** (Atari ST Tiny), **koa/kla/fli** (Commodore 64), **ham/sham** (Amiga HAM), wbmp, otb, mtv, aai, avs, hrz, xwd, Sun raster, all read natively
  163. - **Icons**: ico, cur, **ani** (animated cursors), **icns** (Apple)
  164. - **Docs & audio**: pdf, **doc/docx/docm, xls/xlsx/xlsm/xlsb, ppt/pptx/pptm/ppsx** (MS Office), odt/ods/odp, **key/pages/numbers** (Apple iWork), **indd/indt** (InDesign), **vsd/vsdx/vsdm/vstx/vssx** (Visio), **pub** (Publisher), djvu, **txt/md/json/xml/log/csv/ini/reg/rtf/nfo/diz** (text, off by default) + mp3/flac/ogg/opus/m4a/wma/**dsf** (DSD)/ape/…
  165. - **Video**: mkv/mk3d/webm, mp4/m4v/lrv/mov, avi, wmv, flv, mpg/mpeg/m1v/m2v/mpv/mp2v/m2p, vob, 3gp/3g2, ts/m2ts/mts/m2t/trp, ogv, divx, …: a representative frame (30% in by default, adjustable in Settings) via the OS **Media Foundation** codecs, plus **FLV** (VP6 / Sorenson Spark), **HDR VP9** (Profile 2/3, 10- and 12-bit) and **MPEG-1/2** (VideoCD-era `.mpg`, bare `.m1v`/`.m2v`, DVD-style `.vob`, and MPEG-2 inside `.ts`/`.m2ts`/`.mts` recordings) decoded by SageThumbs itself in a short-lived helper process
  166. *(PostScript without an embedded raster preview and font-only ImageMagick coders are excluded for safety; PDF uses the in-box OS renderer. Video frames normally come from Windows' own Media Foundation codecs. Where Windows has no codec (FLV's VP6 and Sorenson Spark, VP9 Profile 2/3 HDR, 10-bit H.264, and MPEG-1/2 in program, elementary and transport streams), SageThumbs decodes the frame itself in a separate short-lived process, so a corrupt file costs one thumbnail rather than disturbing Explorer. Anything neither side can decode keeps its default icon.)*
  167. </details>
  168. ---
  169. ## FAQ
  170. <details>
  171. <summary><b>Is SageThumbs 2K free?</b></summary>
  172. Yes, for personal use, under the [PolyForm Noncommercial License 1.0.0](#-license): thumbnails,
  173. Explorer's preview pane and the right-click menu (its OCR items aside).
  174. **Supporter** (home use, **US$2 a month** or **US$20 a year**) adds Quick preview (press Space on any file), the screenshot tool, OCR, settings sync across PCs and the tools AI assistants use;
  175. each one is free for 14 days from the first time you use it, no card or sign-up, and the Business subscription below includes all five. Commercial
  176. use needs a Business license per Windows installation ([Terms of Service](https://terms.connections.icu/public/terms/sagethumbs-2k)). It is a subscription: **US$5 a month** or **US$50 a year**, per installation. It covers that installation for as long as the subscription is paid. Paying for one month covers one month; it does not buy a permanent licence. When it ends, that installation is no longer licensed for commercial use, and SageThumbs 2K asks for a key again. **To start the free 7-day business trial, choose Business when the installer asks:** every feature works for 7 days with no key, account or card. It includes commercial (work) use, every Supporter feature, priority support, and every paid feature added later. Home use stays free and keeps updating. Security fixes reach every licensed installation. Subscribe [yearly](https://go.lunarwerx.com/sagethumbs/buy) or [monthly](https://go.lunarwerx.com/sagethumbs/buy/monthly); manage or cancel at [go.lunarwerx.com/sagethumbs/manage](https://go.lunarwerx.com/sagethumbs/manage)
  177. (the checkout page calls what it emails you a "redemption code"; that is the seat key below,
  178. same thing). For volume or site licenses, purchase orders or bank transfer,
  179. [request a quote](https://github.com/LunarWerxs/SageThumbs-2k/issues/new?template=licence_quote.yml).
  180. A business license comes as a seat key (`esk_...`); redeem it under
  181. **Settings ▸ Licence** and the app takes it from there. The installer asks whether a copy is
  182. for personal or business use. A copy installed as Personal can switch to Business at any time:
  183. **Settings ▸ Licence ▸ Start 7-day business trial** (Windows asks an administrator to confirm).
  184. Going back to Personal needs a reinstall, there's no toggle for it in Settings. A portable copy has no installer to ask, and counts as business use as soon
  185. as a key is redeemed on it. A business copy starts its 7-day trial with every feature; after
  186. that it asks for a key for 3 more days, then thumbnails, previews, the Details pane and the
  187. right-click menu stop on that computer until one is entered. Once a key is in, the license check runs quietly in the background and
  188. tolerates being offline for about a week. Personal use has no ads and no paywall, just a single
  189. free download built and maintained by one person.
  190. </details>
  191. <details>
  192. <summary><b>What are the system requirements?</b></summary>
  193. Windows 11, 64-bit. It ships as a native x64 installer, plus a separately built native ARM64
  194. installer for Windows on Arm with the same format coverage. There's also a portable zip for
  195. per-user use with no admin rights. No other software is required: the installer bundles
  196. everything it needs, including the ImageMagick engine used for the more obscure formats.
  197. </details>
  198. <details>
  199. <summary><b>Does it replace File Explorer, or install its own file browser?</b></summary>
  200. Neither. It's a shell extension that plugs into the existing File Explorer: same windows, same
  201. navigation, just real thumbnails, a right-click toolkit, and a Space-bar preview added on top.
  202. Nothing about how you browse files changes.
  203. </details>
  204. <details>
  205. <summary><b>Why did Windows or my antivirus flag the installer?</b></summary>
  206. **3.0 and later are code-signed by LUNARWERX LLC** through Azure Artifact Signing, every
  207. installer, the shell extension, the app and the command-line tool. Right-click the file,
  208. Properties, Digital Signatures, and the signer is there to check. The signature is what removes
  209. the machine-learning "unknown binary" verdicts that releases up to 2.5 collected.
  210. Scanners that judge what a program *does* while it installs (Kaspersky's among them) are a
  211. separate case. Since 3.7.1 setup no longer writes itself into the Windows Run list, creates its
  212. scheduled tasks through `schtasks.exe`, or ends Explorer to restart it. Measured on 2026-10-08,
  213. every 3.7.1 file, both installers included, had 0 detections on VirusTotal, Kaspersky clean.
  214. Releases before 3.0 were unsigned, and every release is a brand-new file the world has never
  215. seen. That is a *reputation* verdict, not a finding about the code, and the detection names
  216. say so themselves: Microsoft's `Wacatac.B!ml` ends in `!ml`, its own marker for "a
  217. machine-learning model guessed"; Fortinet reports `PossibleThreat`; Rising reports
  218. `Undefined`; Skyhigh reports `BehavesLike`. None of them claims to have recognised anything
  219. specific.
  220. Two measurements, taken on 2026-08-31 on the unsigned builds, if you would rather not take our
  221. word for it. They are dated on purpose: these numbers move, which is the entire point being
  222. made.
  223. - **The count moves on its own, with no change to the software.** A freshly built installer,
  224. the same product, scanned the same day: **2 of 71** engines. The published build of that
  225. identical version, four days and a few hundred downloads later: **9 of 71**. Same program,
  226. same code, engines simply score a file more as it circulates. Older releases settle back
  227. down again (1.2.2 sits at 1 of 75).
  228. - **Removing half the installer changes nothing.** We built a variant with the entire bundled
  229. ImageMagick engine stripped out, halving the download, and scanned both within ten minutes of
  230. each other: 2 of 71 with it, 3 of 70 without. The size and contents are not what is being
  231. scored.
  232. Every release is code-signed by LUNARWERX LLC and lists each file's SHA-256, so you can check
  233. that the file you downloaded is the one published. For the current engine ratio and the exact
  234. detection names, look that SHA-256 up on VirusTotal rather than trusting one popup's opinion.
  235. If your antivirus quarantines it, reporting it as a false positive to *your* vendor genuinely
  236. helps, those reports are what clear it for everyone else using that product, and since 3.0
  237. there is a signed publisher for them to attach it to.
  238. SmartScreen's "Windows protected your PC" screen is a separate thing: it is a no-history-yet
  239. reputation prompt rather than a malware verdict, and a signature does not silence it on day
  240. one. Reputation is earned per publisher over downloads, so it can still appear for a while
  241. after 3.0. Click **More info**, then **Run anyway**.
  242. </details>
  243. <details>
  244. <summary><b>How is it different from the original SageThumbs, or a tool like MysticThumbs?</b></summary>
  245. It's a clean-room rebuild of the classic, long-abandoned SageThumbs (2004-2019, GPLv2, no
  246. GFL reused), written from scratch in memory-safe Rust. Compared to a codec-pack style
  247. thumbnailer like MysticThumbs, its thumbnail provider runs out-of-process and panic-guarded, so
  248. a corrupt or hostile file can't take down Explorer the way an in-process crash can.
  249. </details>
  250. <details>
  251. <summary><b>Does the Space-bar preview work with the Everything search tool?</b></summary>
  252. Yes, both Everything 1.4 and 1.5, installed or portable. Click a result first, since Space typed
  253. into the search box just types a space. If Everything itself runs as administrator, Windows
  254. blocks the keypress from reaching any normal program; binding a hotkey with Ctrl, Alt, or Shift
  255. in Settings works around that, because Windows delivers hotkeys differently than typed keys.
  256. </details>
  257. <details>
  258. <summary><b>How many formats does it support, and can more be added?</b></summary>
  259. 435 as of this README, across image, camera RAW, ebook/comic, document, audio, and video; run
  260. `st2k formats` for the live, per-category count. New formats are considered when they can be
  261. read without a heavy dependency, many "project" file formats bake in a preview image that's
  262. cheap to extract. Request one through Send Feedback in the app or a GitHub issue.
  263. </details>
  264. ## 📜 License
  265. **[PolyForm Noncommercial License 1.0.0](https://github.com/LunarWerxs/SageThumbs-2k/blob/main/.github/LICENSE.md)**: free to use, modify, and share for any **noncommercial** purpose. **Commercial use requires a separate license** ([Terms of Service](https://terms.connections.icu/public/terms/sagethumbs-2k)), per Windows installation. It is a subscription: **US$5 a month** or **US$50 a year**, per installation. It covers that installation for as long as the subscription is paid. Paying for one month covers one month; it does not buy a permanent licence. When it ends, that installation is no longer licensed for commercial use, and SageThumbs 2K asks for a key again. It includes commercial (work) use, every Supporter feature, priority support, and every paid feature added later. Security fixes reach every licensed installation. Subscribe [yearly](https://go.lunarwerx.com/sagethumbs/buy) or [monthly](https://go.lunarwerx.com/sagethumbs/buy/monthly) (card via Stripe; one key per installation is emailed on payment). It comes as a seat key (`esk_...`), redeemed under **Settings ▸ Licence**. For volume or site licences, purchase orders or bank transfer, [request a quote](https://github.com/LunarWerxs/SageThumbs-2k/issues/new?template=licence_quote.yml). The installer asks Personal or Business up front and that choice only changes by reinstalling. To start the free 7-day business trial, choose Business when the installer asks: every feature works for 7 days with no key, account or card, then 3 days of reminders, then thumbnails, previews, the Details pane and the right-click menu stop on that computer until a key is entered; once it is, the background license check tolerates about a week offline. © 2026 Lunarwerx.
  266. SageThumbs 2K is a **clean-room rewrite**, **not** a derivative of the GPLv2 C++ original, and it uses **no GFL**. Every decoder is pure-Rust or an OS codec (RAR/CBR comics use the pure-Rust [`rars`](https://crates.io/crates/rars) crate, no proprietary UnRAR), so the project's own code is entirely original and its dependencies are permissively licensed, which is what lets us license it as we choose. The optional bundled ImageMagick (for the exotic long tail) ships under its own permissive license and runs only as a sandboxed subprocess.
  267. ## 🙏 Credits
  268. A from-scratch successor to Nikolay Raspopov's original **[SageThumbs](https://github.com/raspopov/SageThumbs)** (2004–2019, GPLv2, now unmaintained), rebuilt clean-room in Rust, with our thanks for the classic that inspired it. Built on [image-rs](https://github.com/image-rs/image), [resvg](https://github.com/linebender/resvg), [windows-rs](https://github.com/microsoft/windows-rs), [djvu-rs](https://crates.io/crates/djvu-rs), and [ImageMagick](https://imagemagick.org/).
  269. With thanks to the projects that shaped specific features:
  270. - [**DarkThumbs**](https://github.com/fire-eggs/DarkThumbs): the model for the ebook & comic cover thumbnails (EPUB / MOBI / FB2 / CBZ…).
  271. - [**Flameshot**](https://flameshot.org/): inspiration for the screenshot capture + annotation flow.
  272. - [**XnShell / XnView**](https://www.xnview.com/): inspiration for the right-click image toolkit and shell-menu UX.
  273. - [**Calibre**](https://calibre-ebook.com/): reference for ebook formats and cover extraction.
  274. <div align="center">
  275. Made by [LunarWerx Studios](https://lunarwerx.com): also see [RepoYeti](https://repoyeti.com), [QuickDictate](https://quickdictate.lunarwerx.com), and [WatchArr](https://watcharr.lunarwerx.com).
  276. <sub>Made with 🦀 for people who have too many weird files.</sub>
  277. </div>
  278. ## ⭐ Star history
  279. <a href="https://www.star-history.com/?repos=lunarwerxs%2Fsagethumbs-2k&type=date&legend=bottom-right"><img src="https://api.star-history.com/svg?repos=lunarwerxs%2Fsagethumbs-2k&type=Date&theme=dark&legend=bottom-right" width="100%" alt="SageThumbs 2K GitHub stars over time"></a>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.