Operations (NOT)

An operation is one rclone command with a window of its own: Copy, Move, Sync, Bisync, Mount, Serve, Delete, Purge and Download. The windows share one layout. This page explains it once; the page of each operation only covers what is different about it.

Opening an operation

Open the toolbar with Cmd+Shift+/ on macOS or Ctrl+Shift+/ on Windows and Linux, and type the operation's name. The first result opens its window.

The toolbar also reads paths. Type the operation followed by a source and a destination, and the result opens the window with both fields already filled in. Type or paste a URL and the toolbar offers a Download for it.

An open window switches to another operation through the command icon in its bottom bar.

Paths

The top of the window is the source and the destination. A path is either a remote, a colon and a folder inside it, or a local folder. Type it, or tap the field to open the folder picker, which lists your remotes and local disks and lets you go down to the folder you want. The button between the two fields swaps them, which is the quickest way to turn a copy to a remote into a copy from it.

Copy and Move accept several sources for one destination; every other operation takes exactly one. Delete and Purge have a single field, since they only need to know where to act.

Options

Below the paths, each window has a set of collapsible sections. Every flag you could pass to rclone on the command line is an option in one of them:

A section's header shows how many of its options are set, so you can see what is active without opening it.

Inside a section, the right half is a grid of chips, one per option. Clicking a chip turns the option on with its default value; clicking it again turns it off. Hovering a chip shows rclone's own description of the option, the same text as in rclone's documentation. Every option you turn on also appears in the left half, the "Custom Options" box, as text you can edit; that is where you change a value such as a size, a duration or a pattern. Hovering a line in the box shows the presets rclone knows for that option, with the default marked. The padlock locks the box so that switching paths does not change it.

The windows start with sensible values already set: eight parallel transfers, sixteen parallel checks, multi-threaded downloads for large files. You only need to open the sections when you want something different.

The bottom bar

From left to right:

• The folder icon holds your templates for this operation. Its first entry, "SAVE AS TEMPLATE", stores the options you have set under a name, so you can apply them to a later operation with one click.
• The large button starts the operation. Until everything is in place it shows what is missing instead: a source or destination that is not selected, a source and destination that are the same, or invalid text in a "Custom Options" box. Once a schedule is set in the Cron section, it reads "START AND SCHEDULE …", which means the operation runs once now and then on the schedule.
• The eye icon, "Preview (Dry Run)", runs the operation without changing anything. The job appears in Transfers marked "DRY RUN" and shows what the operation would do, which is the safest way to check a sync or a delete before the real run. Copy, Move, Sync and Delete support it.
• The clock icon, "Schedule task", creates a schedule without running the operation now. It asks for a name for the schedule.
• The info icon opens rclone's documentation for the command in a drawer.
• The command icon switches to another operation.

After a successful start, the large button becomes a "NEW …" menu that resets the paths, the options, or both for the next run, and a "VIEW TRANSFERS" button appears next to it.

Watching a job

Every started operation is a job in Transfers, which opens from the toolbar, the tray menu, or the "VIEW TRANSFERS" button. Jobs are split into an "ACTIVE" and an "INACTIVE" tab. A job row shows its number, its source and a progress bar. While rclone is still comparing the two sides, the row shows a "Checking" chip with the number of files being compared; on large folders this phase takes a while, and it is normal.

Tapping a row opens the details: the files being checked, the files transferring with their speed, and the files already done, each with the time it finished. A file that failed shows its error and a "Retry this file" button, which starts a new job for that file alone. An active job has a stop button. Finished jobs stay under "INACTIVE" with their file list, so yesterday's transfer is still there to look at.

The operations

Not every operation can be previewed or scheduled: