Help center

Finding an answer should be as fast as finding a file

No hopping between pages. Everything is here — search it, or jump from the table of contents.

Nothing matched. Try a shorter keyword, or just tell us where you are stuck.

Getting started

Quick start: from install to your first search

Five steps, about three minutes. If you remember only one thing, make it ⌥Space.

  1. Install from the Mac App StoreOpen the Locseek App Store page and click Get. That is the only official download channel. Requires macOS 12 or later; Intel and Apple Silicon are both native.
  2. Launch and choose what to indexThe first-run flow asks you to grant folders: the free tier offers any combination of Desktop / Documents / Downloads (starting with just one is fine — the other two can be added later), and Pro can take the whole startup disk, any folder, external drives or a NAS. Wherever you point it is what it searches.
  3. Tick "Launch at Login" if you like (optional)That checkbox is off by default and only registers if you turn it on yourself. We recommend it: without the app running, the global hotkey does nothing, and file changes accumulate while the process is gone, so the next launch may need to scan a little more. Leaving it off is perfectly fine too.
  4. Press ⌥Space and type a nameResults appear as you type — you can search while the initial scan is still running.
  5. Space to preview, Return to openConfirm with Quick Look first, then open — or ⌘Return to reveal in Finder.
Getting started

Permissions and authorization

macOS strictly limits which files an app may reach: what you can search depends on what you granted. This is also where the single most common complaint — "the permission dialog keeps reappearing" — gets solved.

Why do I have to pick folders?

An app installed from the Mac App Store can only reach locations you explicitly grant through the system file picker — grant once and the system remembers, so you are not asked again. That mechanism is precisely what protects you: outside that scope the app cannot touch a single byte at the OS level. Granted locations can be added or removed any time under Locseek's Settings → Locations, and revoked in System Settings → Privacy & Security → Files and Folders.

"Locseek wants to access data from other apps" keeps coming back? Try these four in order

On macOS 14+, the system shows this confirmation when an app reaches a protected location or files created by another app. It is system behaviour, not Locseek asking for extra privileges. If you already clicked Allow and it still returns:

  1. Toggle App Management off and onSystem Settings → Privacy & Security → App Management. Turn Locseek's switch off, then on, then restart Locseek.
  2. Restart your MacThis refreshes the system permission cache and resolves most repeat prompts.
  3. Delete and reinstall LocseekReinstall from the App Store and grant your locations again (the index rebuilds automatically).
  4. Grant Full Disk AccessSystem Settings → Privacy & Security → Full Disk Access. Enable Locseek and restart the app; the prompt stops.

Why doesn't resetting with tccutil help?A command-line reset only clears the record — the next time the system needs access it still "fails to remember your Allow", and the dialog returns. Use the System Settings paths above.

Full Disk Access: when it matters

Locseek does not request any Full Disk Access entitlement and its design does not depend on one — the free tier's scope is just Desktop / Documents / Downloads, and the app never even raises the subject of FDA for free users.

It matters in exactly two Pro situations: indexing parts of the startup disk that macOS additionally protects, and allowing the "Cloud file names" and "App private data" default exclusions. Path to grant it: System Settings → Privacy & Security → Full Disk Access. Without it, everything else works normally.

To be explicit: FDA only widens which names it can see. The product commitments do not change by a word — no file contents read, no network, no uploads.

Revoking access and erasing data

  • Remove one location: Locseek Settings → Locations, then remove it. That only changes the index scope; nothing on disk is touched.
  • Revoke system permissions: System Settings → Privacy & Security → Files and Folders / Full Disk Access.
  • Drop just the index: Settings → About → "Delete Index…". The app quits and rebuilds on next launch.
  • Erase everything: Settings → About → "Reset All Local Data…". It deletes everything Locseek wrote on this Mac — settings and preferences, search and open history, the index, learned ranking data, saved folder access, the login-item registration, caches, window state and crash reports — then quits immediately. Your files are never touched.
  • The two things the app cannot delete itself: drag Locseek to the Trash, then use Finder's "Go to Folder" with ~/Library/Containers/ and delete the Locseek entry (all App Store version data lives inside the sandbox container). System privacy grants have to be revoked by you in System Settings.
Going further

Search syntax

Beyond keywords, operators narrow everything in one line. Press Tab to complete an operator (exext:); operators are coloured and shown as visual chips. Forgot the syntax? Clear the search field — "Efficient usage" in the empty state is the same cheat sheet, collapsible.

  • Keywords are case-insensitive; multiple keywords are AND: invoice 2026
  • Ranking: exact > prefix > word-start > contains, with recent modification breaking ties. Stable and predictable.
SyntaxWhat it doesTier
KeywordsMultiple keywords all have to match; case-insensitive: invoice 2026Free
ext:By extension: ext:pdf, or ext:jpg|pngFree
under:Pin to one exact folder and all its subfolders: under:"/Users/you/Documents/Work", never catching Work-old. Must be an absolute path~ is not expanded, so pasting the full path from Finder is fastestFree
hidden: package:Only hidden items / only inside bundles: hidden:true, package:true; false excludes them insteadFree
kind:By kind: kind:image (image / video / audio / document / archive / code / application / folder)PRO
in:Path contains: in:Projects; quote it for spaces, in:"Application Support"PRO
size:Comparisons and ranges: size:>100mb, size:10mb..1gbPRO
date:Modification time: date:today, date:>2026-01PRO
/regex/Regex on the name; append c for case sensitivity: /^IMG_\d{4}\.jpg$/PRO
! | *Exclude / or / wildcard: design !draft, budget | forecast, budget*2026PRO

Recipes

ext:pdf report date:today !draft # PDF reports touched today, drafts excluded (Pro)
kind:video size:>100mb in:Projects # Large videos inside a project path (Pro)
under:"/Users/you/Documents/Finance" invoice ext:pdf # Exact subtree search, free tier

No results? Check whether the under: boundary is too narrow or you typed one keyword too many. A whole-disk regex is a heavy query (seconds are expected) — pair it with a keyword or ext: for everyday use.

Going further

Keyboard shortcuts

From summon to Finder without touching the mouse. The summon hotkey defaults to ⌥Space and can be rebound to any combination containing .

Summon and select

Show / hide the window⌥ Space
Clear the query, then dismissEsc
Select up / down
Extend selection / select all click · ⌘ A
Back to the search field from the first row
Recall the last query in an empty field
Settings / quit⌘ , ⌘ Q

Acting on results

OpenReturn
Reveal in Finder⌘ Return
Quick Look previewSpace
Copy file / full path / file name⌘ C ⌥ ⌘ C ⇧ ⌘ C
Type in the list to continue in the search fieldany character
Move to Trash (with confirmation)right-click menu
Rename one item · Search in This Folderright-click menu

Dragging is a first-class citizen:drag results straight into Finder, Mail, or anything that accepts files. Bulk open and move-to-Trash are capped at 10 items in the free tier and unlimited in Pro (large batches explain the consequences first). Permanent deletion, compression and arbitrary moves are deliberately left to Finder — Locseek does not escalate privileges on your behalf.

Troubleshooting

A file won't show up? Check these four

This is the most common question, and it is almost never a bug. Walk the list in order — usually the first or second item is the answer.

① Is it inside a location you granted?

Locseek only indexes locations you explicitly granted through the system picker. For the free tier that is whichever of Desktop / Documents / Downloads you selected; for Pro, whatever you added. A file outside that scope is not "unfindable", it was simply never collected.
Open Settings → Locations and look at the list and each row's status dot: green is readable, grey means offline or the authorization lapsed (click "Re-authorize").

② Does it fall into a default exclusion?

To keep everyday results clean, Locseek excludes four categories by default. Changing these switches requires Pro; the free tier can read the explanations but not change them (its scope is only those three everyday folders anyway).

Excluded by defaultWhat it meansHow to allow it
Cloud file namesThe local directories of iCloud Drive, Dropbox and OneDrivePro + Full Disk Access
App private dataWhere apps keep their own files — received attachments, mail downloads and the likePro + Full Disk Access
Build artifacts and dependenciesnode_modules, .git, DerivedData, __pycache__, .buildPro
TrashDeleted files that have not been emptied yetPro

To allow one: Settings → Exclusions, then untick the category. Unticking only changes what the query shows — no rescan, no index rewrite, so results grow immediately. Even once allowed, the cloud categories still index file names only and never read or download content.

