[[TOC()]] = [wiki:help/en Cyberduck Help] / [wiki:help/en/howto 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). [[Image(Add Bookmark.png)]] * 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. [[Image(Proxy Icon.png)]] === 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 =|| ||Protocol||Your hosting service provider will let you know what protocol to use. Change the [wiki:help/en/howto/connection#Supportedprotocols 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.|| ||Public Key Authentication||For [wiki:help/en/howto/sftp 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.|| ||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 or to use the existing browser connection. When using the browser connection, transfers block other operations.|| ||Connect Mode||For [wiki:help/en/howto/ftp FTP] connections only. Refer to [wiki:help/en/howto/ftp#FTPConnectMode FTP Connect Mode].|| ||Encoding||For [wiki:help/en/howto/ftp 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 [wiki:help/en/howto/ftp#CharacterEncoding Character Encoding].|| ||Timezone||For all protocols except [wiki:help/en/howto/ftp FTP], timestamps are reported in [http://en.wikipedia.org/wiki/Coordinated_Universal_Time 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 [wiki:help/en/howto/ftp 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. [[BR]] 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''|| [[BR]] [[Image(HTTP URL.png)]] See also [wiki:help/en/howto/browser#OpenorcopyWebURL 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 [wiki:help/en/faq#WheredoesCyberduckstoreitsPreferences this FAQ entry]. [[Image(Drag Bookmark.png)]] '''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 ''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. * ''Transmit 4'' (as of [milestone:3.7 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 [milestone:4.1.1 4.1.1] for [http://winscp.net/eng/docs/ui_pref_storage#configuration_storage INI file to store configuration]) [[Image(Filezilla Import.png)]] == Sharing bookmarks between different computers == You can sign up for [https://www.dropbox.com/referrals/NTE1NDMxNjk 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 Terminal.app window and enter {{{ defaults write ch.sudo.cyberduck application.support.path ~/Dropbox/Cyberduck }}} * Restart Cyberduck. == Preferences == === Don't save bookmarks === A [wiki:help/en/howto/preferences#Hiddenconfigurationoptions hidden configuration option]. {{{ defaults write ch.sudo.cyberduck favorites.save false }}} === Do not read favicon.ico from HTTP URL === A [wiki:help/en/howto/preferences#Hiddenconfigurationoptions hidden configuration option]. Displayed in the bookmark edit window. {{{ defaults write ch.sudo.cyberduck bookmark.favicon.download false }}} === Open bookmark view after disconnecting === A [wiki:help/en/howto/preferences#Hiddenconfigurationoptions hidden configuration option]. {{{ defaults write ch.sudo.cyberduck browser.disconnect.showBookmarks true }}}