Skip to content
int3rrobangPublic

About

Drive-wide NTFS file search with full paths for oh-my-pi, backed by the open-source FindX engine (MFT + USN journal). Three tools: fastsearch, fastsearch_index (full/watch), fastsearch_status.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

fastsearch-omp

Drive-wide NTFS file search with full paths for oh-my-pi. Query millions of files in milliseconds, Everything/WizFile-style, backed by the open-source FindX engine (Rust, MIT OR Apache-2.0: MFT enumeration + USN journal).

Design principle: wrap a competent engine instead of hand-rolling an MFT parser. This plugin is a thin adapter between omp's tool registry and the findx2 CLI — ~8 files, zero runtime dependencies.

Tools

Tool Purpose
fastsearch Query a prebuilt index. Full paths, milliseconds. Rich query syntax (AND/OR/exclude, ext:, size:, dm:, parent:, dupe:).
fastsearch_index Build (mode: "full") or keep fresh (mode: "watch", detached USN watcher) the index for a volume. Escalates via a UAC prompt when needed — omp doesn't have to run as Administrator (escalate: false opts out for headless).
fastsearch_status Report index freshness and coverage (build time, entries, per-volume USN cursor).

Install

# 1. Build the FindX CLI (needs Rust: https://rustup.rs)
cd fastsearch-omp
bun run build          # clones findx (pinned tag) + cargo build --release + stages native/bin/findx2.exe

# 2. Link into omp
omp plugin link (Resolve-Path .)

# 3. Restart omp. Build the index ONCE per drive:
#    call fastsearch_index (volume: "C:") - a UAC prompt appears, click Yes.
#    omp itself never needs to run as Administrator.

First-time index build takes a UAC click and a few minutes for large drives; after that, queries run unprivileged and return in milliseconds. Index lives at ~/.omp/fastsearch/index.bin (override with FASTSEARCH_INDEX; binary override FASTSEARCH_FINDX2).

Limitations

  • Names + metadata only (timestamps, sizes, attributes) — no file contents.
  • Persistent index (tens–hundreds of MB). That is the Everything/WizFile architecture — the thing that actually delivers sub-second drive-wide search.
  • Windows + NTFS only.
  • FindX is young (single-maintainer); its design is serious (published benchmarks: 8.5M entries, ~80 ms search) but not battle-tested by a community.

License

MIT. The FindX engine is vendored at build time from chaojimct/findx (pinned to v2.1.0 by native/build.ps1), MIT OR Apache-2.0 — see native/findx-LICENSE and native/findx-LICENSE-APACHE.

About

Drive-wide NTFS file search with full paths for oh-my-pi, backed by the open-source FindX engine (MFT + USN journal). Three tools: fastsearch, fastsearch_index (full/watch), fastsearch_status.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages