Options · General
All Options tabs are accessible from View → Options Page.
Results List options
basehead has three ways to return search results. The mode you’re in is set by two toggles in this section — Limit Records Returned and Enable Paging:
1 · Uncapped (default). Both toggles off. Every matching record loads into the grid; display is virtualized so it stays fluid. Best for typical libraries up to a few hundred thousand records.
2 · Capped. Limit Records Returned on. Results stop at the Max Records Returned value. Best when you want a hard ceiling on memory use. Hold Ctrl/Cmd while searching to bypass the cap for one search.
3 · Paging. Enable Paging on. Only one page of records lives in RAM at a time (page size = Max Records Returned). The first page lands quickly regardless of total match count; the rest auto-load as you scroll or play through. Designed for libraries above ~500,000 records. When paging is on, Limit Records Returned is inactive (paging supersedes the cap).
Limit Records Returned
Toggles capped mode (mode 2 above). Off by default for new installs and existing settings files without this field set.
Short-search soft cap: when uncapped, a 1–2 character search with no tree-node selection (Import, Group, Folder, Collection, CloudPack, Path) and no satellite filter still gets a safety cap of 30,000 rows. If matches are under 30k, all are shown; over 30k, results fall back to Max Records Returned. This stops launch-time auto-fires from dragging the entire DB into memory. 3+ characters bypass it, as does a tree-node or satellite filter, as does the Ctrl/Cmd override.
Enable Paging (very large libraries)
Switches the Results grid to server-side paging (mode 3 above). Clicking a column header re-issues the search from page 1 with the new sort — paging mode needs correctness across the full match set, so reordering one page in place would be misleading. Lock Block searches and PSE store searches bypass paging automatically (they need the full set for their own filtering). The status bar shows Displaying X of Y Records where X is loaded so far and Y is the total match count.
Max Records Returned
Cap value (mode 2) or page size (mode 3). Choices: 1000, 4000, 8000, 12000, 20000, 40000. Inert when both toggles are off. Lower values keep things snappy on slow systems or large libraries.
Override: Hold Ctrl (Windows) or Cmd (macOS) when triggering a search to bypass the cap or soft cap for that one search. Useful for full-result audits, exports, or batch operations.
Dim Played Records
Dims records you’ve already played for visual feedback.
Retain Dimmed Records
Remembers which records you’ve clicked until manually cleared. The count shows on the right of the Results tab — click the count ball to reset to zero.
Expand Rows Dynamically
Turn ON if you don’t want to see multi-line descriptions.
Disable Split File Matching
Disables Split File grouping (the orange Split icon next to records) and shows the individual files instead.
Hover any other option on this tab to learn what it does.
Misc options
Program Language
Choose between 12 languages: English, Deutsch, Français, Español, 日本語, 中文 (简体), 中文 (繁體), 한국어, Italiano, Português, Русский, Nederlands. The whole UI re-skins on the fly — menus, tooltips, dialogs, panels, all of it — not just a subset.
Delay tooltips
Shows tooltips 4 seconds after mouse hover so power users aren’t annoyed.
Optimize for Cloud NAS
Turn this on if your files live on a Cloud NAS like LucidLink or Google Drive with file streaming. Improves performance for cloud-based NAS — and can help with slow local networks too.
For Google Drive users who want to use cloud streaming, set your Drive option to allow file streaming:
Settings
Use External Settings
Store your settings, licenses, presets, and databases on an external drive. See the External Settings page for the full guide.