nextcloud-desktop/doc/visualtour.rst

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

221 lines
8.5 KiB
ReStructuredText
Raw Normal View History

Visual Tour
===========
2013-09-02 19:16:53 +04:00
.. index:: visual tour, usage
2013-09-02 19:16:53 +04:00
2014-02-13 19:54:01 +04:00
Icon
----
The Nextcloud Client remains in the background and is visible
2014-02-13 19:54:01 +04:00
as an icon in the system tray (Windows, KDE), status bar
(macOS), or notification area (Ubuntu).
2013-09-02 19:16:53 +04:00
.. image:: images/icon.png
Main dialog
~~~~~~~~~~~
.. index:: activity, recent changes, sync activity, main dialog, adding account, account, add account, remove account
The main dialog, which can be invoked from the tray icon in the
taskbar, will show files information about the activities of the sync
client and Nextcloud. If there are any synchronization issues, they
will show up here. The dialog also gives information about other
activities or notifications like Talk mentions or file changes. It
does also show the status of the user.
.. image:: images/main_dialog.png
When clicking on the avatar a menu opens where it is possible to add a
new account or removing an existing account.
2014-02-13 19:54:01 +04:00
Menu
----
2013-09-02 19:16:53 +04:00
.. image:: images/traymenu.png
A right click on the icon provides the following menu:
* ``Open main dialog``: Opens the main dialog.
* ``Pause sync``: Pauses the synchronization.
* ``Settings``: Provides access to the settings menu.
* ``Exit Nextcloud``: Quits Nextcloud Client, ending a currently running
2014-02-13 19:54:01 +04:00
sync run.
2013-09-02 19:16:53 +04:00
.. NOTE::
This menu is not available on macOS.
2014-02-13 19:54:01 +04:00
Settings
--------
2013-09-02 19:16:53 +04:00
Account Settings
~~~~~~~~~~~~~~~~
.. index:: account settings, user, password, Server URL
2014-02-13 19:54:01 +04:00
The ``Account Settings tab`` provides an executive summary about the synced
folders in the account and gives the ability to modify them.
Where:
* ``Connected to <Nextcloud instance> as <user>``: Indicates the Nextcloud server
2014-02-13 19:54:01 +04:00
which the client is syncing with and the user account on that server.
* If the End-to-End encryption app is installed, then the current used
passphrase can be shown with clicking on ``Display mnemonic``.
Clicking on the tree dot menu or doing a right click on the folder
opens up a context menu with the following options:
* ``Open folder``: Opens the folder in the file explorer which the
operating system provides. In example on Windows it will open the Windows Explorer.
* ``Create new folder``: Creates a new folder.
* ``Force sync now``: Forces a synchronization run.
* ``Availability``: This entry is only available if the folder uses the
virtual files feature. The files in the folder can be either made
available offline with ``Make always available locally`` or if disk
space needs to be saved, they can be turned into placeholder files
with ``Free up local space``. ``Free up local space`` will not
delete any files.
* ``Add folder sync connection``: Provides the ability to add another folder to the sync
(see ``Adding a folder sync connection``).
* ``Pause sync/Resume sync``: Will pause the current sync or prevent the client from
2014-02-13 19:54:01 +04:00
starting a new sync. Resume will resume the sync process.
* ``Remove folder sync connection``: Will remove the selected folder from being synced. This is used,
2014-02-13 19:54:01 +04:00
for instance, when there is a desire to sync only a few folders and not the
root. First, remove the root from sync, then add the folders to sync as
desired.
* ``Edit Ignored Files``: Provides a list of files which will be ignored, i.e.,
2014-02-13 19:54:01 +04:00
will not sync between the client and server. The ignored files editor allows
adding patterns for files or directories that should be excluded from the
sync process. Besides normal characters, wild cards may be used, an asterisk
* indicating multiple characters, or a question mark ? indicating a single
character.
* ``Enable virtual file support/Disable virtual file support``: Enable
or disable virtual file support for this folder.
2014-02-13 19:54:01 +04:00
2013-09-02 19:16:53 +04:00
.. image:: images/settingsdialog.png
2013-09-02 19:16:53 +04:00
Adding a Folder Sync Connection
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2014-02-13 19:54:01 +04:00
Adding a new sync is initiated by clicking ``Add Folder Sync Connection`` in
the ``Account`` settings.
2014-02-13 19:54:01 +04:00
.. image:: images/folderwizard_local.png
The Directory and alias name must be unique.
Then select the folder on the server to sync with. It is important to note that, a
2014-02-13 19:54:01 +04:00
server folder can only sync to the client one time. So, in the above example,
the sync is to the server root directory and thus it is not possible to select
another folder under the root to sync.
.. image:: images/folderwizard_remote.png
2014-02-13 19:54:01 +04:00
General
~~~~~~~
2013-09-02 19:16:53 +04:00
.. index:: general settings, auto start, startup, desktop notifications
2013-09-02 19:16:53 +04:00
The tab provides several useful options:
.. image:: images/settings_general.png
2014-02-13 19:54:01 +04:00
* ``Launch on System Startup``: This option is automatically activated
once a user has conimaged his account. Un-checking the box will cause
Nextcloud client to not launch on startup for a particular user.
2014-02-13 19:54:01 +04:00
* ``Show Desktop Nofications``: When checked, bubble notifications when
a set of sync operations has been performed are provided.
* ``Use Monochrome Icons``: Use less obtrusive icons. Especially useful
on macOS.
2014-02-13 19:54:01 +04:00
* ``About``: provides information about authors as well as build conditions.
This information is valuable when submitting a support request.
2013-09-02 19:16:53 +04:00
2014-02-13 19:54:01 +04:00
Network
~~~~~~~
2013-09-02 19:16:53 +04:00
.. index:: proxy settings, SOCKS, bandwith, throttling, limiting
This tab consolidates ``Proxy Settings`` and ``Bandwith Limiting``:
2013-09-02 19:16:53 +04:00
.. image:: images/settings_network.png
:scale: 50 %
Proxy Settings
^^^^^^^^^^^^^^
* ``No Proxy``: Check this if Nextcloud Client should circumvent the default
2013-09-02 19:16:53 +04:00
proxy conimaged on the system.
* ``Use system proxy``: Default, will follow the systems proxy settings.
On Linux, this will only pick up the value of the variable ``http_proxy``.
* ``Specify proxy manually as``: Allows to specify custom proxy settings.
If you require to go through a HTTP(S) proxy server such as Squid or Microsoft
Forefront TMG, pick ``HTTP(S)``. ``SOCKSv5`` on the other hand is particularly
2013-09-02 19:16:53 +04:00
useful in special company LAN setups, or in combination with the OpenSSH
dynamic application level forwarding feature (see ``ssh -D``).
* ``Host``: Enter the host name or IP address of your proxy server, followed
by the port number. HTTP proxies usually listen on Ports 8080 (default) or
3128. SOCKS server usually listen on port 1080.
* ``Proxy Server requires authentication``: Should be checked if the proxy
2014-02-13 19:54:01 +04:00
server does not allow anonymous usage. If checked, a username and password
must be provided.
2013-09-02 19:16:53 +04:00
Bandwidth Limiting
^^^^^^^^^^^^^^^^^^
2014-02-13 19:54:01 +04:00
The Download Bandwidth can be either unlimited (default) or limited to a
custom value. This is the bandwidth available for data flowing from the
Nextcloud Server to the client.
2014-02-13 19:54:01 +04:00
The Upload Bandwidth, the bandwidth available or data flowing from the
Nextcloud client to the server, has an additional option to limit automatically.
2014-02-13 19:54:01 +04:00
When this option is checked, the Nextcloud client will surrender available
2014-02-13 19:54:01 +04:00
bandwidth to other applications. Use this option if there are issues with
real time communication in conjunction with the Nextcloud Client.
2013-09-02 19:16:53 +04:00
.. _ignoredFilesEditor-label:
2013-09-02 19:16:53 +04:00
The Ignored Files Editor
~~~~~~~~~~~~~~~~~~~~~~~~
.. index:: ignored files, exclude files, pattern
Nextcloud Client has the ability to exclude files from the sync process.
The ignored files editor allows editing of custom patterns for files or
directories that should be excluded from the sync process.
2013-12-12 01:08:24 +04:00
There is a system wide list of default ignore patterns. These global defaults
cannot be directly modified within the editor. Hovering with the mouse will
2013-12-12 01:08:24 +04:00
reveal the location of the global exclude definition file.
.. image:: images/ignored_files_editor.png
:scale: 50%
Each line contains an ignore pattern string. Next to normal characters,
2013-09-02 19:16:53 +04:00
wildcards can be used to match an arbitrary number of characters, designated
by an asterisk (``*``) or a single character, designated by a question mark
2013-12-12 01:08:24 +04:00
(``?``). If a pattern ends with a slash character (``/``) the pattern is only
applied to directory components of the path to check.
2013-09-02 19:16:53 +04:00
2013-12-12 01:08:24 +04:00
If the checkbox is checked for a pattern in the editor it means that files
which are matched by this pattern are fleeting metadata which the client will
*remove*.
2013-09-02 19:16:53 +04:00
.. note:: Modifying the global exclude definition file might render the
client unusable or cause undesired behavior.
.. note:: Custom entries are currently not validated for syntactical
correctness by the editor, but might fail to load correctly.
In addition to this list, Nextcloud Client always excludes files with
characters that cannot be synced to other file systems.
2013-12-12 01:08:24 +04:00
With version 1.5.0 it also ignores files that caused individual errors
2013-12-12 01:08:24 +04:00
while syncing for a three times. These are listed in the activity view.
There also is a button to retry the sync for another three times.
2013-09-02 19:16:53 +04:00
2013-12-12 01:08:24 +04:00
For more detailed information see :ref:`ignored-files-label`.