term argument
search
Search and Filter Files
Search and filter files across your connected storage with powerful options for term-based search, path filtering, and query persistence. This is the primary command for finding files in FileFortress.
Advanced Filters
Query Persistence
Metadata Search
Syntax
filefortress search [term] [options]
Note: The term argument is optional. If omitted, the command performs filtering only (no term search).
Key Features
Term-based search with
Path pattern filtering with
--path-filter
Save queries with
--save-query
Build on saved queries with
--from-query
Fixed snapshots with
--fixed
Metadata filtering with
--meta
NEW
Structured metadata filters (duration, dimensions, camera, storage class)
Options
| Option | Description | Example |
|---|---|---|
--remote, -r |
Filter by specific remote storage name or id | --remote "Google Drive" |
--extensions, -e |
Filter by file extensions | --extensions pdf,docx,txt |
--size-min, -s |
Minimum file size | --size-min 1MB |
--size-max, -S |
Maximum file size | --size-max 100MB |
--modified-after, -m |
Files modified after date or relative time | --modified-after "30 days" |
--media-type, -t |
Filter by media type | --media-type image |
--exclude, -x |
Patterns to exclude from search | --exclude "*.tmp,temp/*" |
--view, -v |
Output format | --view summary|list|tree|json |
--save-to-file, -o |
Save results to file | --save-to-file results.txt |
--path-filter, -p |
Filter files by path pattern (glob-style) | --path-filter "*.txt" |
--save-query, -q |
Save the query with the specified name | --save-query "my-photos" |
--from-query, -Q |
Use results of another query as base | --from-query "base-query" |
--meta, -M |
Filter by metadata predicates | --meta "image.width>=1920" |
Structured Metadata Filters
NEW
These filters query structured metadata extracted from your files. Run filefortress remotes enrich
to populate this data.
Duration Filters (Video/Audio)
--min-duration
Minimum duration (5m, 1h30m, 90s)
--max-duration
Maximum duration
Dimension Filters (Images/Video)
--min-width
Minimum width in pixels
--min-height
Minimum height in pixels
Camera/EXIF Filters
--camera-make
Filter by camera manufacturer
--taken-after
Photos taken after date (EXIF)
--has-geo
Filter by GPS location
Storage & Hash Filters
--storage-class
S3 storage class (GLACIER, etc.)
--encrypted
Filter by encryption status
--hash-match
Find files by hash value
Metadata Operators
The --meta option supports these operators:
=
Equals
!=
Not equals
>= <=
Comparisons
~=
Contains
^=
Starts with
$=
Ends with
in
Value in list
exists
Key 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 "Google Drive"
Save a query for reuse:
filefortress search --extensions jpg,png --save-query "my-photos"
Find Canon photos from 2024 with GPS:
filefortress search --camera-make Canon --taken-after 2024-01-01 --has-geo true
Find 4K videos between 5-30 minutes:
filefortress search --min-width 3840 --min-duration 5m --max-duration 30m
Quick Reference
Copy-pasteable commands for common scenarios:
filefortress search --min-duration 5m
filefortress search --min-width 3840 --min-height 2160
filefortress search --storage-class GLACIER
filefortress search --camera-make Canon --has-geo true