Manage Cloud Storage
Manage connections to cloud storage providers like Google Drive, OneDrive, Amazon S3, Backblaze B2, and Local storage.
Connecting Google Drive & OneDrive
OneDrive — run remotes add onedrive and sign in. Nothing to register, no credentials to copy. It asks for read and write access so that duplicate removal works; if you would rather grant read-only, use remotes add oauth with your own app and pick your own scopes.
Google Drive — use remotes add oauth with your own Client ID and Secret. Google requires an annually-renewed third-party security audit before any app may read a whole Drive, so registering your own app is what keeps full access available to you — and it means the permissions are yours to choose.
Either way, sign-in happens between your browser and the provider: FileFortress never handles your tokens.
Connect Google Drive, OneDrive, or any OAuth-based provider using an OAuth app you registered yourself. This is the recommended way to connect Google Drive, and the way to connect OneDrive if you want to choose the permissions yourself rather than accept the defaults.
Google Drive needs a Client ID and a Client Secret. From v0.32, OneDrive needs only the Client ID — a Microsoft desktop app is a public client and has no secret to create. See the OAuth credentials guide for the exact steps, including the publishing step that keeps a Google connection from expiring after a week.
Why use your own credentials?
filefortress remotes add oauthfilefortress remotes add oauth --name "My Drive" --provider gdrive --client-id YOUR_ID --client-secret YOUR_SECRET--name
Friendly name for this remote
--provider
e.g. gdrive, onedrive
--client-id
Your OAuth Client ID
--client-secret
Your OAuth Client Secret (Google Drive only)
--encryption-type - RCloneStandard, RCloneObfuscate, Aes256Cbc, None--encryption-password - Password for encryption--encryption-salt - Optional salt for key derivationAbout gdrive
remotes add gdrive uses a shared FileFortress connection and will be retired in a future release. Use remotes add oauth for Google Drive instead — you control the credentials and the permissions, and FileFortress never touches your tokens. remotes add onedrive is not deprecated; it is the recommended way to connect OneDrive.
Add a new cloud storage provider with provider-specific subcommands.
filefortress remotes add onedrive [--name "name"]filefortress remotes add gdrive [--name "name"]filefortress remotes add s3 --access-key KEY --secret-key SECRETfilefortress remotes add backblaze --key-id ID --application-key KEYfilefortress remotes add local --path PATH--encryption-type - RCloneStandard, RCloneObfuscate, Aes256Cbc, None--encryption-password - Password for encryption--encryption-salt - Optional salt for key derivationDisplay all connected cloud storage accounts.
filefortress remotes list
Shows name, type, creation date, and last update time for each remote.
Display comprehensive storage information including usage statistics.
filefortress remotes info <remote_name_or_id> [--refresh]
Shows account details, storage statistics, scan status, and cached vs live data.
Give a remote a new display name. Only the local name changes — files on the storage provider are not affected.
filefortress remotes info <remote_name_or_id> --rename <new_name>
The new name must be unique. Also available in the desktop GUI from each remote's card and detail page.
Remove a connected cloud storage account.
filefortress remotes remove <remote_name_or_id>
Requires confirmation unless cancelled.
Scan connected storage for files and update the index.
filefortress remotes scan <remote_name_or_id>
Fetches file information from the specified remote storage.
filefortress remotes scan --all
Scans all connected remotes sequentially and displays aggregate statistics.
Enhance file metadata with additional information from cloud providers.
filefortress remotes enrich [options]
--from-query, -q
Use a saved query
--remote, -r
Specific remote
--media-type
Filter by media type
filefortress remotes add oauth
Follow the interactive prompts. You'll provide your own Client ID and Secret — FileFortress never sees your tokens.
filefortress remotes add oauth --provider onedrive --name "My OneDrive"
Connects OneDrive using your own Azure app credentials. You choose the permission scopes.
filefortress remotes add s3 --non-interactive --access-key AKIA... --secret-key secret... --bucket my-bucket
filefortress remotes add oauth --provider gdrive --name "Encrypted Drive" --encryption-type RCloneStandard --encryption-password "mypassword"
Uses your own OAuth credentials plus rclone-compatible encryption on top.
filefortress remotes list
filefortress remotes enrich --media-type images --extensions jpg,png
Enriches only image files with EXIF data and dimensions.