Mountain Duck 5

mountainduck/connect/index.md

@@ -4,73 +4,88 @@ Connect mode
 :::{toctree}
 :hidden:
 :titlesonly:
+integrated
 sync
 online
 :::
 
-When connecting to a server, you can choose between *[Online](online.md)* and *[Smart Synchronization](sync.md)* connect
-mode.
+When connecting to a server, you can choose between *[Online](online.md)*, *[Smart Synchronization](sync.md)*, and
+*[Integrated](integrated.md)* connect
+mode:
 
 ::::{tabs}
+:::{tab} Integrated
+
+The [_Integrated_ connect mode](integrated.md) synchronizes files and folders from a directory on the local disk with
+support from macOS and Windows.
+
+:::
 :::{tab} Online
 
-In _Online_ connect mode, changes to a file are immediately uploaded and in sync when an application has finished saving a file.
+Using [_Online_ connect mode](online.md), changes to a file are immediately uploaded and in sync when an application has
+finished saving a file.
 
 :::
 :::{tab} Smart Synchronization
 
-In _Smart Synchronization_ connect mode, files are copied to a local cache for faster access prior synchronization with the server in the background.
+In [_Smart Synchronization_ connect mode](sync.md), files are copied to a local cache for faster access prior
+synchronization with the server in the background.
 
 :::
 ::::
 
 ## Feature Comparison
 
