Does HoudahSpot replace Spotlight?

No. HoudahSpot reads from the same Spotlight index — it's a professional interface to the same data, not a replacement. Spotlight continues to run and maintain the index. HoudahSpot is the better choice for complex, multi-criteria searches; Spotlight remains faster for quick name lookups and app launching.

If Spotlight can't find a file, can HoudahSpot find it?

Sometimes yes, sometimes no. HoudahSpot can find files that Spotlight's own window filters out — like files in ~/Library or in hidden system folders — because it presents the full index without Spotlight's presentation-layer filters. But if a file isn't in the index at all (corrupted index, excluded location, external drive not indexed), HoudahSpot won't find it either. Fix the index first.

Why is HoudahSpot faster than Spotlight for some searches?

HoudahSpot constructs precise MDQuery expressions from your search criteria, which the index can resolve efficiently. Spotlight's window performs additional ranking and mixing that adds latency. For simple name lookups, Spotlight is effectively instant. For complex metadata queries across large file collections, HoudahSpot's more direct querying approach and filtered result display can feel faster.

Does HoudahSpot work if I've never used Spotlight?

HoudahSpot relies on the Spotlight index being active and up to date. As long as Spotlight indexing is enabled on your Mac (it is by default), HoudahSpot will work. You don't need to have ever opened the Spotlight window. The index runs in the background regardless.

HoudahSpot and Spotlight: How They Work Together on Mac

HoudahSpot Uses the Spotlight Index

Every time HoudahSpot searches, it queries the Spotlight index — the same database maintained by the mds daemon and queried by Finder and the Spotlight window. HoudahSpot uses Apple's MDQuery API, exactly as any other macOS app would.

This has an important consequence: anything Spotlight knows, HoudahSpot can find. Because the data comes from the same index, HoudahSpot is just as fast as Spotlight for content and metadata searches. There's no separate database to maintain and no additional indexing step.

It also means the reverse is true: if a file isn't in the Spotlight index, HoudahSpot won't find it either. Files on unindexed external drives, locations in the Spotlight privacy list, or files in folders with .metadata_never_index present — none of these will appear. If you're missing results, check the index health first. See Why Spotlight Can't Find Your Files for a full diagnostic guide.

What the Spotlight Window and Finder Hide

The Spotlight index contains far more than Spotlight's own interface shows you. Apple designed the Spotlight window for general-purpose quick access — not power searching. To keep it clean and fast, it applies several filters:

Category mixing: results include web suggestions, System Settings… → Spotlight → Search Privacy knowledge, app shortcuts, unit conversions, and definitions alongside actual files. This is useful for a general search bar; it's noise when you're trying to find a specific file.
~/Library filtering: files in your Library folder (app preferences, caches, application support data) are in the index but suppressed in the Spotlight window's default results to avoid overwhelming non-technical users.
Implicit relevance ranking: Spotlight scores and sorts results by its own relevance algorithm. You can't override the sort, specify must-include conditions, or say "return only files modified in the last 30 days."
No location control: you can't tell Spotlight to search only /Users/you/Documents or to exclude /Users/you/node_modules.

Finder's search (Cmd+F) is better in that it shows files only and scopes to your current folder — but it still lacks multi-condition logic, metadata depth, and location exclude.

What HoudahSpot Adds

HoudahSpot presents the same index through a purpose-built search interface with no presentation-layer compromises:

Files only

Results are always files — no web results, System Settings… → Spotlight → Search Privacy noise, or mixed categories. Every item in the HoudahSpot results list is a real file you can open, preview, or act on immediately.

Full index access

HoudahSpot surfaces files from ~/Library, system directories, and other locations that Spotlight's UI filters by default. Users who need to find application support files, configuration files, or cached data can reach them directly without knowing where to look in advance.

Visual query builder

Add criteria rows for any combination of: file name, kind (document, image, movie, audio…), content text, date created, date modified, file size, macOS tags, GPS coordinates, camera model, author, and hundreds of other kMDItem attributes. Combine criteria with AND, OR, or NOT logic. Each row is a filter; the result set narrows or expands live as you change it.

Location include and exclude

Specify exact folders to search inside, or folders to skip. This is the HoudahSpot feature that makes the biggest practical difference for users with complex folder structures: search only ~/Documents/Projects, or search everywhere except ~/Library and ~/node_modules.

Saved searches

Save any query configuration as a named search. Open it any time with one click. Useful for things you check repeatedly: "PDF invoices from this quarter," "RAW photos taken with my Fuji," "large video files older than one year."

Iterative refinement

Start with a broad query, read the results, add one condition to narrow down, read again, refine again. HoudahSpot's live result updating makes this workflow fast and natural. See Iterative File Search for a full walkthrough.

The Consequence: Index Health Matters for Both

Because HoudahSpot reads the Spotlight index, the quality of that index directly affects HoudahSpot results. If you notice HoudahSpot not returning files you know exist:

Check that the file's location isn't in the Spotlight Privacy exclusion list
Verify HoudahSpot has Full Disk Access in System Settings → Privacy & Security
Consider rebuilding the Spotlight index if neither of the above applies

The HoudahSpot troubleshooting guide walks through each of these steps in detail.

HoudahSpot and Spotlight: Better Together