CLI

fffd uploads, syncs and shares from your terminal. Install it, sign in once, and every command below works from any script.

Runs on
macOS, Linux, Windows
Uploads
20 at a time
Updates
fffd update

Install#

curl -fsSL https://public.freakingfast.io/global/fffd/cli/install.sh | sh

Then sign in. It opens your browser once, and every command after that runs on its own.

fffd login

It's a single binary. It checks for a new version once a day, and fffd update installs it. Run fffd <command> --help to see a command's options.

Examples#

Upload a batch with tags
fffd upload -t client -t 2026 ~/exports/*.mov
Tagging with client, 2026
Uploading 14 files (20 at a time)
Uploaded 14 files
Sync a folder
fffd sync -r ~/shoots/portugal
412 files on the drive
Uploading 38 files (12 already there)
/lisbon/
/porto/
Synced 38 files across 2 folders
Pipe an archive up and back
tar cz site | fffd upload --name site.tar.gz -
Reading stdin → site.tar.gz
site.tar.gz (2.3 GB)
Uploaded site.tar.gz3f9c2a61-8d4e-4b7a-9c1f-2e6b8a0d5c47
fffd download site.tar.gz -o - | tar xz
451 files loaded
site.tar.gz (2.3 GB)
Piped 2.3 GB
Make a file you already have public
fffd access q3-review-cut.mp4
312 files loaded
q3-review-cut.mp4 → public
Trash two files and bring one back
fffd trash rough-cut-v1.mp4 rough-cut-v2.mp4
312 files loaded
Trashed 2 file(s).
fffd restore rough-cut-v2.mp4
2 trashed files loaded
Restored 1 file(s).

Downloads#

If you'd rather install by hand, download the binary for your platform and put it on your PATH.

Account#

fffd login
Sign in through your browser.
fffd logout
Clear stored authentication token.
fffd whoami
Show who you're signed in as.
fffd storage
Show storage usage breakdown.

Upload and download#

fffd upload
Upload one or more files, or pipe one in with -.
fffd sync
Upload the files in a folder that aren't on the drive yet.
fffd share
Upload a file publicly and print its link.
fffd download
Download a file by ID or filename.
fffd archive
Create a ZIP archive from files, a gallery, or a playlist.

Organize#

fffd ls
List your files, optionally inside a folder.
fffd mkdir
Create a folder, and any folder above it that does not exist yet.
fffd mv
Move files or a folder into another folder.
fffd access
Toggle a file between public and private.
fffd describe
Set or clear a file description.

Trash#

fffd trash
Move files to trash, or list trashed files with trash ls.
fffd restore
Restore files from trash.
fffd rm
Permanently delete files by ID or filename.

Audio and video#

fffd metadata
Re-extract metadata for an audio or video file.
fffd thumbnail
Set a video thumbnail at a specific timestamp.

Updates#

fffd update
Update fffd to the latest version.
fffd rollback
Roll back fffd to a previous version.