================================ 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). .. image:: images/icon.png :alt: Status icon, little cloud with green circle and white checkmark 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. .. image:: images/icon-syncing.png :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. .. image:: images/icon-paused.png :alt: Status icon, little cloud with yellow circle and vertical parallel lines The yellow overlay icon with the parallel lines tells you your synchronization has been paused. (Most likely by you.) .. image:: images/icon-offline.png :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. .. image:: images/icon-information.png :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. .. image:: images/icon-error.png :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. Systray Icon ------------ A right-click on the systray icon opens a menu for quick access to multiple operations. .. image:: images/menu.png :alt: the right-click sync client menu This menu provides the following options: * Quick access to your accounts * Recent Changes, showing latest activities * Status of your client version (whether it is up to date) * Help menu * An option to log in or log out of all of your accounts at once * Quit ownCloud A left-click on your systray icon opens the desktop client to the account settings window. .. image:: images/client6.png :alt: Account settings window Configuring ownCloud Account Settings ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. index:: account settings, user, password, Server URL 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. * An **Account** button, which contains a dropdown menu with **Add New**, **Sign In/Sign Out**, and **Remove**. * 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). The little button with three dots (the overflow menu) that sits to the right of the sync status bar offers four additional options: * Open Folder * Choose What to Sync * Pause Sync / Resume Sync * Remove folder sync connection **Open Folder** opens a file explorer window displaying the client-side folder that is being synced. **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. **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**. **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. .. image:: images/client-7.png :alt: Extra options for sync operations Activity Window --------------- The Activity window contains the log of your recent activities, including files downloaded and deleted, which local folders your files went into, and files not synced. .. image:: images/client-8.png :alt: Activity windows logs all server and client activities. General Window -------------- The General window has configuration options such as **Launch on System Startup**, **Use Monochrome Icons**, and **Show Desktop Notifications**. This is where you will find the **Edit Ignored Files** button, to launch the ignored files editor, and **Ask confirmation before downloading folders larger than [folder size]**. .. image:: images/client-9.png :alt: General window contains configuration options. Adding New Accounts ^^^^^^^^^^^^^^^^^^^ You may configure multiple ownCloud accounts in your desktop sync client. Simply click the **Account** > **Add New** button to add new account, and then follow the account creation wizard. The new account will appear as a new tab in the settings dialog, where you can adjust its settings at any time. Use **Account** > **Remove** to delete accounts. Using the Network Window ------------------------ .. index:: proxy settings, SOCKS, bandwith, throttling, limiting The Network settings window enables you to define network proxy settings, and also to limit download and upload bandwidth. New to version 2.0 is the option for automatic bandwidth limits. .. image:: images/settings_network.png .. _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 can use the *Ignored Files Editor* (General tab.) .. image:: images/ignored_files_editor.png For your convenience, the editor is pre-populated with a default list of typical ignore patterns. These patterns are contained in a system file (typically ``sync-exclude.lst``) located in the ownCloud Client application directory. You cannot modify these pre-populated patterns directly from the editor. However, if 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. .. 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 example, you can use an asterisk (``*``) to identify an arbitrary number of 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 correctness by the editor, so you will not see any warnings for bad syntax. If your synchronization does not work as you expected, check your syntax. 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. - 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. For more detailed information see :ref:`ignored-files-label`.