[[TOC()]]

= [wiki:help/en Cyberduck Help] / [wiki:help/en/howto Howto] / Browser =

== Navigation ==
=== List and Outline View ===
Select ''View → as List (⌘-1)'' or ''View → as Outline (⌘-2)'' for expandable folders. You can expand and disclose folders using the arrow keys and display the content of the selected/parent folder using ''Command Down/Up Arrow''.

=== Tabs ===
On macoS, enable tabs by default when choosing ''File → New Browser'' by selecting in System Preferences the checkbox ''Dock → Prefer tabs when opening documents: Always''. New browser windows and the transfer window will then be displayed in a single window frame with a tab bar. You can merge windows with ''View → Show Tab Bar and Window → Merge all Windows''.

=== Spring-loaded folders ===
Spring-loaded folders are a feature that allow you to move a file or even another folder, into a folder deeply nested within several other folders using drag and drop. To enable, choose ''Preferences → Browser → Use spring-loaded folders when dragging files'' and adjust the delay for the folder to expand when hovering over with the mouse. Note that spring-loaded folders are only supported in outline view.

=== Filter & Search ===
Use the search field (''⌘-/'') to to display only files that match the search string in the browser.  Search is case insensitive and does looks for matching sequences in the filename. To search recursively, hit the the return key (''⏎''). The following protocols have a server side index that is used to give fast results without recursively descending into folders.
 * [wiki:help/en/howto/googledrive Google Drive]
 * [wiki:help/en/howto/dropbox Dropbox]
 * [wiki:help/en/howto/s3 Amazon S3]
 * [wiki:help/en/howto/b2 Backblaze B2]
 * [wiki:help/en/howto/onedrive Microsoft OneDrive]
 * [wiki:help/en/howto/joyent Joyent Triton Object Storage]

=== Sorting ===

You can sort the file listing by clicking the table column header. Choose ''View → Column'' to add more headers such as ''Kind'' to allow sorting by file type including folders appearing first in the list.

=== Local disk file browser ===
Choose your computer name from the protocol selection popup button in the ''New Connection'' window.

Alternatively you can use drag and drop or Menu ''File → Upload''. You can also copy files in the Finder.app and then paste them in Cyberduck using Menu ''Edit → Paste (⌘-V)'' from Finder. 

See other [wiki:help/en/howto/upload upload] methods.

== Working with files and folders ==
=== Edit ===
You can edit any file on the server using your preferred application. See [wiki:help/en/howto/edit Edit Files].

=== Create new folder or file ===
Use ''File → New Folder... (⌘-N)'' or ''File → New File... (⌘-F)'' to create a new folder or file on the server.

=== Move or duplicate files and folders ===
You can move files in the browser as you would in the Finder.app using drag and drop. Use the ''⌥'' modifier key to duplicate files. If connected to the same server, you can also move files between different browser windows.

