Espresso Help

Searching

Start typing in the search field at the top of the window — or anywhere in the window: when the results list has the focus, typing goes straight to the search field. Results update on every keystroke; there is no Return to press.

By default Espresso looks for your text inside file and folder names, ignoring upper and lower case and accents: cafe finds Café.png, REPORT finds annual report.pdf.

The status bar shows how many items match and how long the search took, for example 1,284 items · 8 ms.

Combining words

You type Finds
invoice 2026 names containing both words
jpg | png either word
report !draft “report”, but not “draft”
"annual report" the exact phrase, space included
IMG_*.heic wildcards: the whole name must match (* any text, ? one character)
projects/espresso a slash searches the full path, not only the name

The words that matched are shown in bold in the Name column (and in the Path column for path searches). Everything else — sizes, dates, kinds, disks, tags, regular expressions — is in the Search syntax reference.

If part of a search can't be understood (for example size:lots), Espresso underlines it in the search field — hover over the search field to read why — and still runs the rest.

Search options

Click Options (the sliders button in the toolbar), or use View › Search Options:

Option What it does
Match Case Report no longer matches report.
Match Whole Words art matches “art.png” but not “smart.png”.
Match Path Every word is searched in the full path, e.g. Documents invoice.
Ignore Diacritics On by default: cafe matches café. Turn it off to tell them apart.
Regular Expressions (Barista Mode) The whole search is one regular expression. ⌥⌘R
Hidden Files and Package Contents (Lungo) Also search hidden files and the insides of apps and packages. ⌥⌘L
Show Hidden Files Include hidden files (without package contents). ⇧⌘.

Options apply to the current window. To change the defaults for new windows, see Settings › Search.

Blends: filter by kind

Blends narrow the results to one kind of file. Pick one from the Blends button in the toolbar, from View › Blends, or with ⌘1 … ⌘9:

Blend Shows
⌘1 Everything no filter
⌘2 Audio mp3, m4a, wav, flac, aiff…
⌘3 Video mp4, mov, mkv, avi…
⌘4 Images jpg, png, heic, raw formats, psd, svg…
⌘5 Documents pdf, Pages, Word, Excel, Keynote, text, Markdown…
⌘6 Folders folders only
⌘7 Archives zip, dmg, rar, 7z, tar…
⌘8 Code Swift, JavaScript, Python, C, HTML, CSS, JSON…
⌘9 Applications apps and other executables

A blend combines with what you type: Images + holiday finds pictures named “holiday”.

The sidebar decides where Espresso looks:

Your usual: saved searches

Found a search you'll need again — say “invoices from this year”? Choose File › Save Search… (⌘S), give it a name, and it appears in the sidebar under Your Usual, together with the Blend that was active.

Click a saved search to run it; typing then narrows its results further. Right-click it to Edit… its name and search, or Delete it. You can also edit them all in Settings › Search.

Past orders: recent searches

Espresso remembers the searches you settle on. Click the magnifying glass at the left of the search field to see your Past Orders and run one again, or Clear Past Orders.

Macros

A macro is a shortcut for a search you type often. In Settings › Search › Macros, add one:

Macro Expands to
projects infolder:~/Projects !node_modules

Then type projects: in any search, alone or with more words: projects: invoice. Text right after the colon is added to the search too: projects:invoice.

Duplicates (Double shot)

Type dupe: to see only items whose name appears more than once, or sizedupe: for files with the same size. Combine with anything: dupe: ext:pdf, sizedupe: size:>100mb.