Cyberduck Mountain Duck CLI

Version 54 (modified by dkocher, on Mar 28, 2011 at 6:36:49 PM) (diff)


Cyberduck Help / Howto / Bookmarks

Toggle Bookmarks

You can toggle between the bookmarks and the browser using Bookmarks → Toggle Bookmarks (Command-B) or by clicking the bookmarks icon in the navigation toolbar. Depending on the bookmark icon size choosen in Cyberduck → Preferences → Browser → Bookmarks, the nickname, URL, username and comment is shown per bookmark.


You can manually sort bookmarks by dragging a row to a different location.


Use the search field (Command-/) to filer bookmarks by nickname and hostname. Only bookmarks that match the search string are displayed in the bookmark list. Search is case insensitive.


See ticket #285.

Add new Bookmark

From current connection

  • Select Bookmarks → Toggle Bookmarks. Click the plus button to add the host connected to in this browser window to the Bookmarks. An editor window will open where you can further adjust the bookmark properties (i.e. nickname).

Add Bookmark

  • Drag the proxy icon in the browser window title bar to the bookmark drawer or to the You can double click this file in the to open a new connection.

From a third-party application

Drag an URL form a third-party application to the bookmark table to create a new bookmark. This can be a link embedded in a web page or from any text source.

Edit Bookmark

Select Bookmark → Edit Bookmark. A panel where you can edit the bookmark's properties will appear. If the hostname configured is not reachable, an alert icon is displayed next to the URL. Clicking it opens Network Diagnostics.

Setting Description
ProtocolYour hosting service provider will let you know what protocol to use. Change the protocol in the top most popup menu.
NicknameAny name for the bookmark describing it for easy access using the bookmark filter. You can also type this name in the bookmark view to select it by name.
ServerThe hostname of the server. This is not editable if you have choosen a protocol with a predefined, non-configurable hostname.
UsernameThe login credentials from your service provider.
Public Key AuthenticationFor SFTP connections only. Choose a private key for authentication instead of a password. If the key is password-protected, you are prompted to enter the passphrase to decrypt the key.
PathThe initial working directory when connecting to the server. This must be the document root of the webserver if you want to configure HTTP URLs (see below) to work.
Download FolderDefault location for files downloaded from this server.
Transfer FilesChoose to open a new connection for transfers or to use the existing browser connection. When using the browser connection, transfers block other operations.
Connect ModeFor FTP connections only. Refer to FTP Connect Mode.
EncodingFor FTP connections only. Character encoding of filenames on the server. You can also change the encoding used when the connection is open using View → Text Encoding if characters are not displayed properly. Try UTF-8 (the default), ISO-8859-1 and Windows-1252. Refer to Character Encoding.
TimezoneFor all protocols except FTP, timestamps are reported in UTC from the server and there is no need for configuration. All timestamps in the browser are automatically converted to the timezone you have configured in the System Preferences and displayed in local time. For FTP however , the local timezone is assumed for timestamps in directory listings. If the server is configured with a different timezone than your Mac and returning the local time for modification dates, there will be an offset by the timezone difference. To get the correct local time for modification dates in the browser, you can choose the timezone of the server in the bookmark setting. Select Bookmark → Edit Bookmark.


With a valid configuration, you can open the corresponding HTTP URL of a file selected with your default web browser or copy the URL to the cipboard. You can select multiple files in the browser for a list of URLs.

Enter the HTTP URL of the webserver using a different hostname than what you connect to using FTP. You also have to specify a reasonable default path in your bookmark (e.g. /home/dkocher/public_html/). That must be the directory accessed by the web server as your document root. Using an Apache webserver, this is equivalent to the DocumentRoot directive.

Example configuration:

Serversudo.chHostname configured in bookmark to connect to
Bookmark Path/usr/home/dkocher/public_html/The Web Server Document Root
Selected File/home/dkocher/public_html/stylesheet.cssA file selected in the browser
HTTP URL in the web browser

See also Open or copy HTTP URL.

Exporting Bookmarks

Drag the bookmark from the Bookmark Drawer anywhere to the (e.g. the Desktop). You can double click the document in the to open a new connection to the server specified in the bookmark. To backup all bookmarks, refer to this FAQ entry.

Note: You can share bookmarks between Mac & Windows as the file format is the same on both platforms.

Importing Bookmarks

Just drag the bookmark file from the to the list of bookmarks.

From third-party applications

You are asked if you want import bookmarks from the following list of applications if the application is still installed on your system and bookmarks configured with that application are found.

  • Transmit 4 (as of 3.7)
  • Filezilla
  • Fetch
  • Flow
  • Interarchy
  • FileZilla
  • SmartFTP
  • FlashFXP
  • WS_FTP
  • FlashFXP 3/4
  • CrossFTP
  • FireFTP
  • CloudBerry Explorer for Amazon S3
  • CloudBerry Explorer for Google Storage
  • CloudBerry Explorer for Azure Blob

Sharing bookmarks between different computers

You can sign up for Dropbox to share bookmarks between different computers and users.

  • Install Dropbox
  • Quit Cyberduck
  • Move the folder ~/Library/Application Support/Cyberduck to your Dropbox folder location (typically in ~/Dropbox)
  • Open a window and enter
defaults write ch.sudo.cyberduck ~/Dropbox/Cyberduck
  • Restart Cyberduck.


Don't save bookmarks

A hidden configuration option.

defaults write ch.sudo.cyberduck false

Do not read favicon.ico from HTTP URL

A hidden configuration option. Displayed in the bookmark edit window.

defaults write ch.sudo.cyberduck false

Open bookmark view after disconnecting

A hidden configuration option.

defaults write ch.sudo.cyberduck browser.disconnect.showBookmarks true

Attachments (9)

Download all attachments as: .zip