search - Search Files by Term
Fast, term-based search across your connected storage
Fast, term-based search across your connected storage
Fast, term-based search across your connected storage. Use this for quick searches where you know the term you're looking for. For more advanced scenarios like saved queries or composing queries from other queries, see find query.
Syntax
filefortress search <term> [options]
Options
| Option | Description | Example |
|---|---|---|
--remote-name |
Filter by specific remote storage name or id | --remote-name "Google Drive" |
--extensions |
Filter by file extensions | --extensions pdf,docx,txt |
--size-min |
Minimum file size | --size-min 1MB |
--size-max |
Maximum file size | --size-max 100MB |
--modified-after |
Files modified after date or relative time | --modified-after "30 days" |
--media-type |
Filter by media type | --media-type image |
--exclude |
Patterns to exclude from search | --exclude "*.tmp,temp/*" |
--min-depth |
Minimum directory depth | --min-depth 1 |
--max-depth |
Maximum directory depth | --max-depth 5 |
--view |
Output format | --view summary|list|tree|json |
--save-to-file |
Save results to file | --save-to-file results.txt |
--case-sensitive-term |
Use case-sensitive matching for the search term | --case-sensitive-term |
--meta |
Filter files by metadata predicates (format: "key operator value") | --meta "image.width>=1920" |
--remote-type |
Filter by remote storage type (gdrive, onedrive, s3, backblaze) | --remote-type gdrive |
Metadata Filtering
The --meta option supports powerful metadata predicates with these operators:
| Operator | Description | Example |
|---|---|---|
= |
Equals (exact match) | --meta "exif.cameraMake=Canon" |
!= |
Not equals | --meta "sharing.shared!=true" |
>=, >, <=, < |
Numeric/date comparisons | --meta "image.width>=1920" |
~= |
Contains (case-insensitive) | --meta "owner.email~=gmail.com" |
^= |
Starts with | --meta "hash.md5^=d128a6ef" |
$= |
Ends with | --meta "mime.type$=jpeg" |
in |
Value in pipe-separated list | --meta "exif.cameraMake in Canon|Nikon" |
exists |
Key exists (no value needed) | --meta "exif.cameraMake exists" |
Examples
Find PDF reports containing "report":
filefortress search "report" --extensions pdf --view summary
Search images in Google Drive:
filefortress search photos --media-type image --remote-name "Google Drive"
Recently modified budget files:
filefortress search budget --modified-after "30 days" --extensions xlsx,csv
Save results to a file:
filefortress search invoice --view list --save-to-file invoices.txt
Find Canon photos taken after 2020:
filefortress search "IMG" --media-type image --meta "exif.cameraMake=Canon" --meta "exif.takenAt>=2020-01-01"
Search high-resolution images:
filefortress search "photo" --meta "image.width>=4000" --meta "image.height>=3000"
Find files by hash prefix:
filefortress search "" --meta "hash.md5^=d128a6ef" --remote-type gdrive
Search Backblaze B2 storage:
filefortress search "backup" --remote-type backblaze --extensions tar,zip
Related Commands
find query
Advanced search with saved queries and composition
ls
Browse files and folders interactively
remotes scan
Update file index for better search results