Locseek tells you about this on its own: when a zero-result search really was blocked by an exclusion, a clickable hint such as "Cloud file names are currently excluded · Go to exclusions" appears under the search field. You do not have to guess.

③ Has the first scan finished?

Check the status bar: "Building index · N searchable" means it is still scanning and results keep growing; plain "N items" means it has settled. Building the first full-disk index takes time depending on your drive and file count — but your everyday folders are searchable while it runs, so there is no need to wait around.

④ Is the query too narrow?

  • Multiple keywords means all of them must match. Try dropping one.
  • under: is an exact folder boundary and requires an absolute path; written as ~/… the condition is discarded.
  • A query with only exclusions (just !draft, say) returns nothing — it still needs a term to look for.
  • hidden: / package: mean "only this kind", not "also this kind" — hidden items and bundle contents are already in scope by default, so you usually do not need them at all.

Still nothing?

Once you have ruled out all four, consider Settings → Index → Maintenance → "Rebuild Index…". Search stays available during a rebuild (the old index keeps serving), and the status bar returns to a normal count when it finishes. You only need this when results clearly disagree with the disk and waiting for the automatic update did not fix it.

Troubleshooting

Other problems

For "a file won't show up", see the previous section. These are the remaining symptoms.

A file I just created or renamed isn't searchable

  • Normally a change becomes searchable in about 1 second (internal benchmarking puts the p95 at roughly 1.0 s over a 120-minute churn sample). Give it a moment and try again.
  • Check whether Settings → Index → Maintenance → "Pause automatic updates" is on. While paused, the existing index and search still work, but creates, renames and deletes are not reflected.
  • Confirm the file is inside a granted location and not in a default exclusion.
  • Still nothing: Settings → Index → Maintenance → "Rebuild Index…".

The permission dialog keeps reappearing

See the four-step fix under Permissions: toggle App Management → restart → reinstall → Full Disk Access.

Files in cloud drives (iCloud / OneDrive / Dropbox / Google Drive)

  • Not searchable by default — that is design, not a fault. "Cloud file names" is one of the four default exclusions; see the previous section for how to allow it (Pro + Full Disk Access).
  • Once allowed, cloud-only placeholder files record only name and path and never trigger a download — you can find them, and the system downloads only when you open one. No bandwidth, no disk.
  • Adding "iCloud Drive" straight from Finder works too: the system picker hands back a compatibility subdirectory, and Locseek maps it onto the complete iCloud name space rather than scanning only a few dozen items.

One search suddenly got slow

  • A whole-disk regex is a heavy query and seconds are expected; narrow it with a keyword, ext: or under:.
  • If ordinary searches stay slow, check whether the index indicator is busy — scanning or consolidation briefly slows things and recovers when done.

Other frequent situations

  • Bulk actions cut off at 10 items: that is the free-tier boundary, not a fault. Work in batches or upgrade to Pro.
  • The result count sits at the limit: the status bar explains that matches exceeded the limit and only the most relevant N were kept. Clicking a column header sorts within that batch rather than re-drawing from all matches — narrowing the keyword is more effective. The free limit is 1,000; Pro can raise it to 30,000 in Settings.
  • ⌥Space does nothing: make sure the app is running (look for the menu-bar icon); if the hotkey clashes with another app, pick a different combination under Settings → Shortcuts. Clicking the menu-bar icon also shows the window.
  • Full rebuild: Settings → About → "Delete Index…". The app quits and rebuilds on the next launch. You never need to delete any directory by hand.
  • Want to send feedback without exposing file names: Settings → About → "Copy Diagnostics". It contains only the version, index counts and the most recent rebuild reason — no paths, no file names.
Buying

Purchases and subscriptions

