Skip to content

Releases

v0.6.7 | FiLens Branding & Repository Update

Choose a tag to compare

@orca-zhang orca-zhang released this 13 Nov 14:48

v0.6.7 — FiLens branding and repository update

Released 2026-11-13. CLI 0.5.7 · preview 0.3.7 · iOS/Android source SDKs 0.1.7 · DSH plugin and bundled workspace 0.1.10 · Vue wrapper 0.1.5.

Preview watermarks and the DSH File workspace footer now display only FiLens. This includes fullscreen previews, hidden-toolbar views, standalone browser builds, exported offline HTML and mobile SDK runtimes. Repository, release, installation and source links use orca-zhang/filens.

CLI 0.5.7 is rebuilt for macOS arm64, Linux x64/arm64 and Windows x64 so exported HTML includes the updated GitHub link. Its npm launchers pin preview 0.3.7. Full offline bundles include that runtime; Lite can load it with --assets or FILENS_PREVIEW_DIR. Conversion engines, OCR libraries and models are retained byte-for-byte from verified v0.6.6 bundles.

预览区右下角水印和 DSH 文件工作台页脚统一仅显示 FiLens,移除 IceWhale / IceWhaleTech 署名。仓库与下载链接统一使用 orca-zhang/filens。完整离线包、移动端源码 SDK 与 DSH 内置工作台均已更新。

Downloads

File Download size
filens-preview-0.3.7-split.zip 5.62 MiB
filens-preview-0.3.7-all-in-one.zip 10.61 MiB
filens-ios-sdk-0.1.7.zip 5.64 MiB
filens-android-sdk-0.1.7.zip 5.65 MiB
filens-0.5.7-macos-arm64-lite.tar.gz 7.17 MiB
filens-0.5.7-macos-arm64-full.tar.gz 31.91 MiB
filens-0.5.7-linux-x64-lite.tar.gz 7.01 MiB
filens-0.5.7-linux-x64-full.tar.gz 33.58 MiB
filens-0.5.7-linux-arm64-lite.tar.gz 6.90 MiB
filens-0.5.7-linux-arm64-full.tar.gz 31.26 MiB
filens-0.5.7-windows-x64-lite.zip 6.96 MiB
filens-0.5.7-windows-x64-full.zip 33.80 MiB
dsh-filens-0.1.10.tgz 5.81 MiB

SHA256SUMS · Source and validation manifest.

Installation

npm install -g filens-cli@0.5.7
# Or: npm install -g filens-cli-lite@0.5.7
npm install filens-preview@0.3.7
# Vue integration: npm install @filens/vue@0.1.5
dsh plugin --profile desktop add dsh-filens@0.1.10

DSH also accepts the downloadable dsh-filens-0.1.10.tgz through its plugin installer. The file workspace is included in the same package and keeps its independent switch. Mobile ZIPs contain source SDKs with offline resources, rather than precompiled AAR/XCFramework binaries.

Validation

  • 64 previews from an isolated preview-package installation, public TypeScript imports, media checks and 12 previews after production Vite bundling.
  • 51 offline HTML cases across Chromium, Firefox and WebKit; 22 mobile runtime/bridge checks across Chromium and WebKit.
  • 34 DSH Node tests, 16 isolated format-loading paths, 12 complete browser previews and 25 real Desktop 0.2.2-rc.1 workspace checks.
  • Actual computed watermark text checked in normal, hidden-toolbar and fullscreen layouts for split, all-in-one and embedded DSH builds; the DSH workspace footer and GitHub link are also checked.
  • Native macOS npm Full/Lite installations, OCR, reading, search, conversion, first-use preview setup and direct execution without Node/Python; archive integrity, privacy and size limits.

Linux/Windows executables are cross-built; native execution was not retested. Physical mobile devices were not retested. WebKit retains the documented iWork file:// worker restriction, with local HTTP compatibility verified.

Release checks · Watermark checks · Native payload checks · Support matrix.

v0.6.6 | File Workspace for DSH & Localized Previews

Choose a tag to compare

@orca-zhang orca-zhang released this 06 Nov 09:57
Download Link Download size
CLI Lite: darwin-arm64 filens-0.5.6-macos-arm64-lite.tar.gz 7.17 MiB (7,518,522 bytes)
CLI Full (OCR): darwin-arm64 filens-0.5.6-macos-arm64-full.tar.gz 31.91 MiB
CLI Lite: linux-arm64 filens-0.5.6-linux-arm64-lite.tar.gz 6.90 MiB (7,237,877 bytes)
CLI Full (OCR): linux-arm64 filens-0.5.6-linux-arm64-full.tar.gz 31.26 MiB
CLI Lite: linux-x64 filens-0.5.6-linux-x64-lite.tar.gz 7.01 MiB (7,353,759 bytes)
CLI Full (OCR): linux-x64 filens-0.5.6-linux-x64-full.tar.gz 33.58 MiB
CLI Lite: win32-x64 filens-0.5.6-windows-x64-lite.zip 6.96 MiB (7,296,027 bytes)
CLI Full (OCR): win32-x64 filens-0.5.6-windows-x64-full.zip 33.80 MiB
Browser runtime: split filens-preview-0.3.6-split.zip 5.62 MiB
Browser runtime: all-in-one filens-preview-0.3.6-all-in-one.zip 10.61 MiB
iOS source SDK filens-ios-sdk-0.1.6.zip 5.64 MiB
Android source SDK filens-android-sdk-0.1.6.zip 5.65 MiB
dsh-filens 0.1.9 dsh-filens-0.1.9.tgz 5.81 MiB
Checksums SHA256SUMS SHA-256
Build manifest filens-release-v0.6.6.json Versions, sizes and validation

13 package downloads + manifest + checksums (15 assets). Full includes OCR runtime/models and preview 0.3.6. All Lite downloads remain below 10,000,000 bytes with reading, search and conversion retained; preview/OCR assets are optional. Mobile ZIPs are source SDKs, not precompiled AAR/XCFramework files. DSH includes File workspace in a single plugin download. MiB = 1,048,576 bytes.

Changelog

Compared with v0.6.5. Components: DSH 0.1.9, preview 0.3.6, mobile source SDKs 0.1.6, and CLI/OCR 0.5.6. Native CLI/OCR and WASM payloads are retained byte-for-byte from verified v0.6.5 archives; Full bundles refresh the preview assets. npm CLI 0.5.6 retains its preview 0.3.4 setup pin. The ZimaOS Mod Store package remains 0.5.1.

