TweekersNut Finder

Features

File Search

Search across all drives instantly with fuzzy matching, prefix search, and relevance scoring.

Search	What it does
`chrome`	Finds Chrome.exe, chrome.dll, and anything with "chrome" in the name
`invoice 2024`	Multi-word search — matches files containing both "invoice" AND "2024"
`*.pdf`	Not needed — just type `pdf` and filter by Documents category

2.4M+ files indexed across all connected drives
Instant results — prefix map lookup in <50ms
Smart scoring — exact matches, word-boundary matches, and fuzzy matches ranked by relevance
App boosting — installed apps (Start Menu, Desktop shortcuts) appear first

Content Search

Search inside files — find documents by their text content, not just file name.

Search	What it does
`content: invoice`	Finds all files containing the word "invoice" in their text
`content: Dry Blend Foods`	Finds the PDF invoice billed to Dry Foods
`content: API_KEY`	Finds config files, .env files, code with that string

Supported file types for content extraction:

Text/Code — .txt, .md, .js, .ts, .py, .java, .c, .cpp, .css, .html, .json, .xml, .yaml, .sql, .env, .log, .csv, and 30+ more
PDF — Text extracted from first 3 pages using pdfjs-dist
Images — OCR text extraction via tesseract.js (.jpg, .jpeg, .png, .bmp, .tiff, .webp)

Regex Search

Wrap your query in forward slashes for regex matching.

Search	What it does
`/^report.*2024\.pdf$/`	Files starting with "report" and ending with "2024.pdf"
`/\.env\..*/`	Matches `.env.local`, `.env.production`, etc.

Inline Calculator

Type any math expression directly in the search bar.

Input	Result
`234 * 52`	`= 12168`
`sqrt(144) + 10`	`= 22`
`15% of 2500`	`= 375`
`sin(45)`	`= 0.7071`

Press Enter to copy the result to clipboard.

App Launcher

Installed apps from Start Menu and Desktop are automatically detected and boosted in search results. They appear with a 🚀 icon.

Search	Action
`chrome`	Shows Chrome at the top → Enter to launch
`code`	Shows VS Code → Enter to launch
`notepad`	Shows Notepad → Enter to launch

File Preview

Hover preview — Hover over images/videos for a floating preview
Preview pane — Press Ctrl+P to open a side panel with:
- Image preview (jpg, png, gif, bmp, webp, tiff)
- Video preview (mp4, avi, mkv, mov, webm)
- Text/code preview with content display
- PDF metadata
- File size, modified date, full path

Category Filters

Filter results by file type using the pill buttons:

Filter	Extensions
All	Everything
Apps	`.exe`, `.msi`, `.bat`, `.cmd`, `.ps1`
Docs	`.pdf`, `.doc`, `.docx`, `.xls`, `.xlsx`, `.ppt`, `.pptx`, `.txt`, `.rtf`, `.csv`
Images	`.jpg`, `.png`, `.gif`, `.bmp`, `.svg`, `.webp`, `.ico`, `.tiff`, `.psd`
Video	`.mp4`, `.avi`, `.mkv`, `.mov`, `.wmv`, `.flv`, `.webm`
Audio	`.mp3`, `.wav`, `.flac`, `.aac`, `.ogg`, `.wma`, `.m4a`
Archive	`.zip`, `.rar`, `.7z`, `.tar`, `.gz`, `.iso`
Folders	Directories only

Sort Options

Relevance — Smart scoring (default)
Name — Alphabetical A→Z
Modified — Most recently changed first
Size — Largest files first

Clipboard History

Built-in clipboard manager that tracks your copy history.

Press Ctrl+Shift+V to open clipboard history panel
Click any entry to copy it back to clipboard
Clear All button to wipe history
Persists during the app session

Context Menu

Right-click any search result for:

Open — Launch the file
Show in Explorer — Reveal in Windows Explorer
Copy Path — Copy full file path to clipboard
Copy Name — Copy just the file name
Preview — Open preview pane

System Tray

App minimizes to system tray instead of closing (configurable)
Tray icon with right-click menu: Show/Quit
Global hotkey Ctrl+Win+T to toggle window from anywhere

Theme System

System — Follows Windows dark/light mode automatically
Dark — Always dark theme
Light — Always light theme

System Commands

Type commands directly in the search bar and press Enter to execute.

Command	Action
`open chrome`	Launch Google Chrome
`open firefox`	Launch Firefox
`open edge`	Launch Microsoft Edge
`open notepad`	Launch Notepad
`open code` / `open vscode`	Launch VS Code
`open explorer`	Launch File Explorer
`open terminal`	Launch Windows Terminal
`open cmd`	Launch Command Prompt
`open powershell`	Launch PowerShell
`open photoshop`	Launch Photoshop
`open word`	Launch Microsoft Word
`open excel`	Launch Microsoft Excel
`open outlook`	Launch Microsoft Outlook
`open downloads`	Open Downloads folder
`open desktop`	Open Desktop folder
`open documents`	Open Documents folder
`open pictures`	Open Pictures folder
`open music`	Open Music folder
`open videos`	Open Videos folder
`kill chrome`	Kill all Chrome processes
`kill notepad`	Kill Notepad process
`shutdown`	Shutdown PC (5s delay)
`restart`	Restart PC (5s delay)
`wifi on`	Enable Wi-Fi adapter
`wifi off`	Disable Wi-Fi adapter
`empty trash`	Empty the Recycle Bin

Keyboard Shortcuts

Shortcut	Action
`Ctrl+Win+T`	Toggle window (global — works from any app)
`Ctrl+Shift+V`	Open/close clipboard history
`Ctrl+P`	Toggle preview pane for selected file
`Ctrl+F`	Focus search input
`↑` / `↓`	Navigate results
`Enter`	Open selected file / Execute command / Copy calc result
`Escape`	Close panels / Clear search

Content Indexing

How It Works

File Indexing — Worker threads scan all drives in parallel, building an index of 2M+ files
Content Indexing — A separate worker extracts text from documents:
- Text/Code files: Reads first 2KB of content
- PDFs: Extracts text from first 3 pages using pdfjs-dist legacy build
- Images: OCR via tesseract.js (English) — extracts text from photos of documents, screenshots, etc.

Incremental Indexing

On first run: indexes everything (can take minutes for TB drives)
On subsequent runs: only re-indexes new or modified files (checks mtime)
Unchanged files are skipped instantly from cache
Deleted files are automatically pruned from cache

Persistence

Both indexes are saved to disk and loaded on startup:

file-index-cache.json — All file metadata (name, path, size, date, type)
content-index-cache.json — Extracted text content with modification times

Location: %APPDATA%\TweekersNut Finder\

Limits

Parameter	Value
Max file size for content indexing	5 MB
Max content stored per file	2 KB (text), 2000 chars (PDF/OCR)
Max PDF pages extracted	3
Max content-indexed files	50,000
Min image size for OCR	1 KB
Indexer batch size	15,000 files per IPC message
V8 heap limit	2 GB

Settings

Access via the ⚙ button in the status bar.

Close Button Behavior

Minimize to Tray — Close button hides window to system tray (default)
Quit App — Close button exits the application

Theme

System — Follows Windows theme (default)
Dark — Dark mode
Light — Light mode

Drive Selection

Choose which drives to scan (C:, D:, USB drives, network drives)
Supports Local, USB, Network, and CD-ROM drives
Re-index button to rescan selected drives