RivePeek v0.2.0

RivePeek v0.2.0 — animated Rive .riv previews and
thumbnails in Windows File Explorer.

This release adds the two biggest missing pieces from v0.1.0 — text and
layout — plus full blend-mode support, idle/focus handling, and crash
hardening.

What's new since v0.1.0

• 🔤 Text rendering — WITH_RIVE_TEXT enabled, shaping via HarfBuzz +
  SheenBidi (statically linked). Text runs, embedded and variable fonts render.
• 📐 Flexbox layout — WITH_RIVE_LAYOUT enabled, backed by Yoga, so
  layout-driven and responsive artboards position correctly (previously they
  collapsed or fell back to authored size).
• 🎨 Full blend modes — all 15 Rive blend modes composite via the Direct2D
  Blend effect (ID2D1DeviceContext), with a clean srcOver fallback.
• 💤 Idle pause + focus-safe — animation pauses when the host/preview isn't
  in the foreground, and resizes use SWP_NOACTIVATE so the pane never steals
  keyboard focus from Explorer's file list.
• 🛡️ Crash hardening — file load / advance / draw / teardown run under SEH,
  so a pathological file degrades to a blank preview instead of crashing the host.

Carried over from v0.1.0

• 🎬 Animated preview pane (IPreviewHandler), isolated in prevhost.exe.
• 🖼️ Static first-frame thumbnails (IThumbnailProvider).
• 🔒 Per-user install under HKCU, no administrator rights.
• Self-contained RivePeek.dll (static CRT, no runtime redistributable).

Validated against 887 marketplace .riv files — 886 render (99.9%).

Install (per-user, no admin)

Option A — MSI: download and run RivePeek-0.2.0-x64.msi (choose
just-me or all-users).

Option B — portable zip:

1. Download RivePeek-v0.2.0-win-x64.zip and extract somewhere stable
   (e.g. %LOCALAPPDATA%\RivePeek\).
2. From the extracted folder:

   .\install\register.ps1 -Dll "$PWD\RivePeek.dll"

3. In Explorer, press Alt + P for the preview pane and select a .riv file.

Uninstall: .\install\unregister.ps1 (or via Apps & features for the MSI).
Requires 64-bit Windows 10 / 11.

Known limitations

• Audio and scripting (Rive's experimental scripted objects) are not
  supported; such objects are skipped on import.
• A blended shape inside a clip composites against the pre-clip backdrop.
• Supports Rive major-version 7 files.

Checksums (SHA-256)

RivePeek.dll                     BF2FDDC76937EAA2CAD0A38FF29BFABF6001E5F479AFED151A30CF3585A25EF6
RivePeek-0.2.0-x64.msi           D25CB02B433A12A403B56E5F2AC60345BC96877CFBF9C46DA3027902A395ACAF
RivePeek-v0.2.0-win-x64.zip      053D6DF136BEE8174748079A47658BBAA925C65087B5736A14E4426219A7B970

Built from the source at this tag with build\build_all.bat
(MSVC v143 + Windows SDK). Not yet code-signed.

RivePeek v0.1.0

First release of RivePeek — a native Windows Shell extension that renders
Rive .riv files in File Explorer.

Features

• 🎬 Animated preview pane (IPreviewHandler) — the default artboard's state
  machine / first animation plays live, isolated in prevhost.exe.
• 🖼️ Static thumbnails (IThumbnailProvider) — first-frame .riv thumbnails
  as grid icons.
• 🪶 Dependency-free — Direct2D + WIC backend over the core Rive C++ runtime;
  RivePeek.dll is self-contained (static CRT, no runtime redistributable).
• 🔒 Per-user install — registers under HKCU, no administrator rights.

Validated against 887 marketplace .riv files — 886 render (99.9%).

Install (per-user, no admin)

1. Download RivePeek-v0.1.0-win-x64.zip and extract it somewhere stable
   (e.g. %LOCALAPPDATA%\RivePeek\).
2. From the extracted folder:

   .\install\register.ps1 -Dll "$PWD\RivePeek.dll"

3. In Explorer, press Alt + P for the preview pane and select a .riv file.

Uninstall: .\install\unregister.ps1.

Requires 64-bit Windows 10 / 11.

Known limitations

• Text and Yoga-based layout are not yet rendered (planned — see the roadmap).
• Blend modes other than srcOver fall back to srcOver.
• Supports Rive major version 7 files.

Checksums (SHA-256)

RivePeek.dll                     C01995041C5C3DFF00F42F1FB13BA0572FCB9286CDC52861F9243FA8ECAC6B21
RivePeek-v0.1.0-win-x64.zip      B56FB906D32026F00DCB87E2A75233C650632B6E86FC210F4C68F5D21BD0E097

Built from the source at this tag with build\build_all.bat
(MSVC v143 + Windows SDK).