Reference

The pages of the app, every setting, the clouddrop command and where CloudDrop keeps its files.

Pages of the app

Page	What it shows
Home	Status, progress, cloud storage used, space freed, recent activity, and the buttons Open Folder, Add Files…, Free Up Space… and Pause Uploads
Files	Everything in CloudDrop, cloud-only included, with search and filters
Activity	What was uploaded, moved, freed, downloaded back or failed
Settings	Appearance, space saving, account, folders, uploading, background

Files filters

All files, On this computer, Cloud-only, Uploading, Failed.

File statuses

Status	Meaning
Waiting	Queued for upload
Uploading	Going up now
Uploaded	In the cloud and on this computer
Cloud-only	In the cloud only
Failed	The upload failed. Select Retry, or Retry All

Settings

Names are from the Linux app.

Setting	What it does	Default
Style	Follow System, Light or Dark	Follow System
Accent color	The colour of buttons and highlights	System Default
Free up space automatically	Never, Right after uploading, or after a number of days	Never
Always keep on this computer	Folders never freed automatically	None
Files at a time	How many files upload in parallel	2
Wait after a change (seconds)	Time to let a program finish writing before uploading	2
Notifications	Tells you when uploads finish or something needs attention	On
Ignored files	Comma-separated patterns that are not uploaded	See below
Show icon in the top bar	The status icon, with pause and resume
Upload service	Shows Running or Not running; Restart restarts it
Files integration	Restart Files reloads status icons in the file manager

Command line

The clouddrop command does everything the app does.

bash

clouddrop status                      # what is uploaded, waiting, cloud-only or failing
clouddrop status --all                # every folder
clouddrop free ~/CloudDrop/Videos     # free up space, after the cloud check
clouddrop ls-cloud ~/CloudDrop/Videos # list cloud-only items in a folder
clouddrop restore ~/CloudDrop/Videos/holiday.mp4   # download back
clouddrop auto-free 30                # never | now | number of days
clouddrop keep ~/CloudDrop/Work       # never free automatically; unkeep to undo
clouddrop pause                       # resume to continue
clouddrop retry                       # try failed uploads again
clouddrop open ~/CloudDrop/report.pdf # open the item in the cloud's web page
clouddrop providers                   # clouds this build offers
clouddrop login                       # sign in again
clouddrop logout                      # stop the service and forget the sign-in
clouddrop check                       # connect with the saved settings and report
clouddrop connections                 # folders and their clouds; add / remove
clouddrop config get                  # show settings
clouddrop config set KEY VALUE        # change a setting
clouddrop service status              # also: start, stop, enable, disable

Every command accepts --connection NAME to pick a folder.

Set up from a terminal

bash

clouddrop setup --provider dropbox    # an id from `clouddrop providers`
clouddrop service enable              # start at sign-in

Config file

Everything is in Settings, but you can edit the file by hand.

toml

sync_dir = "/home/you/CloudDrop"
drive_folder = "CloudDrop"     # top folder in the cloud
parallel_uploads = 2
settle_secs = 2                # wait after the last change before uploading
notifications = true
auto_free_days = 30            # absent = never, 0 = right after upload
keep_local = ["Work"]          # folders never freed automatically
theme = "dark"                 # absent = follow the system; or "light"
accent = "teal"                # absent = the system's; blue, teal, green, purple, pink, orange
ignore = [".goutputstream-*", "*.part", "*.crdownload", "*.tmp", "~$*", ".~lock.*#", "*.swp", "*~", ".Trash-*"]

After editing by hand, run clouddrop service stop and then clouddrop service start.

File locations

What	Linux	Linux snap	Windows
Config	`~/.config/clouddrop/config.toml`	`~/snap/clouddrop/common/config.toml`	`%APPDATA%\clouddrop\config.toml`
State and sign-in files	`~/.local/share/clouddrop/`	`~/snap/clouddrop/common/data/`	`%LOCALAPPDATA%\clouddrop\`
Uploaded folder	`~/CloudDrop`	`~/CloudDrop`	`%USERPROFILE%\CloudDrop`

Each additional folder has a config of its own in connections/NAME/config.toml beside the main one. Passwords and keys are in credentials.json in the state folder, readable only by you.

Reference ​

Pages of the app ​

Files filters ​

File statuses ​

Settings ​

Command line ​

Set up from a terminal ​

Config file ​

File locations ​

Next steps ​