DSH 0.1.9 compatibility patch

  • Verified with the installed macOS arm64 DSH Desktop 0.2.2-rc.1: 34 Node tests, 25 workspace checks and six real sidebar formats. Compatibility and installation evidence.
  • Support DSH 0.2.2-rc.1 and Cordis 4.1, with matching engine and peer declarations. Keep the previously validated rc.5/alpha.3 declarations.
  • Install only dsh-filens@0.1.9: File workspace is included and retains its own switch. No standalone workspace package is needed.

File workspace for DeepSeek Harness

  • Open a full-page workspace with its own plugin switch, alongside independent sidebar Preview and document Tools.
  • Collect supported local references and attachments from paginated conversation history. Deduplicate files while retaining every source occurrence; return to the exact message or its originating question.
  • Collapse sessions into cards with short titles and up to four representative previews. Office/PDF thumbnails use the real renderer; unavailable thumbnails have recognizable file-type covers.
  • Find related files by shared message, question, folder or session, with an explanation for each recommendation and no model calls.
  • Exclude paths and attachments only after DSH confirms they no longer exist. Refresh rechecks availability; opening removes stale cards, navigation and recommendations after deletion. Keep permission and connection failures visible.
  • Hide lock, editor and system temporary artifacts by default, with a reveal button. Useful outputs in OS temporary directories remain visible; filtering does not delete files.
  • Add a ZimaOS Photos-style details panel, actual file sizes, a 144–160px reader list and narrow-window layouts. Fix clipped zoom percentages, workspace activation and module naming.

File workspace recorded in DSH Desktop

Install both plugins, then reopen DSH Desktop:

dsh plugin --profile desktop add dsh-filens@0.1.9

Localized controls and real Desktop demos

  • Localize panorama hints, playback controls, tooltips and accessible labels through all 28 existing language dictionaries. Changing language preserves the video and playback position.
  • Preserve original video duration while progressive playback updates buffered segments.
  • Record six Chinese/English demos separately in the installed DSH Desktop: Office, 3D/panoramas and File workspace. Office uses the matching 14-slide FiLens introduction PPTX; Chinese Word bodies, spreadsheet headings and sheet names are localized.
  • Update both READMEs with measured package/runtime sizes and current format counts: 450 preview source extensions (451 routes including internal cad-json) and 349 CLI extensions. Registration counts are not a claim that every format was retested.

English demos and release notes · 中文演示与发布说明 · Media and original recording provenance

The linked recordings were refreshed with FiLens DSH 0.1.10, preview 0.3.7 and CLI 0.5.7 to display the current FiLens branding; they are not fresh performance benchmarks. Existing DSH speed comparisons retain their 0.1.3 measurement versions. Files stay in their original locations; deleted or inaccessible files cannot be previewed, and browser-selected files need reopening after reload.

npm packages and offline bundles

  • Publish dsh-filens@0.1.9 and filens-preview@0.3.6; verify public tarballs and their latest tags.
  • Publish @filens/core@0.1.4, @filens/vue@0.1.4, @filens/media@0.1.3 and @filens/panorama@0.1.3, with updated minimum dependency versions.
  • Bundle the private File workspace implementation inside the DSH adapter; verify module dependencies before promoting their latest tags.
  • Refresh browser archives, mobile source SDKs and Full native bundles with preview 0.3.6. Keep parsing and conversion in the shared frontend/WASM core.

Validation includes final packaged-runtime browser tests, offline HTML previews, Chromium/WebKit mobile bridges, desktop workspace regressions and public artifact integrity checks. Linux/Windows native execution and physical mobile-device tests were not repeated. See release validation for exact scope.

Use FiLens on ZimaOS

ZimaOS: a personal cloud with FiLens integration

Install from the official ZimaOS Mod Store:

sudo zpkg update
sudo zpkg install filens
# For an existing installation:
sudo zpkg upgrade filens

Official Mod Store entry · ZimaOS integration and OCR setup

The store package remains 0.5.1 (CLI 0.5.0 / preview 0.2.0); this release does not update the store entry.

v0.6.5 | Direct DWG Previews & Smaller Offline Bundles

Choose a tag to compare

@orca-zhang orca-zhang released this 05 Nov 11:11
Download Link Download size
CLI Lite: darwin-arm64 filens-0.5.6-macos-arm64-lite.tar.gz 7.17 MiB (7,518,519 bytes)
CLI Full (OCR): darwin-arm64 filens-0.5.6-macos-arm64-full.tar.gz 31.89 MiB
CLI Lite: linux-x64 filens-0.5.6-linux-x64-lite.tar.gz 7.01 MiB (7,353,756 bytes)
CLI Full (OCR): linux-x64 filens-0.5.6-linux-x64-full.tar.gz 33.56 MiB
CLI Lite: linux-arm64 filens-0.5.6-linux-arm64-lite.tar.gz 6.90 MiB (7,237,880 bytes)
CLI Full (OCR): linux-arm64 filens-0.5.6-linux-arm64-full.tar.gz 31.24 MiB
CLI Lite: win32-x64 filens-0.5.6-windows-x64-lite.zip 6.96 MiB (7,296,027 bytes)
CLI Full (OCR): win32-x64 filens-0.5.6-windows-x64-full.zip 33.78 MiB
Browser runtime: split filens-preview-0.3.5-split.zip 5.61 MiB
Browser runtime: all-in-one filens-preview-0.3.5-all-in-one.zip 10.59 MiB
iOS source SDK filens-ios-sdk-0.1.5.zip 5.63 MiB
Android source SDK filens-android-sdk-0.1.5.zip 5.64 MiB
DSH plugin 0.1.6 (unchanged) dsh-filens-0.1.6.tgz 6.53 MiB
Checksums SHA256SUMS SHA-256
Build manifest filens-release-v0.6.5.json Versions, sizes and validation

13 package downloads + manifest + checksums (15 assets). Full includes OCR runtime/models and preview 0.3.5. Lite retains reading, search and conversion with OCR/preview assets optional. All four Lite archives are below 10,000,000 bytes (10 MB); native packaging and release aggregation reject archives at or above this limit. Mobile ZIPs are source SDKs. MiB = 1,048,576 bytes.

