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.

Sorting

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

Filter

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.

Groups

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).

• Drag the proxy icon in the browser window title bar to the bookmark drawer or to the Finder.app. You can double click this file in the Fnder.app 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.

Bookmark Options

Setting	Description
Protocol	Your hosting service provider will let you know what protocol to use. Change the protocol in the top most popup menu.
Nickname	Any 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.
Server	The hostname of the server. This is not editable if you have choosen a protocol with a predefined, non-configurable hostname.
Username	The login credentials from your service provider.
SSH Private Key	For SFTP connections only. Choose a private key for public key authentication instead of a password. If the key is password-protected, you are prompted to enter the passphrase to decrypt the key.
Client Certificate	For HTTPS connections only. Choose a client certificate for mutual transport level security (TLS).
Path	The 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 Folder	Default location for files downloaded from this server.
Transfer Files	Choose to open a new connection for transfers in the ​Transfers window or to use the existing browser connection. When using the browser connection, transfers block other operations.
Connect Mode	For FTP connections only. Refer to FTP Connect Mode.
Encoding	For 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.
Timezone	For 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.

HTTP URL

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:

Server	sudo.ch	Hostname 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.css	A file selected in the browser
HTTP URL	​http://sudo.ch/stylesheet.css	Accessible in the web browser

See also Open or copy HTTP URL.

Exporting Bookmarks

Drag the bookmark from the Bookmark Drawer anywhere to the Finder.app (e.g. the Desktop). You can double click the document in the Finder.app 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

From exported bookmark file

Just drag the .duck bookmark file from the Finder.app 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. There is no manual import function.

• Transmit 3-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
• WinSCP (as of 4.1.1 for ​INI file to store configuration)
• Expandrive 3-5 (as of 4.8)
• Total Commander

Preferences

Open default bookmark

Choose a default bookmark to open after opening the application. Choose Preferences → General → Open new browser window on startup → Connect to bookmark….

Do not read favicon.ico from HTTP URL

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

defaults write ch.sudo.cyberduck bookmark.favicon.download false

Open bookmark view after disconnecting

A hidden configuration option.

defaults write ch.sudo.cyberduck browser.disconnect.bookmarks.show true