// troubleshooting guide · keypirinha

Keypirinha Not Finding Files or Folders

Status
Workaround available
platforms:
Windows
updated:
November 16, 2026
reports:
2
Method
how we research
Share

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

  1. FIX 1Add folders with a recursive wildcard

    1. 01Run Keypirinha: Configure Package: Apps
    2. 02Edit the User file (right side), not the Default one
    3. 03Under [main] add: extra_paths = ${env:USERPROFILE}\**
    4. 04Save and wait for the catalog to rebuild
    Did this fix it?
  2. FIX 2Remove the trailing backslash

    1. 01C:\Users\*\*\ indexes only executables
    2. 02Use C:\Users\** to index all file types recursively
    Did this fix it?
  3. FIX 3Use Everything for whole-disk search

    1. 01Install and run Everything from voidtools
    2. 02In Keypirinha search for Everything: Search, press Tab and type your query
    Did this fix it?
  4. FIX 4Try the FilesCatalog or FileBrowser packages

    1. 01FilesCatalog catalogs chosen folders with filters
    2. 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

Watch Keypirinha Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other Keypirinha errors

All 11 Keypirinha errors and fixes →