Changelog

Compared with v0.6.4. Components: browser preview 0.3.5, iOS/Android source SDKs 0.1.5, and CLI 0.5.6 with smaller Lite bundles and refreshed Full preview assets. The CLI/OCR binaries and resources are retained byte-for-byte from their verified v0.6.4 bundles. DSH 0.1.6 is unchanged and still embeds preview 0.3.4. The initial GitHub publication kept npm versions unchanged; see the npm follow-up below.

Direct DWG previews and smaller downloads

  • Decode DWG into the versioned cad-json drawing model and render it directly, removing DXF serialization and reparsing from previews. Explicit DWG → DXF export remains in the shared frontend WASM core.
  • Load the dedicated CAD reader independently from raster decoders in the split build. Its 442,809-byte gzip engine is 77.6% smaller than the graphics engine distributed in preview 0.3.4. The shared host and renderer are additional assets. Existing graphicsWasm integrations retain their combined-engine fallback; custom hosts can supply cadWasm.
  • Cache reusable block definitions while preserving each insertion's transform, layer and color. Retain model/paper space, nested INSERT/MINSERT, placed attributes, dimension blocks, RAY/XLINE and visible constant attributes. Skip invisible attribute metadata and variable templates with explicit diagnostics for unsupported content.
  • Cover 13 drawings across R14/AC1014 through AC1032. AC1032 is the 2018 saved-file format, also used by newer CAD applications. This remains a partial 2D preview: R12 is unsupported, R13 is unverified, and complex/proxy entities, external references and SHX fonts retain documented limits.
  • Enforce bounded input, decompression, object/vertex counts, nesting and TypeScript block expansion. Buffer JSON transport and validate the model envelope without building a second full JSON tree in WASM.
  • Keep the all-in-one main JS at 3.53 MB gzip / 3.40 MB Brotli, with supplied precompressed files below the 4,000,000-byte delivery budget. The optional archive WASM/worker remain external. Complete downloads are 5.61 MiB split (11.8% smaller) and 10.59 MiB all-in-one (11.0% smaller).

DWG corpus, timings and compatibility limits · Final runtime bytes · Exact downloadable assets

Presentation previews and demo fixes

  • Render cached horizontal bar charts alongside column and pie charts, including clustered, stacked and percent-stacked bars, negative/missing values and reversed category order.
  • Preserve chart titles, legends, axis/grid colors and basic text styles; show formatted value labels for bar/column charts and reserve room for readable category labels.
  • Add Chinese and English 14-slide FiLens introduction samples. Choose the default deck and sample URL from the interface language, and switch the selected introduction when the language changes.
  • Highlight the three retained DSH comparisons at the start of both README plugin sections: PPTX 13.56×, DOCX 16.46× and PDF 1.73× faster first previews than built in, with measurement versions and reports.
  • Give the compact Tools menu a consistent disclosure arrow and align the button across browsers. Clarify local-demo and hosted-demo links in both READMEs.

Offline packages and validation

  • Reduce Lite downloads to 6.90–7.17 MiB, retaining the original reading/search/conversion payloads and removing bundled preview assets. Enforce a strict <10,000,000-byte archive budget in native packaging, Windows test bundles and release aggregation, including manifest-only refreshes. Boundary checks accept 9,999,999 bytes and reject 10,000,000.
  • Refresh Full bundles with preview 0.3.5, retaining the original CLI/OCR payloads. Lite users can download and extract filens-preview-0.3.5-all-in-one.zip, then run filens preview report.pdf --assets /path/to/filens-preview-0.3.5-all-in-one --no-open; FILENS_PREVIEW_DIR or a preview/ directory beside the executable also works. Verify archive integrity, exact extracted files, embedded WASM and Full precompressed JS.
  • Refresh both mobile source SDKs to 0.1.5, carrying the same split runtime and archive sidecars. Chromium and WebKit mobile bridges pass 22 checks; physical-device and precompiled AAR/XCFramework validation remain outside this release.
  • Pass 856 unit checks, 2,128 conversion-policy checks, 328/328 real-WASM conversion jobs, and Go wrapper tests. The installed preview package passes 64 real browser previews, public TypeScript imports and production consumer bundling checks; standalone HTML passes 17 Chromium checks with network access blocked.
  • Verify macOS Full/Lite with an empty PATH, automatic local conversion resources, text reading, search, conversion and Full OCR. Confirm Lite has no bundled viewer and exports correctly with separately supplied preview assets. Verify three exported TXT/DWG HTML previews after the CLI exits, with the browser offline. Linux/Windows native execution is not repeated; their unchanged binaries/resources are checked against the prior published archives.
  • Keep parsing and conversion in the frontend WASM/TypeScript core. Go remains a thin wrapper. Retain MIT and bundled third-party notices, including the CAD reader's MIT distribution notices.

Release validation · Native/offline checks · Support matrix · Full changelog

npm follow-up — 2026-11-05

filens-preview@0.3.5 is public: 16.19 MiB download / 31.79 MiB installed, including both builds. Fresh-registry installation, TypeScript declarations, 64 real browser previews and production consumer bundling pass.

Eleven updated @filens/* module patches are public, with all planned versions verified against the registry and default tags promoted after their dependencies became available. CLI/OCR 0.5.6 and DSH 0.1.6 retain their existing npm versions and preview 0.3.4 pins.

Current npm publication status · Public preview checks · [Full bundle content audit](https://github.com/Ic...

Read more

v0.6.4 | 450 Formats, Faster Previews & Search

Choose a tag to compare

@orca-zhang orca-zhang released this 05 Nov 04:40
Download Link Download size
CLI Lite: darwin-arm64 filens-0.5.6-macos-arm64-lite.tar.gz 19.08 MiB
CLI Full: darwin-arm64 filens-0.5.6-macos-arm64-full.tar.gz 33.21 MiB
CLI Lite: linux-x64 filens-0.5.6-linux-x64-lite.tar.gz 18.92 MiB
CLI Full: linux-x64 filens-0.5.6-linux-x64-full.tar.gz 34.87 MiB
CLI Lite: linux-arm64 filens-0.5.6-linux-arm64-lite.tar.gz 18.81 MiB
CLI Full: linux-arm64 filens-0.5.6-linux-arm64-full.tar.gz 32.56 MiB
CLI Lite: win32-x64 filens-0.5.6-windows-x64-lite.zip 18.86 MiB
CLI Full: win32-x64 filens-0.5.6-windows-x64-full.zip 35.09 MiB
Browser runtime: split filens-preview-0.3.4-split.zip 6.36 MiB
Browser runtime: all-in-one filens-preview-0.3.4-all-in-one.zip 11.90 MiB
iOS source SDK filens-ios-sdk-0.1.4.zip 6.38 MiB
Android source SDK filens-android-sdk-0.1.4.zip 6.39 MiB
dsh-filens 0.1.6 dsh-filens-0.1.6.tgz 6.53 MiB
Checksums SHA256SUMS SHA-256
Build manifest filens-release-v0.6.4.json Versions, sizes and validation

13 package downloads + manifest + checksums (15 assets). Full CLI includes OCR; Lite keeps OCR optional. Native bundles include the offline viewer. Mobile downloads are source SDKs. MiB = 1,048,576 bytes.

CLI installers and library modules are available from npm: filens-cli, filens-cli-lite, filens-preview, dsh-filens and @filens/*. Platform/OCR dependencies install automatically through npm; use the Full/Lite archives above for offline installation.

What's new

Compared with v0.6.3, FiLens expands browser previews from 402 to 450 extensions and CLI inputs from 334 to 349 formats, reduces format-specific startup work, and improves repeated document previews and local search. Parsing and conversion remain in the shared frontend/WASM core.

Components: CLI 0.5.6, browser preview 0.3.4, iOS/Android source SDKs 0.1.4, DSH plugin 0.1.6, and updated @filens/* modules. The CLI and browser counts describe different capabilities; inspect filens capacity --full --json for each CLI operation.

DSH 0.1.6 update — November 5, 2026

  • Keep zoom out / percentage / zoom in / fullscreen beside the DSH address bar for every format. Remove page, rotation and manual fit buttons and warning-count badges; retain PPTX keyboard navigation.
  • Reuse native zoom and provide shared view zoom/fullscreen for text, Word, archives and media. Word auto-fit follows pane width independently of user zoom.
  • Keep CAD layers and the 3D inspector as compact entries. Group worksheet, archive and attachment controls under Tools, retaining their actual nodes and handlers. Keep audio/video playback and progress below the player, and size the zoom percentage to four characters. Controls move into fullscreen and return to the address bar on exit.
  • Validate 69 Vue tests, 18 DSH tests, 16 isolated format-loading paths, 12 complete browser previews and six actual Desktop formats. Browser fullscreen passes; native Desktop fullscreen is excluded.
  • Shorten the English/Chinese README DSH section and expand the featured comparisons to 12 measured scenarios across DSH, XLSX, ZIP, PPTX, RAW and STEP, with measurement dates and stage boundaries. Compact-toolbar checks.

DSH 0.1.5 update — November 5, 2026

  • Rename the preview entry to FiLens Document Preview and simplify its description to local previews for 400+ formats. The separate FiLens Tools entry retains its reading, OCR, search, excerpt and conversion description.
  • Move format controls beside the address bar: page navigation, zoom, rotation, fullscreen, worksheet tabs, archive search/sort, Office attachments, audio/video playback and the 3D inspector. Remove manual Fit / Width / Height buttons in both the header and fullscreen.
  • Keep actual control nodes, handlers and independent tab state. Hide retained parent controls while an attachment is open. Move controls into the fullscreen preview and return them to the header on exit.
  • Fix narrow-header clipping, nested scroll containers, blocked button clicks and the misplaced 3D tools opener. The inspector opens below the header without shrinking the canvas, with keyboard tabs, Escape and focus restoration.
  • Re-record the 3D / panorama GIF, WebP and MP4, including header model/view/section tools, panorama zoom and video seeking/playback. Update the FiLens skill, README SOTA shortlist and measured bundle/package sizes.
  • Validate 66 Vue tests, 17 core attachment tests, 18 DSH tests, 16 isolated format-loading paths, 12 complete browser previews and six actual Desktop formats. Browser fullscreen passes; the Desktop run explicitly skips native fullscreen. 0.1.5 checks and exact package bytes.

DSH 0.1.6 uses CLI 0.5.6 and embeds the shared-source preview runtime 0.3.4 with the header-control changes. The standalone browser/npm and SDK archives keep their existing payloads. The sidebar timing table below retains its measured 0.1.3 snapshot; the 0.1.6 interface update does not introduce a new latency claim.

Formats and features

  • Add filens inspect FILE --json to identify actual file content independently of the filename, with MIME, evidence categories and extension-mismatch reporting. The shared WASM detector reads at most 256 KiB; large inputs are not copied into the temporary workspace. Ambiguous text/containers and unknown binary remain explicit. Detection evidence does not imply full-file validation. Refresh the English/Chinese terminal GIFs with an actual renamed-file inspection.

  • CLI reading, OCR, excerpts and directory/archive search now accept TGA, DDS, DIB, CUR, PCX, JPEG XL, QOI, Farbfeld, PSD, PSB, ICO, ICNS, AI, EPS and PS through the existing shared WASM decoders. Photoshop uses saved composites; AI uses PDF-compatible artwork or the PostScript interpreter; raster-only artwork requires OCR for text. Existing image and design conversions are also available in the CLI build.

  • Add TIFF, TGA, PBM/PGM/PNM, DDS, HDR, DIB, CUR, PCX, EXR, JPEG XL, QOI and Farbfeld previews, plus DWG-to-DXF 2D preview. The optional graphics engine loads on first use. TIFF displays the first usable image; HDR/EXR previews use 8-bit output. See the support matrix.

  • Expand archive browsing and nested opening to BZip2, XZ, LZMA, Zstandard, Unix compress, LZMA86, compound TAR extensions, AR/DEB, CPIO, CAB, ISO/UDF, RPM, XAR, WIM/ESD and LHA/LZH, including WIM multi-image directories and UDF images named .iso.

  • Add XPI, CRX2/CRX3, ZIPX with BZip2/Deflate64/LZMA entries, and CBR/CB7/CBT containers, using actual readers for their contents.

  • Archive browsing gains name filtering, name/size/date sorting, empty-state messages, arrow-key navigation, Enter/Space to open, and Escape to clear filtering. Returning from a preview restores the query, scroll position and keyboard focus.

  • Add the optional @filens/converter-client/format-detector export. Importing it does not fetch WASM; instance creation loads the selected SIMD/scalar artifact. SIMD download, compilation or initialization failure falls back to the scalar build.

  • Expand image, code/text, archive and system-package examples. Remote opening handles encoded URLs, signed query strings, explicit filenames for extensionless URLs, same-origin relative paths, and browser history.

  • DSH mounts previews directly in the sidebar DOM. Version 0.1.6 uses a compact address-bar toolbar and dedicated tool menus; the 3D/panorama gallery records 0.1.5; the installation demo and timed 0.1.3 snapshots retain their own provenance.

Performance improvements

Loading, compression and package size

  • Load preview drivers by format, separating routing metadata from renderers. Share pending and successful imports. Text/PDF no longer pre...
Read more

v0.6.3 | Native Design Previews & Offline Bundles

Choose a tag to compare

@orca-zhang orca-zhang released this 04 Nov 06:27

FiLens v0.6.3 includes CLI 0.5.4, browser preview 0.3.3, mobile source SDKs 0.1.3 and DeepSeek Harness adapter 0.1.1.

Native design previews and model workbench

  • Preview 402 file extensions locally, including conversion-assisted formats. PSD/PSB read the saved composite; AI/EPS/PS produce vector PDF previews through the shared frontend WASM core. PSD/PSB require 8-bit RGB/grayscale; PostScript supports a bounded subset with font limitations. See design format limits.
  • Explore 12 original design samples and 8 detailed 3D models. The model inspector offers view, structure and tool panels without shrinking the canvas; orbit, zoom, measurement, sections and snapshots work in narrow panes.
  • The workbench distinguishes Samples, Supported, no sample, and Unsupported. Supported formats without a bundled sample can be opened by importing a file. Opening STEP through a direct URL now selects the Design family after its routes load.
  • README installation, browser integration, mobile SDK, format coverage and size sections now have separate subheadings.

CLI and Agent interfaces

Breaking JSON change: public requests and responses use op. Capacity filters use forOp. Legacy operation and forOperation fields are rejected; no compatibility entry points remain.

{"op":"read","input":"report.pdf","pages":"1-3","ocr":"never"}
{"op":"capacity","forOp":"read","sourceFormat":"pptx"}

Capacity supports combined filters, compact output and directional queries such as docx>? and ?>pdf. Document inspection adds explicit page/slide selection, per-call OCR policy and confidence filtering, source evidence, Office media inventory and requested image attachments. Intentional native-text reads report their scope and succeed when otherwise complete; genuine OCR errors and omissions retain partial-result status. Excerpts preserve complete passages and return whole short documents when the requested budget permits.

The DSH adapter uses the same CLI and frontend runtime, adding image attachments and the model inspector. Current adapter tool and browser tests pass; the real Desktop/Web profile observations from adapter 0.1.0 remain historical and were not repeated for 0.1.1.

Offline downloads

Download the archive matching your platform and extract the entire directory. CLI Full includes the native OCR engine and models; Lite includes document reading, conversion and the offline browser preview runtime. Both run directly without Node.js or Python. Choose Full for offline OCR.

For browser integration, deploy the complete extracted ZIP over HTTP(S) and import filens.js. Retain archive engine sidecars for RAR/7z. Mobile ZIPs contain Swift Package / Android Library source SDKs with offline resources; build them in the corresponding platform toolchain.

Offline package Download Extracted files
filens-preview-0.3.3-split.zip 4.31 MiB 13.81 MiB
filens-preview-0.3.3-all-in-one.zip 4.20 MiB 9.84 MiB
filens-ios-sdk-0.1.3.zip 4.33 MiB 13.85 MiB
filens-android-sdk-0.1.3.zip 4.33 MiB 13.85 MiB
filens-0.5.4-macos-arm64-lite.tar.gz 10.87 MiB 18.44 MiB
filens-0.5.4-macos-arm64-full.tar.gz 25.00 MiB 41.64 MiB
filens-0.5.4-linux-x64-lite.tar.gz 11.62 MiB 18.17 MiB
filens-0.5.4-linux-x64-full.tar.gz 27.57 MiB 47.11 MiB
filens-0.5.4-linux-arm64-lite.tar.gz 11.51 MiB 18.06 MiB
filens-0.5.4-linux-arm64-full.tar.gz 25.26 MiB 41.47 MiB
filens-0.5.4-windows-x64-lite.zip 11.56 MiB 18.09 MiB
filens-0.5.4-windows-x64-full.zip 27.79 MiB 46.85 MiB

MiB = 1,048,576 bytes. These sizes exclude filesystem overhead and user caches. SHA256SUMS and the source manifest identify every package.

Validation and limits

  • Shared workspace suite: 1,876 passed, 11 intentional skips; 2,027 conversion policy checks and 311/311 WASM conversion jobs passed.
  • Production workbench, design and model browser checks passed, including Chinese/English states and a 320px viewport. Standalone previews passed 58 browser cases, HEIF reference-pixel checks and both exports after production Vite bundling. Mobile runtime/bridge: 22 Chromium/WebKit checks.
  • CLI tests cover requests, capacity, document inspection, conversion, OCR, archives, search, excerpts, similarity and memory/disk workspaces. Final macOS Full/Lite archives execute with an empty PATH and render exported previews with networking disabled.
  • DSH adapter: 18 tests, 12 preview formats and interaction checks passed. Release archives pass checksums, integrity, size and privacy checks.
  • Native execution was verified on macOS arm64. Linux x64/arm64 and Windows x64 bundles were cross-built; native execution on those systems and physical mobile devices remains unverified. Mobile artifacts are source SDKs rather than precompiled AAR/XCFramework files. Format support counts do not promise full fidelity for every file.

Live workbench · Support matrix · Release validation.

First-party code is MIT. Retain the supplied third-party notices when redistributing.

ZimaOS: a personal cloud with FiLens integration

v0.6.2 | DeepSeek Harness Plugin & Memory Workspace

Choose a tag to compare

@orca-zhang orca-zhang released this 03 Nov 18:10

FiLens v0.6.2 adds the DeepSeek Harness plugin 0.1.0, alongside CLI 0.5.2, browser preview 0.3.2, @filens/model3d 0.1.1 and refreshed mobile source SDKs 0.1.2.

New: DeepSeek Harness plugin

dsh-filens installs five Agent tools and a multi-format sidebar renderer together; each can be enabled independently. Tools cover capacity, reading/OCR, directory and archive search, original excerpts and conversion. Preview uses DSH's Session file-read service and the shared frontend runtime, registering 397 extensions including conversion-assisted previews. This is the registration count, rather than 397 individually validated formats.

dsh plugin --profile desktop add dsh-filens@0.1.0
# Web profile:
dsh plugin --profile web add dsh-filens@0.1.0

Restart Desktop after installation. The universal plugin tarball includes the client, WASM, archive worker and notices; npm installs the matching CLI/OCR platform dependencies and models. Keep optional dependencies enabled. Tested on macOS arm64 with Desktop/Web 0.2.1-rc.5 and Web 0.2.2-alpha.3 (Node >=24.9). Other DSH versions remain unverified.

The sidebar fills its pane and follows DSH's palette, fonts and language. Loading identifies the file; parser failures offer details and retry; password-protected PDFs remain interactive. 3D previews have no top toolbar, fit the whole model in narrow panes, and support drag, scroll and double-click reset. Word pages fit the pane width while retaining reading position on resize.

Plugin guide · 中文指南 · Desktop screenshot.

CLI and shared preview changes

  • CLI input copies, WASM conversion results and PDF/OCR intermediate images now use a bounded memory workspace by default. Parallel workers share a 512 MiB file-data quota with no automatic disk fallback. WASM linear memory, native OCR memory and transport copies are separate allocations; operating-system swapping is outside this setting.
  • Select disk scratch explicitly with --workspace disk or stdin JSON "workspace":"disk". Final conversion outputs and exported preview HTML still require write permission. The new CLI requires its matching byte-input OCR platform package; all four platform pairs are updated together.
  • hdrw.wasm exchanges options and results through stdin/stdout, without option/result files or a /work mount. Its read-only input mount is /scan; the transport has bounded input/output buffers.
  • Shared 3D camera fitting accounts for the narrower field of view in portrait or landscape panes, preserves user orbit and zoom on resize, and adds double-click reset. The fixes ship in both standalone browser builds and the DSH renderer.
npm install -g filens-cli@0.5.2
# Or: npm install -g filens-cli-lite@0.5.2
npm install filens-preview@0.3.2
npm install @filens/model3d@0.1.1

Downloads

Artifact Download Extracted / installed file bytes
filens-preview-0.3.2-split.zip 3.56 MiB 11.39 MiB
filens-preview-0.3.2-all-in-one.zip 3.58 MiB 9.00 MiB
filens-preview-0.3.2.tgz 7.14 MiB 20.40 MiB
dsh-filens-0.1.0.tgz 3.60 MiB 9.09 MiB
filens-ios-sdk-0.1.2.zip 3.59 MiB 11.43 MiB
filens-android-sdk-0.1.2.zip 3.59 MiB 11.43 MiB
filens-0.5.2-macos-arm64-lite.tar.gz 9.49 MiB 16.82 MiB
filens-0.5.2-macos-arm64-full.tar.gz 23.62 MiB 40.03 MiB
filens-0.5.2-linux-x64-lite.tar.gz 10.25 MiB 16.55 MiB
filens-0.5.2-linux-x64-full.tar.gz 26.21 MiB 45.49 MiB
filens-0.5.2-linux-arm64-lite.tar.gz 10.14 MiB 16.45 MiB
filens-0.5.2-linux-arm64-full.tar.gz 23.89 MiB 39.86 MiB
filens-0.5.2-windows-x64-lite.zip 10.20 MiB 16.47 MiB
filens-0.5.2-windows-x64-full.zip 26.43 MiB 45.23 MiB

MiB = 1,048,576 bytes. The DSH row measures the plugin itself; its platform CLI/OCR dependencies are installed separately. Native Full bundles include OCR and models; Lite leaves OCR optional. Both include the offline preview runtime and need no Node.js, npm or Python. Linux x64/arm64 and Windows x64 bundles were cross-built; native execution was verified on macOS arm64. Mobile artifacts are source SDK ZIPs with offline resources, rather than precompiled AAR/XCFramework files.

Validation and limits

  • Shared 3D: 326 tests across 10 files. CLI Rust: 20 native tests and 22 WASI-walker tests. Plugin: 7 test groups, plus 12 formats and 13 interaction checks in Chromium.
  • Final CLI npm Full/Lite tarballs and fresh-cache public npm installs passed automatic platform selection, native OCR, stdin JSON, conversion, nested archive access and first-use preview checks. 23 workspace checks passed against the packaged macOS binary, including a sandbox denying scratch writes, explicit disk mode and disk cleanup.
  • Final preview tarball passed public declaration checks, 48 browser previews, HEIF reference-pixel checks, media checks and both exports after production Vite bundling. Mobile runtime/bridge: 22 Chromium/WebKit checks.
  • Real DSH Desktop opens DOCX, Keynote, STEP and ZIP through its Session file service. Web integration covers the tool pipeline, read-only policy, independent lifecycle and package removal on both tested versions. The published plugin also passed installation from public npm without overrides and all 13 integration checks in the installed rc.5 Web runtime; installed CLI/OCR/preview bytes match the release tarballs. No model prompt or DSH account was used.
  • Release archives pass integrity, size and privacy checks. Native Windows/Linux execution and physical mobile devices were not validated in this release. See the support matrix for format and codec limits.

Registry publication observations · DSH validation · SHA256SUMS · Source manifest.

First-party code is MIT; retain all supplied dependency notices when redistributing. Files are parsed locally; text returned to DSH's Agent can enter its configured model provider.

ZimaOS: a personal cloud with FiLens integration

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

Choose a tag to compare

@orca-zhang orca-zhang released this 03 Nov 14:04

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.

ZimaOS: a personal cloud with FiLens integration

v0.6.0 | Mobile SDKs, Archive Previews & Smaller Runtime

Choose a tag to compare

@orca-zhang orca-zhang released this 02 Nov 02:35

Downloads

FiLens v0.6.0 adds mobile preview SDKs and Browser Preview 0.3.0. Files stay on the user's device; the native hosts reuse the same frontend and WebAssembly engines.

Download Artifact Compressed Extracted / installed
Browser preview 0.3.0 · split filens-preview-0.3.0-split.zip 3.49 MiB 11.99 MiB
Browser preview 0.3.0 · all-in-one filens-preview-0.3.0-all-in-one.zip 3.50 MiB 9.71 MiB
npm package · both browser builds filens-preview-0.3.0.tgz 6.98 MiB 21.72 MiB
iOS source SDK 0.1.0 · Swift Package filens-ios-sdk-0.1.0.zip 3.51 MiB 12.02 MiB
Android source SDK 0.1.0 · Java Library filens-android-sdk-0.1.0.zip 3.51 MiB 12.02 MiB

MiB = 1,048,576 bytes. ZIP totals include runtime assets and license notices. The npm package contains both builds; its installed size excludes npm caches and filesystem allocation overhead. SDK ZIPs include the complete offline split runtime and platform source. They are source SDKs, not precompiled AAR / XCFramework files.

Browser and npm integration

The registry accepted filens-preview@0.3.0 with HTTP 202 and is still processing
the upload. Until it becomes publicly available, install the exact tested tarball
directly from this Release:

npm install https://github.com/IceWhaleTech/filens/releases/download/v0.6.0/filens-preview-0.3.0.tgz

After npm processing completes, the versioned registry command is:

npm install filens-preview@0.3.0

Extract a browser ZIP and deploy the complete directory over HTTP(S), then open index.html to choose a local file. Applications can import createPreview from filens.js. Both builds now keep the optional archive engine and its worker as external files; retain archive/7zz.wasm and the worker under assets/ for RAR, 7z and multipart ZIP.

Preview API · Supported formats.

iOS and Android

  • iOS 15+ / Swift 5.9+: extract the iOS ZIP, add sdk/ios as a local Swift Package and link FilensPreview. The package includes its offline runtime. Configure the local-network ATS setting documented in the integration guide.
  • Android 8+ / API 26+: extract the Android ZIP and include sdk/android/filens-preview as an Android Library. JDK 17+, Gradle 8.9, Android SDK 35 and a current Android System WebView are required. The module can build an AAR; standalone AAR consumers also need AndroidX WebKit 1.12.1.
  • Both hosts provide local file opening, language / toolbar options, render and error callbacks, source replacement and cleanup. iOS accepts local / security-scoped file URLs; Android accepts readable content:// and file:// URIs.

SDK integration guide (Chinese).

Changes since v0.5.0

  • Added the iOS and Android source preview SDKs with bundled offline resources and native lifecycle / message bridges.
  • Added RAR / RAR5 and 7z previews, encrypted and solid archives, multipart RAR / 7z / ZIP, password retries, missing-volume diagnostics and nested entry previews. The extraction-only archive engine uses pinned 7-Zip source with O3 / LTO and shares compiled code across isolated operation workers.
  • Added embedded Office attachment handling, shared ZIP readers and improved cancellation / nested-preview lifecycle behavior.
  • Gzip-compressed embedded WASM before base64 and removed duplicate ZIP / compression loading from ordinary document paths. Main runtimes, optional archive sidecars and complete package downloads are now measured separately.
  • Added the default translucent FiLens © IceWhale watermark, including preview fullscreen and hidden-toolbar layouts.

Updated runtime sizes

Runtime compression figures below use MB = 1,000,000 bytes. They exclude HTML, types, README and notices; they are separate from the downloadable ZIP/npm sizes above.

Runtime Raw MB gzip MB Brotli MB
Split main runtime 11.23 3.26 2.57
All-in-one main JS 8.85 3.26 2.90
Optional archive WASM + worker, either build 0.88 0.35 0.28
Split with archive assets 12.11 3.61 2.85
All-in-one with archive assets 9.73 3.60 3.18

Runtime, npm and SDK size report · Exact Release asset sizes.

Existing CLI and ZimaOS downloads

CLI 0.5.0 and ZimaOS 0.5.1 retain the binaries and embedded Preview 0.2.0 from v0.5.0. This release does not rebuild or relabel those components.

Full CLI, including OCR: macOS arm64 · Linux x64 · Linux arm64 · Windows x64. Lite variants and the ZimaOS image remain available on that release.

To use the new split runtime with an existing CLI, extract its ZIP and pass the directory explicitly:

filens preview report.pdf --mode serve --assets /path/to/filens-preview-0.3.0-split

Validation and limits

  • The npm tarball passed isolated installation, TypeScript consumer checks, 48 real browser previews, native media / HEIF checks, and 12 PDF / iWork / RAW / STEP / HEIF / RAR previews after production Vite bundling. The registry accepted the upload; fresh-cache registry installation remains pending public availability. The Release tarball is the exact locally tested artifact, with its SHA-256 listed below.
  • The mobile page and both native message shapes passed 22 Chromium / WebKit checks. Archive sidecars passed 12 browser checks covering ordinary ZIP, encrypted / solid / multipart archives, nested extraction and missing-volume errors.
  • The iOS host passed 3 Swift loopback HTTP / path / byte-range tests and iOS Simulator arm64 compile checks. Android Java sources passed API 35 / AndroidX WebKit compilation and byte-range checks. Full Gradle AAR builds, simulator app execution and physical-device tests remain pending.
  • These are read-only previews. Complex document fidelity, fonts, codecs, WebGL and device memory remain subject to the shared support matrix. Mobile SDKs currently accept one self-contained source; they do not expose native OCR, search, standalone conversion-result or multipart-file input APIs. Archive multipart support is available through the browser picker / frontend API.

Checksums and licenses

SHA256SUMS · Versions, asset sizes and source manifest.

Use shasum -a 256 -c SHA256SUMS or sha256sum -c SHA256SUMS for the downloaded files. First-party source is MIT; bundled dependencies retain their own licenses and notices. Keep the supplied notices when redistributing.

ZimaOS: a personal cloud with FiLens integration

v0.5.0 | First Release: Native CLI, Browser Previews & ZimaOS

Choose a tag to compare

@orca-zhang orca-zhang released this 01 Nov 14:17

Downloads

Common use case Download
Use FiLens with an Agent, including OCR Full CLI: macOS arm64 · Linux x64 · Linux arm64 · Windows x64
Add file previews to a website Single-file browser runtime · Split browser runtime

CLI downloads are native offline bundles. Extract and run; no Node.js or Python runtime is required. Both Full and Lite include the WASM engines and browser preview assets. Full also includes OCR libraries and models.

CLI 0.5.0: Full and Lite

Choose Full for documents, scans and images with OCR included. Choose Lite for reading, search, conversion and previews without bundled OCR. To add OCR to a Lite deployment, use the Full archive.

Platform Full, with OCR Lite, without OCR
macOS 12+ · Apple Silicon arm64 23.87 MiB 9.74 MiB
Linux · glibc 2.17+ · x64 26.45 MiB 10.50 MiB
Linux · glibc 2.17+ · arm64 24.14 MiB 10.39 MiB
Windows 10/11 · x64 26.99 MiB 10.62 MiB

Sizes are compressed downloads; 1 MiB = 1,048,576 bytes. Keep the extracted directory intact. The executable loads its adjacent WASM and preview resources; Full also uses the included native/ and models/ directories.

On macOS / Linux, open a terminal in the extracted directory:

./filens capacity --json
./filens read report.pdf --json
./filens convert report.doc report.docx
./filens preview report.pdf --output report-preview.html --no-open

On Windows, open PowerShell in the extracted directory:

.\filens.exe capacity --json
.\filens.exe read report.pdf --json
.\filens.exe preview report.pdf --output report-preview.html --no-open

Open the generated HTML in a browser. It includes the source file and preview engine, so it can be viewed offline. HTML export also works on a headless machine. Existing output files are not overwritten. The CLI also provides --mode serve for loopback HTTP compatibility.

Platform validation: macOS arm64 has passed native execution tests. Linux and Windows binaries were cross-built and statically checked; native execution on those systems remains pending. Intel Mac, Windows ARM64 and Linux musl builds are not included.

Browser Preview 0.2.0

Build Download Use it when
All-in-one filens-preview-0.2.0-all-in-one.zip · 3.83 MiB You want one JavaScript runtime containing Vue, CSS, workers and WASM
Split filens-preview-0.2.0-split.zip · 3.20 MiB You want format modules, workers and WASM to load as needed

Extract and deploy to an HTTP(S) static web server, then open index.html to choose a local file. Both builds have the same API and supported formats. The split build needs its complete directory structure. Retain the accompanying licenses and third-party notices when distributing either build.

For application integration, import createPreview from the supplied filens.js. Browser runtime modules use HTTP(S); the CLI's exported HTML supports direct file: viewing. Preview API.

ZimaOS 0.5.1

Download filens-zimaos-0.5.1.raw · 12.03 MiB.

This ZimaOS module image contains CLI 0.5.0, Preview 0.2.0 and Linux x64 / arm64 resources. Install it with the ZimaOS module manager. Preview exports HTML without launching a browser; download or copy the HTML to your computer to view it. Offline OCR requires compatible Photos OCR libraries and models already installed on the device. ZimaOS guide.

ZimaOS: a personal cloud with FiLens integration

Explore ZimaOS for your personal cloud

First release scope

This first GitHub Release covers the work from September 20 through November 1, 2026 (Asia/Shanghai), at source commit daf83d8. Component versions are CLI 0.5.0, Browser Preview 0.2.0 and ZimaOS 0.5.1.

FiLens provides local file reading, search, OCR, conversion and previews for Agents and applications. Parsing and conversion reuse the frontend Rust / WebAssembly core; Go backend examples wrap that same core. First-party code is MIT licensed; bundled dependencies retain their own licenses and notices.

Agent CLI

  • Read and extract: supported PDF, Office, spreadsheet, scan and image content, with eight output formats: text, JSON, Markdown, HTML, YAML, XML, CSV and TSV. Preserve available page references, tables, logical structure and layout.
  • Local OCR: RapidOCR NCNN with Chinese/English models for images, scanned PDFs and embedded images in supported documents. Includes EXIF orientation, transparent-image handling and supported PDF ToUnicode mapping repairs. PDF layouts use points; image OCR uses pixels.
  • Search: BM25, exact-text and filename search with original excerpts and provenance. Traverse ZIP / TAR / GZIP containers up to eight nested layers; returned virtual member paths can be read, summarized and inspected for layout.
  • Extractive summaries: summarize / prune select original passages without an LLM, with keyword focus, character budgets, source offsets and completeness markers.
  • Duplicates and similar images: compare file sizes, prefix hashes and full SHA-256 for duplicates; use perceptual hashes to group supported JPEG, PNG, WebP, GIF, BMP and TIFF images for review.
  • Conversion: supported legacy Office / WPS / ODF / text to OpenXML, tabular inputs such as CSV / JSON to XLSX, RAW to JPEG, and ICNS / PPM to PNG. Includes overwrite protection, fidelity warnings and structured errors. Inspect capacity.conversionPairs for exact combinations.
  • Offline previews and Agent integration: self-contained HTML export, loopback HTTP mode, bounded Chinese/English intents and a JSON stdin protocol. CLI 0.5.0 embeds the source file, engines and notices and exits after opening or exporting the HTML.

Browser previews

Format family Delivered capabilities
Office, PDF and iWork PPTX, DOCX, XLSX / CSV, PDF, Keynote, Pages and Numbers; local conversion for supported legacy Office / WPS / OpenDocument inputs; pagination, charts, image reuse, resource loading, cancellation and file switching; supported encrypted Office decryption
CAD and 3D DXF, STEP / STP and multiple mesh / scene formats; pan, rotation, zoom and selected inspection features; truck Rust WASM STEP loading with compact binary mesh transport
Images and camera RAW Common browser images, ICNS, PPM and supported DNG, NEF, CR2 / CR3, ARW, X3F and other RAW subsets; embedded JPEG extraction and lightweight sensor previews; native HEIC / HEIF decoding with a dedicated WASM fallback
Media, 360° and Live Photos Native browser audio/video; equirectangular panoramas and video; supported Insta360 / DJI metadata, calibration, companion-file and experimental stitching paths
Archives, books and diagrams ZIP / TAR / GZIP with nested browsing, EPUB / CBZ, source code, configuration files, sandboxed HTML, mind maps, draw.io and basic Visio diagrams
Integration and UI Vue 3 components, standalone createPreview() API, 28 toolbar languages and supported application-icon extraction from APK / IPA and Windows EXE / DLL / MUI / MUN files

See the support matrix for extensions, conversion pairs, resource requirements and fidelity limits. Browser preview support does not imply complete CLI extraction or conversion support for the same format.

Known limitations

  • Intended for **read-only previews, extraction and lightweight conversio...
Read more