v0.6.1 | Smaller Packages, Video Recovery & Refreshed SDKs

FiLens v0.6.1 includes CLI 0.5.1, Browser Preview 0.3.1 and mobile source SDKs 0.1.1. The CLI bundles include the current offline preview runtime; file parsing and conversion share the frontend WASM core.

Changes

• Preserve video position, play/pause state, volume, mute and playback speed when optional browser recovery switches from native playback to MSE. This adopts the useful playback handoff behavior reviewed in share-front without adding runtime dependencies. Bounded Range reads and binary-search keyframe lookup were already present in the shared Media Engine.
• Improve HEIF color handling, including 10/12-bit and HDR-related metadata paths, and expose optional local MP4/MOV recovery through browserMedia: true. Native playback remains the first attempt.
• Improve dual-fisheye panorama registration, polar handling and seam visibility, and refresh the CLI file-walker resource.
• Compact standalone JavaScript while retaining its existing chunk graph. Compress CLI WASM resources at gzip level 9. Replace huge generated iWork literal declarations with interface types; omit debug maps from production module tarballs while retaining local maps.

Downloads

Artifact	Download	Extracted / installed
Browser preview 0.3.1 · split	3.56 MiB	11.38 MiB
Browser preview 0.3.1 · all-in-one	3.58 MiB	9.00 MiB
filens-preview 0.3.1 npm tarball	7.14 MiB	20.40 MiB
iOS source SDK 0.1.1	3.59 MiB	11.43 MiB
Android source SDK 0.1.1	3.59 MiB	11.42 MiB
darwin-arm64 · CLI lite	9.49 MiB	16.80 MiB
darwin-arm64 · CLI full	23.61 MiB	39.99 MiB
linux-x64 · CLI lite	10.24 MiB	16.54 MiB
linux-x64 · CLI full	26.19 MiB	45.48 MiB
linux-arm64 · CLI lite	10.14 MiB	16.43 MiB
linux-arm64 · CLI full	23.88 MiB	39.84 MiB
win32-x64 · CLI lite	10.19 MiB	16.46 MiB
win32-x64 · CLI full	26.42 MiB	45.22 MiB

MiB = 1,048,576 bytes. Native Full bundles include OCR and verified models; Lite leaves OCR optional. Each native bundle includes the preview runtime, archive sidecars and Agent skill, and needs no Node.js, npm or Python. Mobile downloads are source SDKs with offline assets, rather than precompiled AAR/XCFramework files. Linux x64/arm64 and Windows x64 bundles were cross-built; native execution was verified on macOS arm64.

Mobile integration guide · Preview API · CLI guide.

Size changes

Compared with the published v0.6.0 artifacts, the preview npm download changes from 6.98 to 7.14 MiB (+2.3%), while installed files decrease from 21.72 to 20.40 MiB (-6.1%). The all-in-one browser ZIP is 3.58 MiB, with 9.00 MiB extracted files (-7.4%). Mobile SDK downloads are 3.59 MiB each, with extracted files down about 5%. Compressed downloads still grow because of the HEIF and optional media additions.

Against the same current source before this optimization review, the preview download is 4.3% smaller, installed files 11.3% smaller, and all-in-one JavaScript 14.5% smaller. The iWork package files (excluding transitive dependencies) shrink from 9.95 to 3.52 MiB installed (-64.6%). CLI Lite/Full installed packages save about 0.19 MiB per platform.

Comparison and exact byte deltas · All module tarball sizes.

npm availability

filens-cli@0.5.1, filens-cli-lite@0.5.1, filens-preview@0.3.1 and all eight platform components are publicly available. Their registry integrity matches the tested tarballs. Fresh-cache public registry Full/Lite installation, OCR and first-use preview tests passed; the public preview package also passed the complete browser and TypeScript consumer checks. Publication observations.

npm install -g filens-cli@0.5.1
# Or: npm install -g filens-cli-lite@0.5.1
npm install filens-preview@0.3.1
``` The exact tested preview tarball is available directly from this Release:

```sh
npm install https://github.com/IceWhaleTech/filens/releases/download/v0.6.1/filens-preview-0.3.1.tgz

All 18 @filens/*@0.1.0 module uploads have been accepted by npm. Seventeen modules are publicly available with verified integrity; @filens/converter-client@0.1.0 is still being processed by npm. The EPUB/CBZ module is published as @filens/books because npm rejected the original @filens/ebook name. Its driver API is unchanged, and text/Vue dependencies use the published name. Live module publication observations. The existing filens-step@0.1.0-rc.1 is unchanged.

Validation and limits

• Workspace suites: 1,854 passed, 11 skipped; the additional recovery continuity tests also passed. All 336 iWork and 176 panorama tests passed. CLI Rust tests: 16 passed.
• All 18 module tarballs installed together outside the workspace and passed strict public declaration checks. Required Three.js type dependencies are included for 3D and panorama consumers.
• Final preview tarball: isolated installation, public TypeScript imports, 48 real browser previews, HEIF reference-pixel checks and both exports after production Vite bundling passed.
• Final mobile runtime and bridges: 22 Chromium/WebKit checks passed. Final CLI npm Full/Lite offline installation, native OCR, conversion and first-use preview passed.
• Real Chromium media checks cover native playback, native-to-MSE continuity for paused/playing sessions, bounded Range reads, paused seeking, offline Blob playback and resource cleanup. Release privacy and size gates passed.
• No new physical-device or full native mobile SDK build validation was performed for this patch. Format fidelity and codec/device support follow the support matrix.

SHA256SUMS · Versions, sizes and source manifest. First-party source is MIT; retain all supplied dependency notices when redistributing.