--- name: everyfile description: > Fast file and folder search on Windows via Voidtools Everything. Use when the user asks to find, list, or count files/folders — by name, path, extension, size, date, or duplicates. Provides the CLI (ev) and Python API. Prefer over Get-ChildItem or dir when Everything is running and broad/instant search is needed. Covers: "find files", "search for files", "locate a file/folder", "where is X", "list files by extension", "find large/recent/duplicate files". Do NOT use for Linux/macOS or when Everything is not installed. license: MIT compatibility: > Requires Windows, Python >= 3.11, and Voidtools Everything (1.4, 1.5, or 1.5a) running in the background. metadata: {"author": "LouisGameDev", "openclaw": {"os": ["win32"], "requires": {"bins": ["ev"]}, "install": [{"id": "pip", "kind": "pip", "package": "everyfile", "bins": ["ev", "every", "everyfile"], "label": "Install everyfile (pip install everyfile)", "os": ["win32"]}]}} --- # everyfile Instant file search on Windows via [Voidtools Everything](https://www.voidtools.com/). Two interfaces — choose based on context: | Interface | When to use | Reference | |-----------|-------------|----------| | **CLI** (`ev`) | Terminal commands, shell scripts, piping results between commands | [cli.md](references/cli.md) | | **Python API** | Python scripts/tools that need programmatic file search, Cursor/Row iteration | [api.md](references/api.md) | ## 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 ```powershell pip install everyfile ``` ## Search Syntax (shared across all interfaces) ### Operators & Wildcards ``` space AND | OR ! NOT < > 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: ext:py ext:py;js;ts (semicolon OR list) type: file type description string Paths: parent: in path, including subfolders infolder: in path, NO subfolders (alias: nosubfolders:) depth: folder depth from drive root root: items with no parent folder (drive roots) shell: known shell folder (Desktop, Downloads, Documents…) child: folders containing a matching child childcount: folders with n total children childfilecount: folders with n files childfoldercount: folders with n subfolders Size: size: 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 last january..december jan..dec sunday..saturday sun..sat unknown Attributes: attrib: 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: filename starts with endwith: filename ends with len: filename character length Miscellaneous: empty: empty folders count: limit results to n runcount: Everything run count filelist: pipe-delimited filename list filelistfilename: load list from file frn: semicolon-delimited File Reference Numbers fsi: internal file system index Content search (slow — narrow with other filters first!): content: via iFilter, falls back to UTF-8 ansicontent: utf8content: utf16content: utf16becontent: Images (slow): width: height: dimensions:x orientation:landscape|portrait bitdepth: ID3/FLAC (slow): title: artist: album: genre: track: year: comment: ``` ### Value / range syntax ``` fn:value fn:=value fn:>value fn:>=value fn: #: #x: (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

everyfile

Description

Latest Changes

Install everyfile with One Click