nextcloud-desktop/doc/navigating.rst

255 lines
9.5 KiB
ReStructuredText
Raw Normal View History

2015-08-29 17:26:48 +03:00
================================
2014-06-26 00:04:33 +04:00
Using the Synchronization Client
================================
.. index:: navigating, usage
The ownCloud Desktop Client remains in the background and is visible as an icon
in the system tray (Windows, KDE), status bar (Mac OS X), or notification area
(Linux).
2014-06-26 00:04:33 +04:00
2015-12-03 21:29:44 +03:00
.. figure:: images/icon.png
2015-09-19 00:36:00 +03:00
:alt: Status icon, little cloud with green circle and white checkmark
2014-06-26 00:04:33 +04:00
The status indicator uses overlay icons to indicate the current status of your
synchronization. The green circle with the white checkmark tells you that your
synchronization is current and you are connected to your ownCloud server.
2015-12-03 21:29:44 +03:00
.. figure:: images/icon-syncing.png
2015-09-19 00:36:00 +03:00
:alt: Status icon, little cloud with blue circle and white semi-circles
The blue icon with the white semi-circles means synchronization is in progress.
2015-12-03 21:29:44 +03:00
.. figure:: images/icon-paused.png
2015-09-19 00:36:00 +03:00
:alt: Status icon, little cloud with yellow circle and vertical parallel
lines
The yellow overlay icon with the parallel lines tells you your synchronization
2015-09-19 00:36:00 +03:00
has been paused. (Most likely by you.)
2015-12-03 21:29:44 +03:00
.. figure:: images/icon-offline.png
2015-09-19 00:36:00 +03:00
:alt: Status icon, little gray cloud with gray circle and three horizontal
white dots
The gray icon with three white dots means your sync client has lost its
connection with your ownCloud server.
2015-12-03 21:29:44 +03:00
.. figure:: images/icon-information.png
2015-09-19 00:36:00 +03:00
:alt: Status icon, little cloud with letter "i" in white circle
When you see a white circle with the letter "i" that is the informational icon,
so you should click it to see what it has to tell you.
2015-12-03 21:29:44 +03:00
.. figure:: images/icon-error.png
2015-09-19 00:36:00 +03:00
:alt: Status icon, little cloud with red circle and white x
The red circle with the white "x" indicates a configuration error, such as an
incorrect login or server URL.
2014-06-26 00:04:33 +04:00
2015-12-02 22:52:42 +03:00
Systray Icon
------------
2014-06-26 00:04:33 +04:00
2015-12-02 22:52:42 +03:00
A right-click on the systray icon opens a menu for quick access to multiple
operations.
2014-06-26 00:04:33 +04:00
2015-12-03 21:29:44 +03:00
.. figure:: images/menu.png
2015-08-29 17:26:48 +03:00
:alt: the right-click sync client menu
2014-06-26 00:04:33 +04:00
2015-12-02 22:52:42 +03:00
This menu provides the following options:
2014-06-26 00:04:33 +04:00
2015-12-01 04:09:27 +03:00
* Quick access to your accounts
2016-02-18 21:31:51 +03:00
* Sync status
2015-12-01 04:09:27 +03:00
* Recent Changes, showing latest activities
2016-02-18 21:31:51 +03:00
* Settings
2015-12-01 04:09:27 +03:00
* Help menu
2015-12-02 22:52:42 +03:00
* An option to log in or log out of all of your accounts at once
2016-02-18 21:31:51 +03:00
* Quit ownCloud, logging out and closing the client
2014-06-26 00:04:33 +04:00
2015-12-02 22:52:42 +03:00
A left-click on your systray icon opens the desktop client to the account
settings window.
2014-06-26 00:04:33 +04:00
2015-12-03 21:29:44 +03:00
.. figure:: images/client6.png
2015-08-29 17:26:48 +03:00
:alt: Account settings window
2014-06-26 00:04:33 +04:00
2015-12-02 22:52:42 +03:00
Configuring ownCloud Account Settings
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. index:: account settings, user, password, Server URL
2015-09-19 00:36:00 +03:00
At the top of the window are tabs for each configured sync account, and three
others for Activity, General and Network settings. On your account tabs you
have the following features:
* Connection status, showing which ownCloud server you are connected to, and
your ownCloud username.
2015-12-01 04:09:27 +03:00
* An **Account** button, which contains a dropdown menu with **Add New**,
2016-02-18 21:31:51 +03:00
**Log In/Log Out**, and **Remove**.
2015-09-19 00:36:00 +03:00
* Used and available space on the server.
* Current synchronization status.
* **Add Folder Sync Connection** button, which is active only when you have
removed synchronization on an account (see **Remove Sync** below).
2015-12-01 04:09:27 +03:00
The little button with three dots (the overflow menu) that sits to the right of
the sync status bar offers four additional options:
2015-09-19 00:36:00 +03:00
* Open Folder
2015-10-21 19:44:38 +03:00
* Choose What to Sync
* Pause Sync / Resume Sync
2015-12-01 04:09:27 +03:00
* Remove folder sync connection
2015-09-19 00:36:00 +03:00
2015-10-21 19:44:38 +03:00
**Open Folder** opens a file explorer window displaying the client-side folder
that is being synced.
2015-09-21 20:19:49 +03:00
2015-12-02 22:52:42 +03:00
**Choose What to Sync** opens the folder sync tree view. Use this to sync all
or only some of the folders in the folder tree.
2015-10-21 19:44:38 +03:00
2015-12-02 22:52:42 +03:00
**Pause Sync** pauses sync operations without making any changes to your
account. It will continue to update file and folder lists, without
downloading or updating files. To stop all sync activity use **Remove Sync**.
2015-10-21 19:44:38 +03:00
2015-12-02 22:52:42 +03:00
**Resume Sync** resumes sync operations.
**Remove Sync** removes the sync connection without removing the account. This
stops all sync activity, including file and folder list updates. If you want to
synchronize the folder tree again then click the **Add Folder Sync Connection**
button, and re-select the folder tree that you want to sync.
2015-09-19 00:36:00 +03:00
2015-12-03 21:29:44 +03:00
.. figure:: images/client-7.png
2015-09-19 00:36:00 +03:00
:alt: Extra options for sync operations
2015-12-02 22:52:42 +03:00
2016-01-06 23:45:23 +03:00
.. note:: ownCloud does not preserve the mtime (modification time) of
directories, though it does update the mtimes on files. See
`Wrong folder date when syncing
<https://github.com/owncloud/core/issues/7009>`_ for discussion of this.
2015-12-02 23:02:55 +03:00
Adding New Accounts
^^^^^^^^^^^^^^^^^^^
2016-02-18 21:31:51 +03:00
You may configure multiple ownCloud accounts in your desktop sync client.
Simply
2015-12-02 23:02:55 +03:00
click the **Account** > **Add New** button on any account tab to add a new
account, and then follow the account creation wizard. The new account will
2016-02-18 21:31:51 +03:00
appear as a new tab in the settings dialog, where you can adjust its settings
at
2015-12-03 21:29:44 +03:00
any time. Use **Account** > **Remove** to delete accounts.
Sharing From Your Desktop
-------------------------
The ownCloud desktop sync client integrates with your file manager: Finder on
Mac OS X, Explorer on Windows, and Nautilus on Linux. (Linux users must install
the ``owncloud-client-nautilus`` plugin.) You can create share links, and share
with internal ownCloud users the same way as in your ownCloud Web interface.
.. figure:: images/mac-share.png
:alt: Sync client integration in Finder on Mac OS X.
*Shared ownCloud files in Finder on Mac OS X*
Right-click your systray icon, hover over the account you want to use, and
left-click "Open folder [folder name] to quickly enter your local ownCloud
folder. Right-click the file or folder you want to share to expose the share
dialog, and click **Share with ownCloud**.
.. figure:: images/share-1.png
:alt: Sharing from Windows Explorer.
The share dialog has all the same options as your ownCloud Web interface.
.. figure:: images/share-2.png
:alt: Share dialog in Windows Explorer.
Use **Share with ownCloud** to see who you have shared with, and to modify
their permissions, or to delete the share.
2015-12-02 23:02:55 +03:00
2015-12-02 22:52:42 +03:00
Activity Window
---------------
2014-06-26 00:04:33 +04:00
2015-12-03 21:29:44 +03:00
The Activity window contains the log of your recent activities, organized over
three tabs: **Server Activities**, which includes new shares and files
downloaded and deleted, **Sync Protocol**, which displays local activities such
as which local folders your files went into, and **Not Synced** shows errors
such as files not synced.
2015-12-02 22:52:42 +03:00
2015-12-03 21:29:44 +03:00
.. figure:: images/client-8.png
2015-12-02 22:52:42 +03:00
:alt: Activity windows logs all server and client activities.
General Window
--------------
2014-06-26 00:04:33 +04:00
2015-09-19 00:36:00 +03:00
The General window has configuration options such as **Launch on System
2015-08-29 17:26:48 +03:00
Startup**, **Use Monochrome Icons**, and **Show Desktop Notifications**. This
is where you will find the **Edit Ignored Files** button, to launch the ignored
2015-12-01 04:09:27 +03:00
files editor, and **Ask confirmation before downloading
folders larger than [folder size]**.
2014-06-26 00:04:33 +04:00
2015-12-03 21:29:44 +03:00
.. figure:: images/client-9.png
2015-12-02 22:52:42 +03:00
:alt: General window contains configuration options.
2014-06-26 00:04:33 +04:00
2015-08-29 17:26:48 +03:00
Using the Network Window
------------------------
2014-06-26 00:04:33 +04:00
.. index:: proxy settings, SOCKS, bandwith, throttling, limiting
2015-08-29 17:26:48 +03:00
The Network settings window enables you to define network proxy settings, and
2015-12-03 21:29:44 +03:00
also to limit download and upload bandwidth.
2014-06-26 00:04:33 +04:00
2015-12-03 21:29:44 +03:00
.. figure:: images/settings_network.png
2014-06-26 00:04:33 +04:00
.. _ignoredFilesEditor-label:
Using the Ignored Files Editor
------------------------------
.. index:: ignored files, exclude files, pattern
You might have some local files or directories that you do not want to backup
and store on the server. To identify and exclude these files or directories, you
2015-12-02 22:52:42 +03:00
can use the *Ignored Files Editor* (General tab.)
2014-06-26 00:04:33 +04:00
2015-12-03 21:29:44 +03:00
.. figure:: images/ignored_files_editor.png
2014-06-26 00:04:33 +04:00
2016-02-18 21:31:51 +03:00
For your convenience, the editor is pre-populated with a default list of
typical
2015-08-29 17:26:48 +03:00
ignore patterns. These patterns are contained in a system file (typically
``sync-exclude.lst``) located in the ownCloud Client application directory. You
2016-02-18 21:31:51 +03:00
cannot modify these pre-populated patterns directly from the editor. However,
if
2015-08-29 17:26:48 +03:00
necessary, you can hover over any pattern in the list to show the path and
filename associated with that pattern, locate the file, and edit the
``sync-exclude.lst`` file.
2014-06-26 00:04:33 +04:00
.. note:: Modifying the global exclude definition file might render the client
unusable or result in undesired behavior.
Each line in the editor contains an ignore pattern string. When creating custom
patterns, in addition to being able to use normal characters to define an
ignore pattern, you can use wildcards characters for matching values. As an
2014-12-10 19:24:12 +03:00
example, you can use an asterisk (``*``) to identify an arbitrary number of
2014-06-26 00:04:33 +04:00
characters or a question mark (``?``) to identify a single character.
Patterns that end with a slash character (``/``) are applied to only directory
components of the path being checked.
.. note:: Custom entries are currently not validated for syntactical
2014-12-10 19:24:12 +03:00
correctness by the editor, so you will not see any warnings for bad
2015-10-21 19:44:38 +03:00
syntax. If your synchronization does not work as you expected, check your
syntax.
2014-06-26 00:04:33 +04:00
Each pattern string in the list is preceded by a checkbox. When the check box
contains a check mark, in addition to ignoring the file or directory component
matched by the pattern, any matched files are also deemed "fleeting metadata"
and removed by the client.
In addition to excluding files and directories that use patterns defined in
this list:
- The ownCloud Client always excludes files containing characters that cannot
be synchronized to other file systems.
2015-10-21 19:44:38 +03:00
- Files are removed that cause individual errors three times during a
synchronization. However, the client provides the option of retrying a
synchronization three additional times on files that produce errors.
2014-06-26 00:04:33 +04:00
For more detailed information see :ref:`ignored-files-label`.