The following protocols allow duplicating files on the server without downloading and uploading but copying in place:
 * [wiki:help/en/howto/s3#Search S3]
 * [wiki:help/en/howto/dav#Search WebDAV]
 * [wiki:help/en/howto/azure#Search Azure]
 * [wiki:help/en/howto/dropbox#Search Dropbox]

To move a file, use ''Edit → Cut (⌘-X)'' followed by ''Edit → Paste (⌘-V)''. To duplicate a file, use ''Edit → Copy (⌘-C)'' followed by ''Edit → Paste (⌘-V)''.

=== Copy files and folders to different server ===
You can copy files between arbitary servers when connected to with two open browser windows. Drag files from one browser to the other to transfer files between servers.

[[Image(Copy.png)]]

=== Rename a file or folder ===
Select the file in the browser and press the return or ''Enter key''. Type the new name and press return again to exit the editing mode. You can also rename files by choosing ''File → Info (⌘-I)'' or press the Get [wiki:help/en/howto/info Info] toolbar button. Simply enter the new name in the very top field. The field must loose focus (e.g. by hitting Enter or Tab) to commit the filename change.

[[Image(Inline Rename.png)]]

=== Create a symbolic link ===
Choose ''File → New Symbolic Link...'' to create a symbolic link. This is supported on UNIX systems with a [wiki:help/en/howto/sftp SFTP] connection and some [wiki:help/en/howto/ftp FTP] with `SITE SYMLINK` extension.

=== Info Window ===
Select the file in the browser and choose ''File → Info (⌘-I)'' to display [wiki:help/en/howto/info detailed attributes] of a file in a tool window. It allows to change permissions, manage content distributions for cloud services and settings specific to the Amazon [wiki:help/en/howto/s3 S3] service.

=== QuickLook ===
You can toggle Quick Look in a Cyberduck browser for any file using ''Space Bar''. A preview is rendered depending on a Quick Look Plugin available on your system for the given file type. Many file types like different image formats can be previewed with the bundled plugins in OS X and HTML is even rendered in the Quick Look preview panel.

[[Image(quicklook.png)]]

=== Open or Copy HTTP URL ===
See bookmark [wiki:help/en/howto/bookmarks#HTTPURL Web URL configuration] for HTTP URLs. You can select multiple files to open/copy all URLs.
 * Open Web URL. The ''Web URL'' can be found in the ''File → Open URL'' menu and as an optional toolbar item in the browser window. Use ''View → Customize Toolbar...'' to add the ''Open in Browser'' button to your default browser toolbar.
 * Copy Web URL. The ''Web URL'' can be found in the ''Edit → Copy URL'' menu.

=== Share Files ===
Refer to [wiki:help/en/howto/share Share].

=== Open in Terminal ===
Refer to [http://trac.cyberduck.ch/wiki/help/en/howto/sftp#OpeninTerminal Open in Terminal].

=== Print browser folder listing ===
Use the ''File → Print'' option where you can open a PDF from the browser listing or print it.


=== Folder icon badges ===
Folder icons are badged for particular access permissions.

 * Folder with no permission to access.
[[Image(privatefolderbadge.png)]]
 * Folder with read only permissions. Uploading or editing files to this folder is not possible.
[[Image(readonlyfolderbadge.png)]]
 * Drop Folder where you can only upload files to but are not allowed to view its content.
[[Image(dropfolderbadge.png)]]

=== Versions ===
You can view all revisions of a file in the browser by choosing ''View → Show Hidden Files''. The following protocols support versioning
 * [wiki:help/en/howto/s3 S3]
 * [wiki:help/en/howto/b2 Backblaze B2]
 * [wiki:help/en/howto/googledrive Google Drive]

==== Revert ===
To revert to a previous version and make it the current, choose ''File → Revert''.

== Activity ==

Use ''Window → Activity (⌘-0)'' to to toggle the activity window. It lists the currently running background tasks at the top and all queued activities subsequently.

[[Image(Activity.png)]]

== Problems ==
=== Special characters such as Umlaute ===
If characters aren't displayed correctly in the browser, try to change the character encoding used. See ''View → Text Encoding'' or edit the [https://trac.cyberduck.io/wiki/help/en/howto/bookmarks#EditBookmark bookmark] ''Encoding' 'setting. Try {{{UTF-8}}} (the default), {{{ISO-8859-1}}} and {{{Windows-1252}}}.

=== The folder size isn't displayed correctly ===
This is not the size of its content but the size of the folder itself. Use ''File → Info (⌘-I)'' to [wiki:help/en/howto/info#Calculatefoldersize calculate the size] recursively of all contained files.

== Preferences ==

=== General → Browser → Save Workspace ===
Restore browser sessions that were left open when the application was last quit.

=== General → Browser → Open new browser window on startup ===
Open new browser window after application launch.

=== Browser → General → Show Hidden Files ===
Display files in the browser that start with `.` and [wiki:help/en/howto/s3#Versions  previous revisions (S3)]. Use ''View → Show Hidden Files'' to toggle the mode of a current browser window.

=== Browser → General → Info window always shows current selection ===
use only one ''Info'' window which updates with the selection change in the browser. If unchecked, open multiple Info windows to compare files.

== Hidden Preferences ==

=== Adjust the browser font size ===

A [wiki:help/en/howto/preferences#Hiddenconfigurationoptions hidden configuration option].
{{{
defaults write ch.sudo.cyberduck browser.font.size 18
}}}

=== Duplicate filename format ===

A [wiki:help/en/howto/preferences#Hiddenconfigurationoptions hidden configuration option]. Define a different format using
{{{
defaults write ch.sudo.cyberduck browser.duplicate.format "{0} ({1}){2}"
}}}

where the placeholders will be replaced with
 * `{0}` with the base filename
 * `{1}` with the timestamp of the file
 * `{2}` with the extension in the format `.extension` if present in the original filename.

=== Warning before renaming or moving files ===

A [wiki:help/en/howto/preferences#Hiddenconfigurationoptions hidden configuration option].  A confirmation is shown before renaming or moving files.

{{{
defaults write ch.sudo.cyberduck browser.move.confirm true
}}}