-|                                          | **Online**                                                            | **Smart Synchronization**                                                     |
-|------------------------------------------|-----------------------------------------------------------------------|-------------------------------------------------------------------------------|
-| **Offline Access**                       | –                                                                     | Save files in cache on disk for access with no server connectivity            |
-| **Index Files**                          | –                                                                     | Index folder contents in cache on disk for access with no server connectivity |
-| **Buffer file contents**                 | ︎Temporarily save opened files for faster access later                | Temporarily save opened files to copy to cache on disk                        |
-| **Synchronization**                      | Changes are immediately uploaded                                      | Synchronize changes in the background                                         |
-| **Transfer Progress**                    | Upload shown in progress window in _Finder.app_ or _Windows Explorer_ | Uploads shown in the status bar (macOS) or taskbar (Windows)                  |
-| **[Recent Files](sync.md#recent-files)** | –                                                                     | Available in the status bar (macOS) or taskbar (Windows)                      |
-| **[Lock Files](../locking.md)**          | ✔︎                                                                    | ✔                                                                             |
-| **[Share Files](../share.md)**           | ✔                                                                     | ✔                                                                             |
+|                                          | **Online**                                             | **Smart Synchronization**                                                       | **Integrated**                                                                                         |
+|------------------------------------------|--------------------------------------------------------|---------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------|
+| **Network Volume**                       | ✔                                                      | ✔                                                                               | –                                                                                                      |
+| **Offline Access**                       | –                                                      | ✔ Save files in cache on disk for access with no server connectivity            | ✔                                                                                                      |
+| **Index Files**                          | –                                                      | ✔ Index folder contents in cache on disk for access with no server connectivity | ✔                                                                                                      |
+| **Buffer file contents**                 | ︎Temporarily save opened files for faster access later | Temporarily save opened files to copy to cache on disk                          | –                                                                                                      |
+| **Synchronization**                      | Changes are immediately uploaded                       | ✔ Synchronize changes in the background                                         | ✔                                                                                                      |
+| **Transfer Progress**                    | Progress window in _Finder.app_ or _Windows Explorer_  | Progress in the status bar (macOS) or taskbar (Windows)                         | Progress in the status bar (macOS) or taskbar (Windows) and progress icon in Finder & Windows Explorer |
+| **[Recent Files](sync.md#recent-files)** | –                                                      | ✔ Available in the status bar (macOS) or taskbar (Windows)                      | ✔                                                                                                      |
+| **[Lock Files](../locking.md)**          | ✔︎                                                     | ✔                                                                               | –                                                                                                      |
+| **[Share Files](../share.md)**           | ✔                                                      | ✔                                                                               | ✔                                                                                                      |
 
 ## Quota Support
 
 Mountain Duck displays the overall quota present on the server as available disk space on the mounted volume.
 
-| Protocol                 | Support |
-|--------------------------| :---: |
-| [Local Disk](../../protocols/index.md#local-disk)  | ✅ |
-| [SFTP](../../protocols/sftp/index.md#free-space-calculation-is-incorrect)  | ✅ |
-| [FTP](../../protocols/ftp.md)                      | ❌ |
-| [WebDAV](../../protocols/webdav/index.md)			 | ✅ |
-| [Google Drive](../../protocols/googledrive.md)     | ✅ |
-| [Google Cloud Storage](../../protocols/googlecloudstorage.md)  | ❌ |
-| [Microsoft OneDrive](../../protocols/onedrive.md#quota)  | ✅ |
-| [Microsoft Sharepoint](../../protocols/sharepoint.md#quota)  | ✅ |
-| [Files.com](../../protocols/files.com.md)          | ❌ |
-| [DRACOON](../../protocols/dracoon.md)              | ✅ |
-| [Backblaze B2](../../protocols/b2.md)              | ❌ |
-| [Box.com](../../protocols/box.md)                  | ❌ |
-| [Dropbox](../../protocols/dropbox.md)              | ✅ |
-| [Nextcloud](../../protocols/webdav/nextcloud.md)   | ✅ |
-| [ownCloud](../../protocols/webdav/nextcloud.md)    | ✅ |
-| [S3](../../protocols/s3/index.md)                  | ❌ |
-| [SMB](../../protocols/smb.md)                      | ✅ |
-| [Windows Azure ](../../protocols/azure.md)         | ❌ |
-| [OpenStack Object Storage](../../protocols/openstack/index.md)  | ✅ |
+| Protocol                                                                  | Support |
+|---------------------------------------------------------------------------|:-------:|
+| [Local Disk](../../protocols/index.md#local-disk)                         |    ✅    |
+| [SFTP](../../protocols/sftp/index.md#free-space-calculation-is-incorrect) |    ✅    |
+| [FTP](../../protocols/ftp.md)                                             |    ❌    |
+| [WebDAV](../../protocols/webdav/index.md)			                              |    ✅    |
+| [Google Drive](../../protocols/googledrive.md)                            |    ✅    |
+| [Google Cloud Storage](../../protocols/googlecloudstorage.md)             |    ❌    |
+| [Microsoft OneDrive](../../protocols/onedrive.md#quota)                   |    ✅    |
+| [Microsoft Sharepoint](../../protocols/sharepoint.md#quota)               |    ✅    |
+| [Files.com](../../protocols/files.com.md)                                 |    ❌    |
+| [DRACOON](../../protocols/dracoon.md)                                     |    ✅    |
+| [Backblaze B2](../../protocols/b2.md)                                     |    ❌    |
+| [Box.com](../../protocols/box.md)                                         |    ❌    |
+| [Dropbox](../../protocols/dropbox.md)                                     |    ✅    |
+| [Nextcloud](../../protocols/webdav/nextcloud.md)                          |    ✅    |
+| [ownCloud](../../protocols/webdav/nextcloud.md)                           |    ✅    |
+| [S3](../../protocols/s3/index.md)                                         |    ❌    |
+| [SMB](../../protocols/smb.md)                                             |    ✅    |
+| [Windows Azure ](../../protocols/azure.md)                                |    ❌    |
+| [OpenStack Object Storage](../../protocols/openstack/index.md)            |    ✅    |
 
 :::{admonition} Limited Support
 :class: attention
 
-- **[Microsoft OneDrive](../../protocols/onedrive.md#quota)**: Quota is only supported when setting the *Path* in the bookmark configuration to a folder different from `/`.
-- **[Microsoft SharePoint](../../protocols/sharepoint.md#quota)**: Quota is only supported when setting the *Path* in the bookmark configuration to a *Drives* folder in a SharePoint site folder.
-:::
+- **[Microsoft OneDrive](../../protocols/onedrive.md#quota)**: Quota is only supported when setting the *Path* in the
+  bookmark configuration to a folder different from `/`.
+- **[Microsoft SharePoint](../../protocols/sharepoint.md#quota)**: Quota is only supported when setting the *Path* in
+  the bookmark configuration to a *Drives* folder in a SharePoint site folder.
+  :::
 
-Some protocols do not report the available quota. Finder and Windows Explorer will show exabyte values in *Online* connect mode and the available space within the synchronization cache location on your local disk in *Smart Synchronization* connect mode for the affected protocols.
+Some protocols do not report the available quota. Finder and Windows Explorer will show exabyte values in *Online*
+connect mode and the available space within the synchronization cache location on your local disk in *Smart
+Synchronization* connect mode for the affected protocols.
 
 :::{note}
 Quota support can be [disabled](../../protocols/sftp/index.md#free-space-calculation-is-incorrect) for all protocols.

mountainduck/connect/integrated.md

@@ -0,0 +1,146 @@
+Integrated
+====
+
+:::{toctree}
+:hidden:
+:titlesonly:
+:::
+
+:::{image} ../_images/Disk_Syncing.png
+:alt: Disk Syncing
+:width: 200px
+:::
+
+> Local storage is managed by the operating system. The mount is not seen as a remote volume by applications but as a regular folder on disk. This option uses the tightly integrated _File Provider_ (macOS) and _Cloud Files_ (Windows) APIs. Directories can be browsed when offline and files opened are made available for later offline access. You can choose to make selected files and folders available for offline use. Changes to files are uploaded in the background as soon as a connection is available.
+
+:::{tip}
+You can access files in _Integrated_ connect mode without being always connected the server or cloud storage.
+:::
+
+
+## Status of Files
+
+Files and folders on a mounted volume have a status icon overlay in _File Explorer_ (Windows) and _Finder_ (macOS).
+
+### ![](../_images/overlay_uptodate.png) Up to Date
+The file or the contents of a directory has been opened and downloaded to your computer and therefore currently synced with the server or cloud storage. The file takes disk space on your computer and can always be opened even when no connection to the server or cloud storage is possible. New files in a directory on the remote server will appear as *Online Only* and are not downloaded automatically. Files copied to a volume are kept cached by default.
+
+:::{note}
+Files can be purged automatically from the cache when not accessed or the cache size limit is exceeded. Refer to [Cache Limitations](../preferences.md#cache-limitations).
+:::
+
+### ![](../_images/overlay_infinite.png) Online Only
+The file can only be opened when a connection to the server or cloud storage can be made. The file does not take any space on your computer. The file is downloaded on demand when you open it.
+
+::::{admonition} macOS only
+:class: note
+
+:::{image} ../_images/File_Provider_Online_Only.png
+:alt: File Provider Icon
+:width: 24px
+:align: left
+:::
+Click this additional icon displayed next to the filename in _Finder.app_ to request the download of the file.
+::::
+
+### ![](../_images/overlay_sync.png) In Sync
+The file or folder is selected to be synced with the server or cloud storage to always keep offline. The file takes disk space on your computer and can always be opened even when no connection to the server or cloud storage is possible. New files in a directory on the remote server will be downloaded automatically.
+
+:::{tip}
+Files explicitly selected to keep offline are **not** automatically purged. Refer to [Cache Limitations](../preferences.md#cache-limitations).
+:::
+
+### ![](../_images/overlay_syncing.png) Sync in Progress
+The file or folder is currently syncing with the server or cloud storage. Check the menu with the sync status for current download or upload progress.
+
+### ![](../_images/overlay_error.png) Sync Error
+Files that failed to sync after changes. You are missing permission to write to the file or another problem occurred. Please contact your web hosting service provider for assistance. To resolve the error, move the file to your local disk, and reload the directory. Refer to [Sync Conflicts](sync.md#sync-conflicts) for possible error scenarios. You can try to repeat the failed transfer by selecting *Mountain Duck → Retry* in the [context menu](sync.md#context-menu-options). If a sync error cannot be solved using *Mountain Duck → Retry* because the server does not allow the operation (i.e. due to a permission issue), you can resolve the error state on the file or folder by
+
+- Move the file or folder to another location on the volume
+- Delete the file or folder
+- To upload files to a target directory no longer existing on the server, you have to move the files to a location found on the server.
+
+::::{admonition} macOS only
+:class: note
+
+:::{image} ../_images/File_Provider_Ignored.png
+:alt: File Provider Icon
+:width: 24px
+:align: left
+:::
+This additional icon displayed next to the filename in _Finder.app_ indicates a sync error for the file.
+::::
+
+### ![](../_images/overlay-pause.png) Sync Paused
+The file or folder is pending syncing with the server but synchronization has been [paused](sync.md#pause-sync).
+
+### ![](../_images/overlay_ignored.png) Ignored
+The file or folder is only saved in local cache and not synced. New _Folders_, empty files and files matching [excluded filename patterns](../issues/index.md#filenames) are not uploaded. Folders are uploaded after being renamed.
+
+::::{admonition} macOS only
+:class: note
+
+:::{image} ../_images/File_Provider_Error.png
+:alt: File Provider Icon
+:width: 24px
+:align: left
+:::
+This additional icon displayed next to the filename in _Finder.app_ indicates the file is not synced.
+::::
+
+
+## Sync Progress
+
+Changes to files are uploaded in the background as soon as a connection is available. Progress is reported by animating the status bar icon and a menu item titled *Sync in Progress*.
+
+:::{admonition} Integrated Connect Mode
+:class: tip
+Progress is shown when downloading or uploading a file with a progress bar over the file icon or circular progress indicator adjacent the filename.
+:::
+
+### Keep Offline
+
+Choose *Mountain Duck → Keep Offline on Local Disk* to make files and folders available offline. The status of the file will change to *In Sync*. The action is recursive for all contained files when a folder is selected and applies to new files found on the remote storage.
+
+::::{admonition} macOS only
+:class: tip
+
+:::{image} ../_images/File_Provider_Online_Only.png
+:alt: File Provider Icon
+:width: 24px
+:align: left
+:::
+_Download Now_ when using _Integrated_ connect mode downloads the file but allows it to be removed from cache on low disk space.
+::::
+
+
+### Delete on Local Disk
+
+Choose *Mountain Duck → Delete on Local Disk* to delete the offline copy. The status of the file will change to *Online Only*. The action is recursive for all contained files when a folder is selected and allows you to quickly free up space used in the cache on your local disk.
+
+:::{admonition} macOS only
+:class: tip
+
+Choose _Remove Download_ instead when using _Integrated_ connect mode.
+:::
+
+## Cache 
+
+There are different ways to delete the sync cache:
+* Choose _Delete_ for the bookmark with connect mode set to *Smart Synchronization* or *Integrated*
+* Use the deletion prompt when switching the connect mode between *Integrated* and *Smart Synchronization*
+:::{image} ../_images/Prompt_Delete_Cache.png
+:alt: Delete Cache Prompt
+:width: 400px
+:::
+* Use the delete option in _Finder.app_ after choosing _Disconnect_ for the bookmark
+
+:::{image} ../_images/Finder_Option_Delete_Cache.png
+:alt: Delete Cache Option
+:width: 800px
+:::
+
+## Limitations
+
+- Custom mount locations are not honoured.
+- *[Pseudo File locking](../locking.md)* is not supported.

mountainduck/connect/sync.md

@@ -140,6 +140,16 @@ Choose _Mountain Duck → Retry_ to retry a sync operation failed previously wit
 
 The cache size can be limited per bookmark within the *Preferences → Sync* tab. Also files not accessed within a chosen period of time can be purged. Refer to [Cache Limitations](../preferences.md#cache-limitations). The cache contains obfuscated file contents on local disk to make files available when offline.
 
+### Delete Cache
+
+Cache contents for a bookmark can be deleted by either:
+* Delete the bookmark with connection mode set to *Smart Synchronization* or *Integrated*
+* Switch the connect mode between *Integrated* and *Smart Synchronization*
+
+```{image} ../_images/Prompt_Delete_Cache.png
+:alt: Delete Cache Prompt
+:width: 600px
+```
 
 ## Transfer Progress
 
@@ -158,7 +168,7 @@ Detailed status for current transfers is available in the *Sync* submenu. The sy
 
 :::{image} ../_images/Menu_Sync_in_Progress.png
 :alt: Sync Progress
-:width: 800px
+:width: 400px
 :::
 
 Shown for the current transfers are transfer rate, remaining data, and already transferred data. If Mountain Duck synchronizes files in a badge, the file state might differ from the state within the file browser. The sync progress display is limited to 5 entries.