Every transaction goes through the Mac App Store and is handled by Apple — Locseek never touches your payment details.

  • Two ways to Pro, identical features: $9.99/year auto-renewing, or $24.99 once (US reference prices; your region's App Store price applies).
  • 14-day free trial: granted automatically to eligible new subscribers of the annual plan; cancel before it ends and you are not charged. Eligibility is determined by the App Store and shown in the in-app purchase screen before you buy — treat that as authoritative.
  • Restore purchases (new Mac / reinstall): sign in with the same Apple Account → download Locseek from the App Store → tap "Restore Purchases" on the in-app purchase screen.
  • Cancel a subscription: App Store → avatar → Account Settings → Subscriptions → cancel. Pro remains available for the current period.
  • Refunds: go to reportaproblem.apple.com and follow Apple's standard policy.
  • Switching from annual to lifetime: cancel the subscription first (it stays usable to the end of the period), then buy Lifetime in the app.
  • Invoices / receipts: provided by Apple — see your purchase confirmation email or reportaproblem.apple.com.
  • What happens if I go back to free: when the subscription lapses you return to the free tier. Your index, settings and granted locations are all kept; the result limit returns to 1,000 and advanced queries and exclusion settings become unavailable. Folder grants you already made are not revoked.

For the complete tier comparison see the pricing page.

More

Frequently asked

The most common questions, each answered in about three sentences.

Does Locseek read my file contents?

No. It indexes names, paths, sizes, and modification and creation times — there is simply no content in the index. That is also why it cannot do full-text search; when you need to search by content, use Spotlight.

Is my data uploaded anywhere?

No. Indexing and searching make no network requests; there is no account, no telemetry and no advertising SDK. See the privacy policy.

What are the free tier's limits? Does it expire?

Free forever, no expiry: index any combination of Desktop / Documents / Downloads (each authorized separately), up to 1,000 results, with speed and accuracy identical to Pro. Hidden items and app bundle contents are in scope by default, and Open, Quick Look and Reveal in Finder all work.
Pro is needed for: any location, kind: and the remaining advanced queries, changing exclusion settings, learned ranking, pinned searches, and a higher result limit.

What does Pro unlock?

Any location (whole startup disk, any folder, external drives, USB sticks, NAS, network shares); kind: / regex / size / date / path / exclusions / OR / wildcards; a result limit configurable up to 30,000; learned ranking, pinned searches, and control over what gets excluded. See the full comparison.

What are the system requirements?

macOS 12 Monterey or later. Both Intel and Apple Silicon are supported natively.

Does it support external drives, USB sticks and NAS?

Yes, as part of Pro. While a drive is unplugged its entries temporarily drop out of results and come back automatically once it is mounted again.

Can it find cloud-only files in iCloud?

Yes, but it is off by default: "Cloud file names" is one of the four default exclusions and needs Pro + Full Disk Access to allow (how to allow it). Once allowed, placeholder files contribute only name and path and never trigger a download; the system downloads only when you open one.

Can it search hidden files and inside .app bundles?

Yes, and it is on by default ("Index hidden files" and "Index inside app bundles" are both ticked under Settings → Index). Use hidden:true / package:true to look at only those, or false to exclude them — available in the free tier.

Do I have to enable "Launch at Login"?

Not required, but recommended. The checkbox is off by default in the first-run flow and only registers if you turn it on yourself. Without it: the global hotkey does nothing while the app is not running, and file changes accumulate meanwhile, so the next launch may need to scan more. You can change it in Settings at any time.

How many results can it show?

1,000 in the free tier. Pro can choose 1,000 / 2,000 / 5,000 / 10,000 / 30,000 under Settings → General → "Search result limit". Beyond the limit only the most relevant are kept, and the status bar says so explicitly.

How does it relate to Spotlight?

They complement each other. Spotlight handles broad retrieval across contents, mail and the web; Locseek only perfects finding a file by name. See the comparison.

Is there a Windows version?

The app interface is localized into 22 languages and follows your system setting. There is no Windows version — Locseek is Mac only; on Windows, take a look at Everything for a comparable experience.

Does learned ranking collect my habits?

It records, on this machine, which files you open and which ones you repeatedly open from the same query, in order to rank your frequent files higher. The data stays on this Mac and never goes online. Settings → General lets you switch off "Rank by usage habits", or click "Clear Usage History…" to wipe it in one go (recent searches, recently opened and learned ranking data all go; pinned searches, settings, grants and purchases are kept).

How do I uninstall completely?

First use Settings → About → "Reset All Local Data…" (the app cleans up after itself and quits), then drag the app to the Trash. Finally, if you want the empty container gone too, use Finder's "Go to Folder" with ~/Library/Containers/ and delete the Locseek entry. App Store purchase records belong to your Apple Account, not to this machine.

None of this helped? The in-app "Report an Issue" menu drafts an email prefilled with version information only (never any file names), or write to support@locseek.com.