FinderSearch README

The project's README from github.com/zeusinsight/FinderSearch. As one markdown file: README.md.

FinderSearch logo

FinderSearch

A native Mac file browser with fast, fuzzy filename search. Browse folders, preview files, and manage your files in a familiar macOS interface.

Download for Apple Silicon · macOS 15+ · Usage & shortcuts · Release notes

FinderSearch demo with the sidebar visible: type a filename and see search results narrow

Still preview

Features

Built with SwiftUI and AppKit, powered by fsearch. Search runs locally; your files aren't uploaded.

Install

  1. Download the DMG and drag FinderSearch into Applications. When updating, quit the old app first and replace it.
  2. Eject the disk image and open FinderSearch.
  3. Enable Full Disk Access in System Settings → Privacy & Security to search protected folders, then quit and reopen the app.

The app is not yet Developer ID-signed or notarized. If macOS blocks it, choose Privacy & Security → Open Anyway. Allow the first search index to finish building.

Permissions and troubleshooting →

Performance

In three warm, exact-filename benchmarks over 10,000 generated files, fsearch returned results in 0.49–1.14 ms, versus 7.06–7.30 ms for Spotlight (median times on an Apple M4).

These measure the search backend, including its IPC round trip, rather than rendered UI latency. FinderSearch waits 50 ms after typing stops; Return submits a pending search immediately.

Benchmark method, results, and reproduction →

Build from source

Requires macOS 15+, Xcode 16+ or compatible Command Line Tools, and Rust 1.85+ / Cargo.

git clone https://github.com/zeusinsight/FinderSearch.git
cd FinderSearch
./scripts/build.sh
open dist/FinderSearch.app

The build bundles fsearch automatically. Run tests with swift test -c release. See CONTRIBUTING.md for development checks and the code layout. Apple Silicon is verified; Intel builds remain unverified.

Current limits

FinderSearch is still early. Content search, AirDrop, Finder extensions, saved smart folders, folder merging, and persistent undo history aren't supported yet. Slow disks and cloud providers can still take time.

License & credits

MIT. The search engine is fsearch by Noah Dunnagan, vendored unmodified under its MIT license. FinderSearch adds the native interface and file workflows. See third-party notices.

FinderSearch (zeusinsight/FinderSearch)

Searching Database…

这是什么?FinderSearch 是一款原生 macOS 文件浏览器,具备快速的模糊文件名搜索,使用 SwiftUI 和 AppKit 构建,由 fsearch 搜索引擎驱动。它让你在熟悉的类 Finder 界面中浏览文件夹、预览文件并管理文件。
它能搜索文件内容,而不只是文件名吗?不能,只有带 ext:pdf、mtime:<7d 之类过滤器的模糊文件名匹配——内容搜索尚不支持,同样不支持的还有 AirDrop、Finder 扩展、保存的智能文件夹、文件夹合并以及持久的撤销历史。
使用它需要 Xcode 或 Rust 吗?不需要,下载 DMG 只要求 macOS 15+。从源码构建则需要 macOS 15+、Xcode 16+(或 Command Line Tools)以及 Rust 1.85+/Cargo,因为构建过程会自动打包 fsearch。
这个应用经过公证、可以立即运行吗?还没有——FinderSearch 没有做 Developer ID 签名或公证,因此 Gatekeeper 可能会拦截它,你需要在“隐私与安全性”设置中选择“仍要打开”。
它在 Intel Mac 上也能用吗?它面向 Apple Silicon,已验证可用;也有 Intel 构建,但作者尚未验证。
我的数据会被上传到任何地方吗?不会,搜索完全在你的 Mac 上本地进行,你的文件不会被上传到任何地方。
为什么 FinderSearch 比 Spotlight 快?它由 fsearch 驱动:在 Apple M4 上、跨 10,000 个测试文件的基准测试中,fsearch 返回精确文件名结果用时 0.49–1.14 毫秒,而 Spotlight 需要 7.06–7.30 毫秒。
除了搜索,它还包含哪些文件管理功能?它提供框选、复制/移动、批量重命名、ZIP 工具、标签、分享、废纸篓和撤销,另外还有图标/列表/分栏/画廊视图、快速预览(Quick Look),以及重新打开时可恢复的标签页。
fsearch 是什么?fsearch 是 Noah Dunnagan 开发的内置搜索引擎(MIT 许可),为快速模糊文件名搜索提供动力;FinderSearch 在它之上添加了原生 SwiftUI/AppKit 界面和文件工作流程。
What are similar projects?OpenYoink, MacPacker, tendedero, forel, PureMac, rooms, DigUp, Insomnia
Size
3.4 MB
Stars
676
Age
9d
Commits · 90 Days