Repository navigation
Releases
v0.6.7 | FiLens Branding & Repository Update
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.10DSH 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
| 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.
Install both plugins, then reopen DSH Desktop:
dsh plugin --profile desktop add dsh-filens@0.1.9Localized 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.9andfilens-preview@0.3.6; verify public tarballs and theirlatesttags. - Publish
@filens/core@0.1.4,@filens/vue@0.1.4,@filens/media@0.1.3and@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
latesttags. - 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
Install from the official ZimaOS Mod Store:
sudo zpkg update
sudo zpkg install filens
# For an existing installation:
sudo zpkg upgrade filensOfficial 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
| 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-jsondrawing 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
graphicsWasmintegrations retain their combined-engine fallback; custom hosts can supplycadWasm. - 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 runfilens preview report.pdf --assets /path/to/filens-preview-0.3.5-all-in-one --no-open;FILENS_PREVIEW_DIRor apreview/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...
v0.6.4 | 450 Formats, Faster Previews & Search
| 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 --jsonto 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-detectorexport. 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...
v0.6.3 | Native Design Previews & Offline Bundles
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.
v0.6.2 | DeepSeek Harness Plugin & Memory Workspace
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.0Restart 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 diskor 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.wasmexchanges options and results through stdin/stdout, without option/result files or a/workmount. 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.1Downloads
| 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.
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.tgzAll 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.
v0.6.0 | Mobile SDKs, Archive Previews & Smaller Runtime
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.tgzAfter npm processing completes, the versioned registry command is:
npm install filens-preview@0.3.0Extract 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/iosas a local Swift Package and linkFilensPreview. 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-previewas 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://andfile://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-splitValidation 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.
v0.5.0 | First Release: Native CLI, Browser Previews & ZimaOS
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-openOn 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-openOpen 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.
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/pruneselect 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.conversionPairsfor 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...



