:depth: 2
:local:
Mountain Duck runs in the status bar (macOS) and taskbar (Windows).
````{group-tab} macOS
```{image} _images/Status_Bar_Menu_Mac_Dark.png
:alt: Status Bar Menu (macOS Dark)
:width: 800px
```
<br/>
<br/>
Find the mounted volume in Finder. Choose *Go → Computer* or choose *Finder → General → Show these items on the desktop:* *Connected servers* to make it appear on your desktop.
```{tip}
Make sure there is enough space left on right side of the notch or application menu items to make sure the _Mountain Duck_ is visible in the the system status bar. To rearrange status menus, press and hold the Command key while you drag an icon. When having multiple displays attached to your computer the status bar item may not be visible on the main display but on the secondary display.
```
````
````{group-tab} Windows
![Task Bar Menu Windows](_images/Task_Bar_Menu_Windows.png)
Right-click on the taskbar and select *Taskbar setting → Notification area → Select which icons appear on the taskbar*. Make sure Mountain Duck is selected in the list.
```{tip}
If Mountain Duck is newly installed on a Windows 11 system, the tray icon must be revealed manually in *System Preferences → Personalization → Taskbar → Other system tray items*.
```
````
You can choose to automatically open Mountain Duck when logging in. Refer to Preferences. Re-opening the application will open previously mounted volumes. If you choose Enable Login Item and Save Workspace in Preferences → General and do not manually eject the volume prior to reboot it will reconnect after login.
Choose Open Connection… to add a new bookmark or → Edit Bookmark to change properties.
Bookmarks are shared between [Cyberduck](https://cyberduck.io/) and Mountain Duck.
- Default: Use setting from Preferences
- Online: Do not synchronize any file to your computer. See Online connect mode.
- Smart Synchronization: See Smart Synchronization connect mode.
:alt: Edit Bookmark (macOS)
:width: 500px
:alt: Edit Bookmark (Windows)
:width: 500px
The nickname determines the display of the bookmark in the menu and can be customized.
The nickname determines the name of the mounted volume in Finder.app on macOS or drive in File Explorer on Windows. Also refer to [Mount Location](preferences.md#mount-location).
Assign multiple labels to bookmarks. Bookmarks are grouped in folders in the status bar menu by their assigned labels.
:alt: Taskbar Menu Bookmark Groups (Windows, Large Icons)
:width: 400px
Select Options: Read Only in the bookmark to mount the volume as read-only and disallow any write operations on the remote disk.
Always assign the same drive letter to the mounted volume.
The number of concurrent connected bookmarks is limited by the number of available drive letters. You can have a total of 26 drives on your system.
You can search for bookmarks with the filter input field in the menu. Bookmarks not matching the input are greyed out.
:alt: Bookmark Search Input
:width: 400px
The bookmark can show three different status lights:
- No light: No current connection to this bookmark.
- Green light: Currently connected to this bookmark. The bookmark is completely synced and idle.
- Orange light: Currently connected to this bookmark. There is at least one active process.
You can can put the currently connected bookmarks on top of the bookmark list regardless of the sorting by using a hidden configuration option:
bookmark.menu.sort.connected=true
Choose → Connect to mount the server as a volume in the Finder.app on macOS or the File Explorer on Windows. You can connect to multiple servers and have several volumes mounted. All operations on the remote files and folders can then be performed like on local files.
You can just select the menu item with the bookmark name to connect, too. If you are already connected, selecting the menu item will reveal the volume in *Finder.app*.
You can mount volumes using your command-line interface (CLI) by opening a bookmark file.
````{group-tab} macOS
Use
`open -a "Mountain Duck" ~/Library/Group Containers/G69SCX94XU.duck/Library/Application Support/duck/Bookmarks/*.duck` in *Terminal.app*
````
````{group-tab} Windows
Enter the command `<path to Mountainduck.exe> %AppData%/Cyberduck/Bookmarks/<Bookmarkfile>` in *cmd.exe*.
````
Notifications of the connection status are posted to the Notification Center of the operating system.
- Filesystem mounted
- Filesystem unmounted
- Errors: If there is a network connectivity issue while the remote server is mounted, an alert is displayed that allows you to retry the connection or disconnect and unmount the volume.
- Sync Notifications
:alt: File Added Notification (Windows)
:width: 600px
Choose → Disconnect to unmount a volume. Alternatively, eject the volume in Finder.app or File Explorer.
````{group-tab} macOS
Choose *File → Eject* in *Finder.app* for the selected volume or control click to choose *Eject*.
**Disconnect using command line**<br/>
You can unmount volumes using your command-line interface (CLI). Use `umount <bookmark nickname>` in *Terminal.app*.
````
````{group-tab} Windows
In *File Explorer* in "This PC" view or the sidebar on the left of the *File Explorer* window, open the context menu for your mounted drive and select *Disconnect*.
**Disconnect using command line**<br/>
You can unmount volumes using your command-line interface (CLI). Use `net use <drive letter>: /delete` in *cmd.exe*
````
Drag files in Finder.app an macOS or File Explorer on Windows to move and copy files. You can also access the mounted volume with any other application and command-line interface.
A context menu in Finder on macOS and File Explorer on Windows allows various actions on files.
:alt: Context Menu (Windows)
:width: 600px
:class: tip
Please make sure to enable the Mountain Duck [Integration](#context-menu-in-finder-and-windows-file-explorer) in *System Preferences → Extensions → Finder Extensions*. For **macOS Ventura and later**, the setting can be found in *System Settings → Privacy & Security → Extensions → Added Extensions*.
Keep Offline on Local Disk or Delete on Local Disk to manage caching status. Refer to Sync Options.
Changes from the server are not immediately visible. The folder listing in the file browser may become outdated when another application adds, removes, or modifies files on the server. Mountain Duck periodically polls for changes for open folders in Finder.app on macOS or File Explorer on Windows about every minute in both Online and Smart Synchronization connect modes. Choose Reload from the context menu to refresh the directory listing.
:class: tip
Use _F5_ in _File Explorer_ to refresh the folder listing.
Enable the *Index Files* option in [*Preferences → Sync*](preferences.md#index-files) to allow new files on the remote storage to be detected periodically for previously opened directories regardless of any open window for the folder in _Finder.app_ on macOS or _File Explorer_ on Windows in _Smart Synchronization_ connect mode.
- Share…: Create an URL to share with someone else to allow downloading the file or folder.
- Request file…: Create an URL to share with someone else to allow uploading files to the selected folder.
Right-click files on a mounted drive will open a menu with items to copy & open HTTP URLs or create share links of files. This will include the Origin URL, HTTP URLs and temporary signed URLs in S3.
- Copy URL
- Open URL
Read more about sharing options.
:alt: Mountain Duck Finder Context Menu
:width: 1000px
Quick Look or Restore previous versions of documents on servers supporting versioning. Read more about versioning.
Right-click on white space within the mounted drive in Finder or Explorer to add a bookmark including the selected path.
Right-click on a folder and choose Open in Terminal to open an SSH connection to the server in Terminal for SFTP bookmarks.
This feature is not supported in the version available in the Mac App Store.
Right-click on a file and choose Info to change permissions, ACLs, metadata, and other service provider-specific settings on a file. Refer to Info Window.
Create a new Cryptomator Vault. Read more about client-side encryption.
Lock or unlock a Cryptomator Vault.
Use rsync
or any other of your preferred tools to mirror files for example to an S3 bucket. Set the --timeout=TIME
option in rsync
(in seconds) if you have low bandwidth or high latency connection.
Sublime Text and other editors allow you to open folders to work on multiple files.
Use your preferred archive utility to create a compressed archive of files already stored on the server.