Cloud files: badges, status and downloads

See which files and folders of iCloud Drive, Dropbox, Google Drive or OneDrive are on your Mac, uploading or online only, and download or free them.

Website and App Store versions

On this page

iCloud Drive and the clouds that use macOS's file provider (Dropbox, Google Drive for desktop, OneDrive, Box, Proton Drive…) keep their files in folders of your Mac: iCloud Drive, and the folders of ~/Library/CloudStorage listed under Clouds in the left sidebar. Folia Files works in them like anywhere else, and shows what macOS knows about each item: whether it's on your Mac, on its way up or down, or only in the cloud. A cloud's folder opened through a link of your home folder, such as ~/Dropbox, shows the same.

For Google Drive, Dropbox, OneDrive, Box and Proton Drive, this comes with the service's own Mac app: an rclone connection mounts the account as a disk, without sync states or downloads on demand. That's why Folia Files suggests the app first: see Clouds with their own Mac app.

Online only or on this Mac

A file can be on this Mac, or online only: its name is there, its contents stay in the cloud until you open it. A folder can be on your Mac entirely, partly, or not at all.

Badges after the names

In the List, Detailed List and Tree views, and on the cards of Branches, a small badge after a name tells its state:

  • a grey cloud: online only, not on this Mac (it downloads when you open it). On a folder (website edition), a grey cloud means some or all of its files are online only; its tooltip says which. A folder entirely on your Mac has no badge;
  • an arrow up: uploading (in color), or waiting to upload (in grey);
  • an arrow down: downloading. Its tooltip says how far it got and about how long is left;
  • an orange badge: a conflict (several versions of this item exist in the cloud);
  • a red badge: the sync failed. Its tooltip gives the cloud's own message.

When the cloud says it will retry by itself (no network, servers not answering), the file stays « Waiting to Upload » in grey, and the tooltip adds « It will try again by itself. » The red badge is kept for errors that need you.

The badges are on at first. To hide them: Settings › Files and Network › Cloud › Show the state of cloud files after their names (online only, uploading, downloading, conflict).

The Desktop and Documents folders count too when iCloud keeps them: their online-only files have the grey cloud and a value in the Cloud Status column.

The Cloud Status column

In the Detailed List and Tree views, right-click the column titles and choose Cloud Status (it's in the group of Folia's own columns). For each item:

ValueMeaning
On This Macthe file is downloaded and up to date; for a folder (website edition), everything in it is on your Mac
Online Onlynot on this Mac; downloaded when opened. For a folder, none of its files is on your Mac
Partly Onlinea folder some of whose files are online only (website edition)
Downloading…, Sending…, Waiting to Uploadon its way
Conflict, Errorsomething to look at; the tooltip says what

In the App Store version, a folder's cell stays empty unless the folder itself is online only. On a server, the column stays empty; elsewhere on your Mac, only an online-only item has a value. With the badges turned off, the column says only Online Only or On This Mac.

Click the column's title to sort by it, again to reverse: online-only items first, then partly online folders, then those on their way, then conflicts and errors, then those on your Mac. Items with no state (on a server, outside the clouds, or a folder not read yet) always come last.

Download Now and Remove Download

Right-click files or folders of iCloud Drive or of a cloud's folder:

  • Download Now brings online-only items onto your Mac, so they're available offline;
  • Remove Download frees the space they take on your Mac. Nothing is deleted from the cloud: the item stays listed, online only, and downloads again when opened.

Only the one that applies is offered: Download Now for an online-only file or a folder not entirely on your Mac, Remove Download for a file on your Mac or a folder that holds one. A folder partly on your Mac, or whose state isn't known yet, offers both. Both are always in File › More Actions.

They run one item after another, as an operation shown in Operations, with its progress (a percentage when the cloud gives one) and a Cancel button. At the end, an alert lists what failed, with the cloud's message, or confirms the space freed. In the website edition, a folder is downloaded or freed with everything inside it, as in the Finder, and shows « Downloading… » meanwhile.

Opening a file that isn't here yet

Double-click an online-only file (or one still downloading): Folia Files asks the cloud for it and shows a bubble such as « Downloading “Report.pdf” (42 %, about 1 min left) », « This file isn't on this Mac yet: it will open as soon as it's downloaded. » It opens by itself once it's there; if the download fails, an alert says so. An archive is opened in the pane as a folder the same way.

Copying into a cloud folder

When you copy files into a cloud folder, each file is written beside it first and put in place only when complete. The cloud never uploads a half-written or empty file, and never ends up with empty « … 2 » duplicates next to the real ones. See Copying into cloud folders.

Your cloud's own commands

Clouds add commands to the Finder's context menu: Box's Refresh Folder, Google Drive's Refresh folder, sharing links… In the website edition, Folia Files offers them too:

  1. Right-click items in the cloud's folder (or its background).
  2. Open the submenu named after your cloud, shown with its logo.
  3. Choose the command.

Only the commands that apply to all the selected items are listed, in the cloud's order and language. The cloud does the work; if it fails, an alert gives its message. A command that opens a window of the cloud's own is shown as "name (in the Finder)": it reveals the items in the Finder, where you run it. iCloud Drive has no such commands. More in Your cloud's own commands.