File Transfers

The Transfers window lists pending and completed transfers. The list is retained when the application is closed and can be retrieved after restarting so that the transfer can be restarted at a later time.

Resume will try to finish a transfer previously interrupted.

Note

Some servers may not support resumable transfers and the file will be reloaded instead.

Interrupt

You can interrupt a transfer using the Stop toolbar button.

Use the Open toolbar button to open a downloaded file or folder.

macOS only

A warning might be displayed before opening the file. See the download quarantine.

Using the Show in Finder or Show toolbar button, files are shown in Finder.app or Explorer.

Progress

Windows only

If the Transfers window is closed, progress is also visible in the application icon in the Taskbar.

Bandwidth

Limit the maximum bandwidth that is allowed for transfers. Useful when you don’t want transfers to take all the bandwidth available on your internet connection that would slow down other connections.

Select Bandwidth from the toolbar in the transfer window and set the maximum bandwidth allowed by the selected transfer from the drop-down window. The default setting is configurable in the Preferences.

Connections

You can choose to use single or multiple connections for file transfers. Choose Preferences → Transfers → Transfer Files to set the default or for a bookmark in Bookmark → Edit Bookmark → Transfer Files.

Open single connection: Use a single connection to transfer files from a transfer sequentially.
Open multiple connections: Use multiple connections to transfer files from a transfer concurrently.

Limit Number of Parallel Connections

The maximum number of connections for transfers using multiple connections can be limited using the toggle in the lower right of the transfer window on Windows or the toolbar dropdown on macOS. The same toggle limits the maximum allowed concurrent transfers in the transfer window to the same number.

Overwrite Prompt

A prompt is displayed if files already exist at the target location (on your local hard disk for downloads or on the server for uploads) and you have selected Prompt in Transfers → General → Downloads/Uploads → Existing Files. The prompt allows choosing the action for existing files. You can exclude selected files and folders from the transfer action by unchecking the checkbox next to it. If the checkbox is not selected, these files will be skipped.

Exclamation mark triangle: File size is zero or differs from the existing file.

Overwrite

Replace any existing file restarting the transfer from scratch. Existing files are moved to the trash.

Compare

Skip existing files that match a checksum if available. If a checksum is not available or differs the modification date is compared to determine if a file should be replaced.

Resume

Append to existing files and skip files that match the file size and checksum if available. The following protocols support resume for uploads:

Rename

Rename transferred file appending a timestamp to the filename.

Rename Existing

Rename existing file at the destination appending a timestamp to the filename.

Preferences

Transfers → General → Browser connection for file transfers

If your server only allows one single connection to be opened for a given user, you’ll have to transfer files using the browser connection. This will cause you to stop browsing files and folders while the transfer is in progress. You can choose to Use the browser connection or to a Open a new connection for file transfers in the bookmark setting. The default setting is configurable in the Transfers tab of Preferences.

• Prompt: Asks what action to take for each transfer.

• Overwrite: Overwrite existing files at the destination.

• Resume: Skip existing files with the same file size and append if file size differs.

• Rename: Rename transferred file appending a timestamp to the filename.

• Rename existing: Rename existing file at the destination appending a timestamp to the filename.

• Skip: Skip all existing files.

Transfers → Filter

Files and folders matching the regular expression in Preferences → Preferences → Advanced will be excluded. Standard PERL regular expressions are used, see Google for more help. The most important qualifiers are:

. Any character
\d A digit: [0-9]
\D A non-digit: [^0-9]
\s A whitespace character: [ \t\n\x0B\f\r]
\S A non-whitespace character: [^\s]
\w A word character: [a-zA-Z_0-9]
\W A non-word character: [^\w]
XY X followed by Y
X|Y Either X or Y
X? X, once or not at all
X* X, zero or more times
X+ X, one or more times

The default pattern excludes metadata files from common revision control software.

.*~\..*|\.DS_Store|\.svn|CVS

Transfers → General → Transfer Files

Files can be transferred using either the connection from the browser or by opening a new dedicated transfer connection. Using the setting Open new connection will add files to be transferred to the Transfer Window and open a new connection to the server to initiate the transfer. The option Use browser connection will transfer files using the connection from the browser. The file transfer is only reported at the bottom of the browser window without any detailed progress indicator. The transferred files will not get added to the Transfer Window. This setting is a also available per bookmark.

Choose between a default permission mask to apply to downloaded files or to apply the same mask the file has on the server. If unchecked, downloaded files have the default mask for new files created on the local filesystem.

Adjust the permission mask of uploaded files or leave it to the default mask chosen by the server. The setting for permissions apply when connected to a UNIX host using FTP or SFTP. When connected to S3 and Azure this will update the access control list (ACL).

Note

Enabling change of permissions slows down the transfer rate when uploading many files with FTP.

Transfers → Timestamps

Note

Enabling change of modification date slows down the transfer rate when uploading many files with FTP.

Hidden Preferences

Bandwidth Throttle Options

A hidden configuration option. Edit the available options (in bytes).

defaults write ch.sudo.cyberduck queue.bandwith.options 102400,1073741824

defaults write ch.sudo.cyberduck queue.dock.badge true
A hidden configuration option. Use queue.upload.priority.regex and queue.download.priority.regex to determine order. For example:
defaults write ch.sudo.cyberduck queue.upload.priority.regex ".*\.html"