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 может его заблокировать, и понадобится выбрать 'Open Anyway' в настройках Privacy & Security.
Работает ли он и на Intel Mac?Он нацелен на Apple Silicon, что проверено и работает; сборки для Intel существуют, но автор их не проверял.
Мои данные куда-то загружаются?Нет, поиск выполняется полностью локально на вашем Mac, и файлы никуда не загружаются.
Почему FinderSearch быстрее Spotlight?Он работает на движке fsearch, который в бенчмарках выдавал результаты точного поиска по имени за 0.49–1.14 мс против 7.06–7.30 мс у Spotlight на Apple M4 на 10 000 тестовых файлов.
Какие функции управления файлами есть помимо поиска?Есть рамочное выделение, копирование/перемещение, пакетное переименование, инструменты ZIP, теги, шаринг, Корзина и отмена, плюс режимы значков/списка/колонок/галереи с превью Quick Look и вкладками, которые восстанавливаются при повторном открытии.
Что такое fsearch?fsearch — включённый в поставку поисковый движок Ноа Даннагана (лицензия MIT), на котором держится быстрый нечёткий поиск по именам; FinderSearch добавляет поверх него нативный интерфейс на SwiftUI/AppKit и файловые сценарии работы.
What are similar projects?OpenYoink, MacPacker, tendedero, forel, PureMac, rooms, DigUp, Insomnia
Size
3.4 MB
Stars
673
Age
8d
Commits · 90 Days