Merge pull request 'Nextcloud desktop client H2 updated and fixed' (#62) from NC_Client_Desktop into master

Reviewed-on: Disroot/Howto#62

pages/02.tutorials/02.Cloud/05.Clients/01.Desktop/01.Multiplatform/00.desktop-sync-client/docs.en.md

@@ -1,10 +1,10 @@
 ---
-title: Nextcloud Desktop client
+title: 'Nextcloud Desktop Client'
 visible: false
 updated:
-        last_modified: "6 April 2019"
-        app: Nextcloud Desktop
-        app_version: 2.5.2 / Nautilus-Nextcloud integration plugin, version 2.5.0-1 AUR
+        last_modified: "January 2021"
+        app: Nextcloud Desktop Client
+        app_version: 3.0.3-2 on Manjaro Linux
 page-toc:
   active: true
 published: true
@@ -14,249 +14,187 @@ taxonomy:
     tags:
         - cloud
         - nextcloud
+        - client
+        - multiplatform
 ---
 
 # Nextcloud Desktop Client
 
-Using the **Nexcloud** desktop client provides a way to sync your files stored in your **Disroot Cloud** with a local folder on your desktop.
-This means you can access/add/remove/edit the files in your **Disroot** account from your desktop without needing to log to your account via web-browser. It also allows you to access them when offline.
+Using the **Nexcloud** desktop client provides a way to sync your files stored in your **Disroot Cloud** with a local folder on your computer desktop.
+This means you can access/add/remove/edit the files in your **Cloud** from your desktop without the need to log in to your account via web-browser. It also allows you to access them when offline.
 
+---
 
-# Installing Nextcloud client
+# Installing the Nextcloud client
 
-You can download and see how to install the **Nextcloud** desktop app [**here**](https://nextcloud.com/install/#install-clients).
+The client is already available to install from the Software manager of the following **GNU/Linux** distributions:
+- **openSUSE Tumbleweed**
+- **Arch Linux** (and distributions based on it)
+- **Fedora**
 
-Ubuntu and / or Ubuntu based distributions users can find better detailed instructions [**here**](https://www.c-rieger.de/how-to-install-nextcloud-desktop-client-for-ubuntu/).
+To install it on **Debian/Ubuntu** (and distributions based on it) users can find detailed instructions [**here**](https://launchpad.net/~nextcloud-devs/+archive/ubuntu/client).
 
+To learn how to install the client in other distributions and operating systems, you can check this [**page**](https://nextcloud.com/install/#install-clients).
 
 # Add a new account
 
-The first time you run the **Nextcloud** desktop client you will be directly greeted with the account setup:
+The first time you run the **Nextcloud** client an installation wizard will open guiding you through the account setup and some configuration options:
 
-- **Select:** Log in
-- **Server Address:** [cloud.disroot.org](cloud.disroot.org)
-- Press: Next
+1. Select **Log in**
+2. Enter the Server Address: **https://cloud.disroot.org**
+3. Press **Next**
+4. To connect your account press **Log in**
+5. Enter your **Disroot** username and password and **Log in** again
+6. **Grant access** to the app
+7. Once the client is connected you can close the browser
+8. Now you can setup your local cloud folder (we will see this below)
 
-![](en/desktop-client-01.gif)
+![](en/nextcloud_client_wizard.mp4?resize=1024,602&loop)
 
-## Login into your account<br>
-There are two ways of doing it:
+## Two-Factor Authentication login
+In case you have enabled the **Two-Factor Authentication (2FA)** method to log in to your **Disroot Cloud**, you will need to enter the code generated by the [**OTP**](https://en.wikipedia.org/wiki/One-time_password) application you use to do so when you configure the **Nexcloud** client and it request access permission:
 
-- **App Password** (for Two Factor Authentication)
-- **Normal Credentials**
+![](en/2fa_login.png)
 
-## App Password (Two Factor Authentication)
-If you have enabled **Two-Factor Authentication (2FA)** in your **Disroot Cloud**, then you need to:
+You can read about what it is and how to enable **Two-Factor Authentication** [**here**](https://howto.disroot.org/en/tutorials/cloud/settings#two-factor-authentication).
 
-- Generate an "App Password", in the **Security** section of your **Disroot Cloud** account web interface, to generate a specific **App Password** for the **Nextcloud** desktop client. You can read about how to do that [**here**](https://howto.disroot.org/en/cloud/introduction#app-password).
+## Setting up a local folder
 
-Once you have your **App Password** token **created** and **copied**, in the login menu:
+Now the final step in adding a new account is to configure the **sync folder** (the local folder where the files you have in the cloud will be synchronized).
 
-- **Select:** "Alternative login using app token"
-- **Username:** *your_disroot_account_username*
-- **App Token:** Paste the App Token you created
-- **Press:** Grant Access
+![](en/local_folder_options.png)
 
-![](en/desktop-client-03.gif)   
+On the local folder options screen you can choose to sync all of your files on the **Disroot Cloud** or select specific folders. The default local sync folder is `Nextcloud`, in your home directory. You can also change it for the folder you want or create a new one.
 
-## Normal Credentials
+There are five options in this screen:
+  1. By default, the client will try to **Sync everything** on the server. You can also see how much data (measured in MB or GB) you have in your cloud. If you want to sync only specific files or folders, select **Choose what to sync** (4)
+  2. Set a limit to not sync any file above a certain size you decided (this can be changed later at any point).
+  3. Set to ask for authorization if you want to sync external storages (to know more about External Storage go [**here**](https://howto.disroot.org/en/tutorials/cloud/settings#external-storages))
+  4. Select what folders to sync from your **Disroot Cloud** to your machine, by pressing **Choose what to sync**
+  5. And select or change the local folder by clicking the Local Folder button.
 
-If you do not have **2FA** enabeled then just:
-- Press the Log in button
-- **Username:** *your_disroot_account_username*
-- **Password:** *your_super_secret_password*
-- Press the Log in button again
-- Then press **"Grant Access"**
+![](en/local_folder_setup_2.png)
 
-![](en/desktop-client-02.gif)   
+Once you have selected the folder to sync press **OK** and then **Connect...**
 
-## Configuring a sync folder
+![](en/local_folder_setup_3.png)
 
-Final step in adding a new account is to configure the sync folder.
-After you successfully log in you will be prompted with a options panel where you can:
+The wizard will close and the client will start synchronizing files and folders (if any) minimized in the desktop task tray.
 
-- Select what folders to sync from your **Disroot Cloud** to your machine, by pressing "Choose what to sync"
-- Set a limit to not sync any file above a certain size you decided (this can be changed later at any point).
-- Authorize if you also want to sync External Storage's (you can know more about External Storage's [here](https://howto.disroot.org/en/cloud/introduction#external-storages))
-- Change the destination folder where your files will be synced in your hard drive (The Nextcloud Desktop Client will by default create a folder called "Nextcloud", in your home folder).
+![](en/local_folder_setup.mp4?resize=1024,602&loop)
 
-Once you are happy with the settings, just hit "Connect" at the lower left corner of the menu.
+From the desktop client interface you can access:
 
-![](en/desktop-client-04.gif)
+![](en/desktop_client.png)
 
-Any file you edit in the local folder in your machine (.txt, spreadsheet, word) will be synced with your **Disroot Cloud**. Any files you remove or add will be removed or added in your **Disroot Cloud**. Any change done from the interface will reflect your synced folder on your desktop, unless you opted out from synchronizing a particular file or folder.
+* To a minimal menu from where you can add or remove an account, pause/resume a sync, access the client settings, log out from an account or exit the client by clicking on the down arrow at the right of your username.
+* Your local folder (1)
+* The **Talk** app (2)*
+* The **Apps** (3)*
 
+\* **Talk** and **Apps** will be opened in the browser.
 
-# General options
-
-**Nextcloud** client opens by default in the background. By interacting with **Nextcloud** systray icon you can focus the app.![](en/desktop_client_systray.png)
-
-The app consists of 4 main tabs:
- - [Your account tab](#your-account-tab)
- - [Activity tab](#activity-tab)
- - [General tab](#general-tab)
- - [Network tab](#network-tab)
-
-![](en/desktop_client04.png)
-
-# Your account tab
-Gives you a general overview of what's the current status of your app.
-
-![](en/desktop_client05.png)
-
-**You can:**
- - See the status of any synchronization, and remaining disk space on your **Disroot Cloud** account
-
-![](en/desktop_client06.png)
-
- - Choose what folders to sync or stop syncing by clicking in the checkbox option. You will need to press the **Apply** button on the lower right corner of the window for the changes to take effect
-
-![](en/desktop-client-05.gif)
-
- - Confirm the signature of the ssl keys by pressing the padlock button
-
-![](en/desktop-client-06.gif)
-
-
- - Pause/Restart synchronization
- - Open the desktop folder where your files are
- - Remove folder
-
-All by pressing the three dotted button
-
-![](en/desktop-client-07.gif)
-
-- Add a new account
-- Remove account
-- Logout
-
-All by pressing the **"Account"** button on the upper right side of the window
-
-![](en/desktop-client-08.gif)
-
+From now on, any file you edit in the local folder on your machine (texts, spreadsheets, pictures, etc) will be synced with your **Disroot Cloud**. So whether you modify, add or remove files in this folder, they will also be modified, added or removed from your **Cloud**. The same will happen with the modifications you make through the web interface and they will be reflected in your local folder, unless you have chosen not to sync a particular file o folder.
 
 ## Adding multiple accounts
+**Nextcloud** desktop client can work with multiple accounts. You can add any **Nextcloud** account from any other server (including your own server, of course).
 
-**Nextcloud** desktop client works with multiple accounts. You aren't even restricted to only **Disroot** accounts either. You can add any **Nextcloud** account from any other server (including your own server, of course).
+To add an extra account the process is the same as the first one.
 
-Adding an extra account is the same process as adding the first one.
-In the **"Account"** button:
-- Press **"Add new"**
-- Follow the same steps as you did to register the first account (adjust the URL's if it's a different server)
+![](en/add_account.png)
 
-**NOTE:** The important thing to keep in mind. **You can't use the same Nextcloud folder** with multiple active accounts.<br>
-During the configuration process of a second account, **Nextcloud** client will create in your home folder a folder called **Nextcloud2"**. Keep and eye out for this.
+1. Click on the **Nexcloud** client icon in the system tray
+2. Select **"Add account"**
+3. Follow the same steps as you did to register the first account (you will need to adjust the server address if it is a different server)
 
-After you add a second account your, it will show up on the top bar of the app. This is how you also switch between accounts if you need to change settings.
+!! **NOTE**<br>
+!! Keep in mind that **you cannot use the same Nextcloud folder** with multiple active accounts.<br>
+!! During the configuration process of the second account, **Nextcloud** client will try to create a folder called **Nextcloud2"** in your home directory. Keep an eye to this.
 
-You will also see one separate **Activity tab** for each account.
+After you add a second account, it will show up on the top bar of the app. This is how you also switch between accounts if you need to change settings.
 
-![](en/desktop_client07.png)
+# Settings
+
+![](en/client_settings_1.png)
+
+To access the **Nextcloud** client settings just right click on the app icon in the tray and select **Settings**.
+
+![](en/client_settings_access.png)
+
+The **Settings** are divided in three main tabs:
+1. [Account Settings tab](#account-settings)
+2. [General tab](#general-tab)
+3. [Network tab](#network-tab)
+
+![](en/client_settings_tabs.png)
+
+## Account Settings tab
+It gives you a general overview of the connected accounts, the synced folders and some options to manage them.
+
+![](en/account_settings_tab.png)
+
+1. **Connected to**<br>
+Indicates the **Nextcloud** server which the client is syncing with, the user account on that server and the signature of the [**SSL keys**](https://en.wikipedia.org/wiki/Public_key_certificate) (you can check it by pressing the green lock icon)
+
+  ![](en/signature.png)
+
+2. **Storage usage**<br>
+  It provides details on the storage used on your **Cloud** account.
+
+3. **Synchronization options**<br>
+  Here you can choose what folders to sync or stop syncing by clicking in the checkbox option and then pressing the **Apply** button on the lower right corner of the window for the changes to take effect.
+
+  By clicking the three dots button you can:
+
+  ![](en/sync_options.png)
+
+ - Open the local folder
+
+ - Edit Ignored files: click this option to make a list of files which will not be synced between the client and server.
+
+ ![](en/ignored_files.png)
+
+  This option allows you to add patterns for files or directories that you do not want to be included in the sync process. You can use normal characters, wild cards (an asterisk ‘*’ to indicate multiple characters) or a question mark ‘?’ (to indicate a single character).
+
+ - Force/Pause synchronization
+
+ - And remove a selected folder from being synced. This is useful if, for example, you want to sync only one or some folders and not the entire root directory.
+
+4. **Add Folder Sync Connection**<br>
+  You can add another folder to the sync by clicking this button and then selecting the folder on the server to sync with. Keep in mind that the directory and the alias name must be unique, because a server folder can only sync to the client one time. So, if, for example, the sync is to the server root directory it will not be possible to select another folder under the root to sync.
+
+## General tab
+
+![](en/general_tab.png)
+
+In the **General** tab there are three sections:
+1. The **General Settings** section where you can:
+  - Set whether or not to launch the **Nextcloud** client when the system starts
+  - Set monochromatic icons on the system tray
+  - Show (or not) server notifications on the desktop that requires attention
+
+2. The **Advanced** section where you can:<br>
+  - **Edit Ignored Files**: This option works almost the same way as the one on the **Account settings tab**. The client ignores by default some files that are not synced. For example, hidden files or files which their names starts with `~/` or `.`<br> If you need to change this:<br>
+    a. Press this **Edit Ignored Files** button<br>
+    b. Then select the **Sync hidden files** option (if you want to sync all hidden files)<br>
+    c. Press the checkbox options to edit manually what files to allow to sync<br>
+    d. Click on **Add** to add new rules for files to ignore<br>
+    e. And finally press **OK** when you are done<br>
+    f. You can also set the rules back to the original setting by pressing **Restore Defaults**<br>
+
+  ![](en/ignored_files_editor.png)
+
+  - Set a size limit for files that you download to your local folder
+
+  - Set if the client should ask permission to sync External Storages
+
+3. The **About** section where you can see the client version and the legal notice
 
 
-# Activity tab
-**Activity** tab gives you an overview on all the uploaded/downloaded/added/removed files and folders from your accounts. Similar to Activity app in **Disroot cloud interface.**
+## Network tab
 
-![](en/desktop_client08.png)
+![](en/network_tab.png)
 
-# General tab
-**General** tab lets you:
-
- - Set the limit for files sizes that you download to you local folder
- - Set if the client should ask permission to sync External Storage's
- - Set to show notifications on your desktop
- - Launch Nextcloud Desktop Client when the system starts
- - See legal notice and if there are any updates
-
-
-![](en/desktop_client09.png)
-
-**Edit Ignored Files**
-Some files are ignored by default, and not synced by Nextcloud Desktop Client. For example hidden files or files that the name starts with: "~/", "."
-
-If this affects you, you can change this by:
-- Pressing the button **"Edit Ignored Files"**
-- Press the option **"Sync hidden files"** (if you want to sync all hidden files)
-- Press the checkbox options to edit manually what files to allow to sync
-- To add new rules for files to ignore press **"Add"**
-- At the end press **"ok"**
-- You can set the rules back to the original setting by pressing **"Restore Defaults"**
-
-![](en/desktop-client-09.gif)
-
-
-# Network tab
-
-The Network tab allows you to:
- - Configure your nextcloud desktop client for your proxy settings (if you are using a proxy)
- - Set maximum download and upload bandwidth
-
-![](en/desktop_client9.png)
-
-# Sharing From Your Desktop
-
-**Nextcloud** desktop client allows integration, with some **GNU/Linux** file managers, allowing you to share a file without needing to open the web interface of your **Disroot Cloud** account.
-
-Supported file managers at this moment are:
-- Nautilus
-- Nemo
-- Caja
-- Dolphin
-
-For the first three file managers you'll need to install:
-- The `Nextcloud-client-nautilus` plugin.
-The name of it might be different in some **GNU/Linux** distributions, e.g in **Arch Linux** it's `nextcloud-nautilus`.
-
-- The `python-nautilus` dependency.
-
-**KDE/Dolphin** file manager users must install the **Dolphin** plugin for **Nextcloud**.
-
-
-This integration allows you to:
-- Create Share links of files or folders
-- Manage those share links
-  - Delete them
-  - Set expiry date
-  - Set a password to open the link
-  - Share directly with other users or groups (if you know their usernames, or group name)
-
-To create a **share link** go to the Nextcloud folder on your machine with the file or folder you want to share.
-
-
-![](en/desktop-client-10.gif)
-
-Once you copied the link just send it via email, or some other way.
-
-To share directly with **another user or group** of **Disroot Cloud** (if you the persons username, or the group name)
-Just:
-- Write the username or group name in question in the text box
-- Press the arrow button on the right side of the text box
-
-And you will see in the button of the window information regarding that particular share.
-
-![](en/desktop-client-11.gif)
-
-And manage the share with the user in question:
-- Deleting the share
-- Allow re-sharing
-- Allow editing
-
-![](en/desktop-client-13.gif)
-
-You can manage these shares you create from your file manager at any time by the same process you used to originally create the share:
-
-- Right clicking on the file or folder
-- Select the nextcloud option
-- And press share
-
-**File status icon**
-
-With file manager integration, the file manager generates icons on the folders and files inside your nextcloud folder.
-This allows you to quickly see which files and folders where:
-- Successfully synced or not
-- That are still syncing
-- Shared
-
-||
-|:--:|:--:|
-|![](en/desktop_client11.png)|![](en/desktop_client12.png)|![](en/desktop_client13.png)|
+Finally, through this tab you can:
+ - Configure the proxy settings for your **Nextcloud** client (if you are using a proxy)
+ - And set bandwidth limits for download/upload