everyfile

Instant file search on Windows via Voidtools Everything. Two interfaces — choose based on context:

Decision Guide

• User asks to find/list files → CLI ev or API search()
• User writes a Python script that needs file search → API (from everyfile import search)
• User asks "how many X files?" → CLI ev --count or API count()
• User asks for file contents after search → CLI ev -l | ForEach-Object { ... } or API iteration
• User asks about Everything status → CLI ev --info

Install

pip install everyfile

Search Syntax (shared across all interfaces)

Operators & Wildcards

space   AND       |   OR        !   NOT      \x3C >   grouping     " "  exact phrase
*   zero or more chars (matches whole filename by default)
?   one char

Modifiers — prefix any term or function

Filename matching:
  exact:  wfn:  wholefilename:      match whole filename ← use before regex for exact names
  nowfn:  nowholefilename:          match anywhere in filename
  path:   nopath:                   match full path vs filename only
  wildcards:  nowildcards:          enable/disable wildcard expansion

Files/folders:
  file:  files:                     files only
  folder:  folders:                 folders only

Case / encoding:
  case:  nocase:                    case-sensitive / insensitive
  diacritics:  nodiacritics:        match/ignore accent marks
  ascii:  utf8:  noascii:           fast ASCII case comparisons

Word / regex:
  ww:  wholeword:  noww:  nowholeword:   whole words only
  regex:  noregex:                       enable/disable regex

Functions

Extension / type:
  ext:\x3Cext>              ext:py   ext:py;js;ts  (semicolon OR list)
  type:\x3Ctype>            file type description string

Paths:
  parent:\x3Cpath>          in path, including subfolders
  infolder:\x3Cpath>        in path, NO subfolders  (alias: nosubfolders:\x3Cpath>)
  depth:\x3Cn>              folder depth from drive root
  root:                  items with no parent folder (drive roots)
  shell:\x3Cname>           known shell folder (Desktop, Downloads, Documents…)
  child:\x3Cname>           folders containing a matching child
  childcount:\x3Cn>         folders with n total children
  childfilecount:\x3Cn>     folders with n files
  childfoldercount:\x3Cn>   folders with n subfolders

Size:
  size:\x3Csize>            size:>1mb  size:2mb..10mb
  size words: empty  tiny  small  medium  large  huge  gigantic

Dates (all share same value syntax):
  dm:   datemodified:     dc:  datecreated:
  da:   dateaccessed:     dr:  daterun:
  rc:   recentchange:
  Constants: today  yesterday
    \x3Clast|past|prev|this|current|next>\x3Cyear|month|week>
    last\x3Cn>\x3Cyears|months|weeks|days|hours|minutes|seconds>
    january..december  jan..dec  sunday..saturday  sun..sat  unknown

Attributes:
  attrib:\x3Cflags>    A=archive  C=compressed  D=dir  E=encrypted  H=hidden
                    I=not-indexed  L=reparse  N=normal  O=offline  P=sparse
                    R=readonly  S=system  T=temp

Duplicates:
  dupe:          same filename       namepartdupe:  same name (no ext)
  sizedupe:      same size           dmdupe:        same date modified
  dcdupe:        same date created   dadupe:        same date accessed
  attribdupe:    same attributes

Filename text:
  startwith:\x3Ctext>         filename starts with
  endwith:\x3Ctext>           filename ends with
  len:\x3Cn>                  filename character length

Miscellaneous:
  empty:                   empty folders
  count:\x3Cn>                limit results to n
  runcount:\x3Cn>             Everything run count
  filelist:\x3Ca|b|c>         pipe-delimited filename list
  filelistfilename:\x3Cfile>  load list from file
  frn:\x3Clist>               semicolon-delimited File Reference Numbers
  fsi:\x3Cindex>              internal file system index

Content search (slow — narrow with other filters first!):
  content:\x3Ctext>           via iFilter, falls back to UTF-8
  ansicontent:  utf8content:  utf16content:  utf16becontent:

Images (slow): width:\x3Cpx>  height:\x3Cpx>  dimensions:\x3Cw>x\x3Ch>  orientation:landscape|portrait  bitdepth:\x3Cn>
ID3/FLAC (slow): title:  artist:  album:  genre:  track:  year:  comment:

Value / range syntax

fn:value      fn:=value    fn:>value    fn:>=value    fn:\x3Cvalue    fn:\x3C=value
fn:start..end   (range, inclusive)     fn:start-end  (alternative range)

Built-in macros

File groups:    audio:  video:  doc:  pic:  zip:  exe:
Literal chars:  quot:"  apos:'  amp:&  lt:\x3C  gt:>  #\x3Cn>:  #x\x3Cn>:  (unicode dec/hex)

Key examples

exact:env.json                           exact filename (not substring)
ext:py;js;ts                             multiple extensions
ext:py dm:thisweek size:>10kb            AND combination
parent:C:\Dev\myproject                  in folder (+ subfolders)
infolder:C:\Dev\myproject                in folder only, no subfolders
sizedupe: ext:mp4 size:>1gb             large duplicate videos
ext:py content:"TODO"                   content search (slow)
attrib:H                                 hidden files
dm:last7days size:>1mb                   modified last 7 days
startwith:test_ ext:py                   files starting with test_

Safety

• Confirm with the user before piping results into destructive commands
• Use count first (count_files / ev --count / count()) to check scale before bulk operations
• Use limit/-n/max_results when testing queries
• Everything must be running — all interfaces error if it's not