Documentation
/
Commands
/
ls

ls - List Files and Folders
Browse your cloud storage like a local filesystem

List files and folders in your connected storage, similar to the 'ls' command in Unix-like systems. Supports flexible formatting, sorting, and filtering. Also includes an interactive explorer mode.

Interactive Explorer Mode

Run filefortress ls to launch a terminal-based file explorer. This mode allows you to navigate your remotes, preview file details, and change view options on the fly. Use --non-interactive for script-friendly output.

Syntax

filefortress ls [path] [options]

Arguments

Argument Description
path Optional path to list. Can be a local-style path or a remote path in the format remote-name:/path/to/folder. If omitted, lists root of all remotes.

Options

Display & Sorting Options

Option Description Example
--long Long listing format (includes size, modified time, extension, remote). --long
--one One entry per line (names only). --one
--sort Sort by: name, size, time, ext, remote. --sort size
--reverse Reverse the sort order. --reverse

Filtering & Traversal Options

Option Description Example
-R, --recursive List files in subdirectories recursively. --recursive
--max-depth Maximum directory depth for recursion. --max-depth 2
--min-depth Minimum directory depth. --min-depth 1
--files-only Show only files. --files-only
--folders-only Show only folders. --folders-only
--remote-name Filter by a specific remote storage name or id. --remote-name "Google Drive"
--extensions Filter by file extensions. --extensions pdf,docx
--size-min Minimum file size. --size-min 1MB
--size-max Maximum file size. --size-max 100MB
--modified-after Filter files modified after a date or relative time. --modified-after "7 days"
--media-type Filter by media type (e.g., image, video, audio, document). --media-type image
--exclude Patterns to exclude from the listing. --exclude "*.tmp,cache/*"
--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

Output & View Options

Option Description Example
--view Output format. Can be list (default), summary, tree, or json. --view json
--save-to-file Save results to a file. --save-to-file listing.txt
--page Page number for paginated results (1-based). --page 2
--page-size Number of items per page. --page-size 50

Examples

List root of all remotes:
filefortress ls
List contents of a specific remote and path:
filefortress ls "My GDrive:/Documents/Reports"
Recursive listing with long format:
filefortress ls --recursive --long
List only PDF files, sorted by size (largest first):
filefortress ls --files-only --extensions pdf --sort size --reverse
List images modified in the last week and save to JSON file:
filefortress ls --media-type image --modified-after "7 days" --view json --save-to-file images.json
Start the interactive file explorer:
filefortress ls
Launches the interactive file explorer.
Script-friendly listing:
filefortress ls --non-interactive --view json
Non-interactive mode with structured output for scripting.

Related Commands

search
Quick term-based file search
View Command
find query
Advanced file search
View Command
remotes
Manage cloud storage connections
View Command