A local, read-only disk scanner that identifies files by their contents, not their extensions. Built with Tauri 2, React and Rust.
Interface preview using a real scan of synthetic sample files. The displayed paths and filenames are demonstration data.
- Scan a chosen folder recursively, including hidden files and hidden folders.
- Select file signatures by category before scanning.
- Browse a collapsible folder tree with matched file counts and sizes.
- Sort by name, size or type; search paths and filter multiple formats or whole categories without rescanning.
- Inspect files inside ZIP and RAR archives without extracting them to disk.
- Show files in Finder, Windows File Explorer or the system file manager.
- Cancel scans, clear results and inspect skipped directories and read errors.
| Platform | Status |
|---|---|
| macOS | Frontend build and Rust tests verified on Apple Silicon. |
| Windows | x86_64-pc-windows-gnu cross-compilation check passed; native MSVC packaging and UI still need Windows verification. |
| Linux | Expected to work with Tauri system dependencies; not verified. |
On Windows, build natively with the MSVC Rust toolchain, Microsoft C++ Build Tools with the Desktop development with C++ workload, and Microsoft Edge WebView2. UnRAR also requires the C++ compiler. See the official Tauri prerequisites for platform setup.
Prerequisites: Node.js 20.19+ or 22.12+, pnpm 10.32.1, Rust, and your platform's Tauri prerequisites. This repository is self-contained; direct dependency versions and lock files are pinned.
corepack enable
pnpm install --frozen-lockfile
pnpm tauri-devpnpm dev starts only the frontend preview. Filesystem scanning and native dialogs require pnpm tauri-dev.
pnpm build
cargo check --manifest-path src-tauri/Cargo.toml --locked
cargo test --manifest-path src-tauri/Cargo.toml --locked --lib
pnpm tauri-buildBuild the Windows NSIS installer on Windows:
pnpm exec tauri build --bundles nsisPackages are written under src-tauri/target/release/bundle/. Installer execution, signing and file-manager integration require validation on the destination OS.
The Build installers workflow builds macOS Apple Silicon and Intel DMGs, a Windows x64 NSIS installer, and Linux x64 DEB/AppImage packages. No signing secrets are required; macOS uses ad-hoc signing without notarization, and Windows installers are unsigned. OS security prompts may require manual approval.
- Push this repository, then select Actions → Build installers → Run workflow for a manual build. Download packages from the run's Artifacts section (retained for 14 days). The workflow must be present on the default branch for manual dispatch.
- To publish a GitHub Release, update the versions in
package.json,src-tauri/Cargo.toml, andsrc-tauri/tauri.conf.json, refresh the lock files, commit, then push a matching tag such asv0.1.0. Tags containing-produce prereleases. Releases become visible as individual platform builds finish; check that all four jobs pass before announcing a release. - The workflow uses the built-in
GITHUB_TOKENwithcontents: write. Repository or organization policies must allow GitHub Actions and release creation.
| Category | Formats |
|---|---|
| Images | PNG, JPEG, GIF, WEBP, BMP, HEIC |
| Video / containers | MP4, MOV, MKV, WEBM, AVI, FLV, MPEG, TS, M2TS, 3GP, WMV, ASF |
| Audio | MP3, M4A, FLAC, WAV, AAC (ADTS), OGG, OPUS, AIFF/AIFC, AMR/AMR-WB, AC3, APE, WMA |
| Documents | |
| Archives | ZIP, RAR |
| Executables | EXE, ELF |
| Other | Unknown or unsupported signatures |
Detection reads at most the first 4 KiB without extension fallback. A signature indicates a likely format, not a full validation of the file or its codecs. ZIP-based documents appear as ZIP. MKV/WebM are container classifications; ASF is the fallback when Windows Media streams cannot be distinguished within the inspected bytes.
- Archive contents appear as
archive.zip!/folder/file. Reveal opens the outer archive's location. - Archives are inspected even when ZIP/RAR containers are excluded by scan signatures.
- ZIP supports stored and Deflate entries and reads up to 4 KiB of decompressed content per entry.
- RAR reads members in memory, with a 64 MiB limit per member and a 256 MiB decompression budget per archive.
- Traversal is limited to 100,000 entries per archive. Nested archives are identified but not opened recursively.
- Encrypted, unsupported, corrupt or over-limit entries are reported and skipped where possible. An unrecoverable archive error skips the remainder of that archive; scanning other files continues.
- The first 2,000 matches are retained for browsing and result filtering. Scan totals include all matches; folder totals reflect the loaded, filtered files.
- Archive entry sizes are uncompressed. Matched totals include matching physical containers and matching entries, so they are not physical disk usage.
- All read errors are counted; details show up to 20 errors. Unreadable directories have a separate list.
- Nested symbolic links are skipped. A selected root is canonicalized. OS permissions still apply.
- Cancellation is checked between entries and waits for an in-flight read to finish. Clear is disabled while scanning.
Scanning stays on the device. The app has no application-level telemetry, accounts or upload endpoint. File paths, results and read errors remain in process memory; the app does not save a scan history. Clear discards the current results. Archives are not extracted to disk and source files are not modified.
Environment files, signing keys, build output and dependencies are excluded by .gitignore.
assets/ Icon source and generation prompt
src/features/scan/ Scan controls, result tree and client state
src-tauri/src/scan/ Filesystem traversal, signatures and archive readers
src-tauri/tests/ Synthetic archive fixtures
src-tauri/icons/ Desktop application icons
