// troubleshooting guide · keypirinha
Keypirinha Not Finding Files or Folders
- Status
- Workaround available
- platforms:
- Windows
- updated:
- November 16, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · keypirinha/not-finding-files4 FIXES
// quick answer
Keypirinha only catalogs the Start Menu and similar locations by default. Add folders to extra_paths with ** (and no trailing backslash), or search the whole disk through the Everything package.
Most likely fix: Add folders with a recursive wildcard
How to fix it
// try these in order, the most common fix is first
FIX 1Add folders with a recursive wildcard
- 01Run Keypirinha: Configure Package: Apps
- 02Edit the User file (right side), not the Default one
- 03Under [main] add: extra_paths = ${env:USERPROFILE}\**
- 04Save and wait for the catalog to rebuild
Did this fix it?FIX 2Remove the trailing backslash
- 01C:\Users\*\*\ indexes only executables
- 02Use C:\Users\** to index all file types recursively
Did this fix it?FIX 3Use Everything for whole-disk search
- 01Install and run Everything from voidtools
- 02In Keypirinha search for Everything: Search, press Tab and type your query
Did this fix it?FIX 4Try the FilesCatalog or FileBrowser packages
- 01FilesCatalog catalogs chosen folders with filters
- 02FileBrowser lets you browse paths as you type
Did this fix it?
SANDBOX · keypirinha RUNS IN YOUR BROWSER
Try it: a launcher with snippets and clipboard history
A hands-on Keypirinha-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
Searches return only apps, the catalog holds about a thousand items, or files you know exist never appear.
Why it happens
- C-01Folders aren't in the Apps package's extra_paths
- C-02A single * doesn't recurse into subfolders
- C-03A trailing backslash limits matches to executables (PATHEXT types)
- C-04Editing the Default ini file instead of the User file
// this guide also covers
- keypirinha not finding files
- keypirinha search folders
- keypirinha extra_paths
- keypirinha index folder
Still not working?
If Keypirinha keeps failing, you're not alone. See every Keypirinha problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to us