Add KDE Connect

README.md

@@ -8,7 +8,7 @@ _by Filippo Gentile and Luca Pellegrini_
 - [Introduction](#introduction)
   - [Operating Systems we use](#operating-systems-we-use)
 - At first boot
-  - Setting up a firewall (UFW)
+  - [Setting up a firewall](src/firewall.md)
   - Update, upgrade and reboot
 - [APT package manager](src/apt.md)
   - [Basic commands](src/apt.md#basic-apt-commands)
@@ -28,7 +28,7 @@ _by Filippo Gentile and Luca Pellegrini_
     - Edit performance settings
   - KRunner: a very, very powerfull launcher
   - Activities and virtual desktops
-  - KDE Connect: integration between your desktop and smartphone
+  - [KDE Connect: integration between desktop and smartphone](src/kde.md#kde-connect)
   - Other suggested KDE apps
 - [Web Browsers and Extensions](src/web_browsers.md)
   - Mozilla Firefox

src/firewall.md

@@ -0,0 +1,38 @@
+# Setting up a firewall
+
+## KDE Connect
+
+KDE Connect uses dynamic ports in the range 1714-1764 for UDP and TCP. So, we need to make sure that these ports are open for both TCP and UDP.
+
+#### ufw
+
+If your firewall is **ufw**, you can open the necessary ports with:
+
+```shell
+sudo ufw allow 1714:1764/udp
+sudo ufw allow 1714:1764/tcp
+sudo ufw reload
+```
+
+#### firewalld
+
+If your firewall is **firewalld**, you can open the necessary ports with:
+
+```shell
+sudo firewall-cmd --permanent --zone=public --add-service=kdeconnect
+sudo firewall-cmd --reload
+```
+
+#### iptables
+
+If your firewall is **iptables**, you can open the necessary ports with:
+
+```shell
+sudo iptables -I INPUT -i <yourinterface> -p udp --dport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
+sudo iptables -I INPUT -i <yourinterface> -p tcp --dport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
+
+sudo iptables -A OUTPUT -o <yourinterface> -p udp --sport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
+sudo iptables -A OUTPUT -o <yourinterface> -p tcp --sport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
+```
+
+Credits: [KDE UserBase Wiki](https://userbase.kde.org/KDEConnect#Troubleshooting)

src/kde.md

@@ -1,3 +1,11 @@
+# KDE Plasma Desktop
+
+KDE is a worldwide community of volunteer software developers who work together to build and maintain Free and Open Sourse pieces of Software.
+
+_Plasma_ is a desktop environment developed by the KDE community. A key feature of Plasma Desktop and of all KDE applications is that they are **very customizable**.
+
+The _System Settings_ app allows you can customize your desktop experience extensively. Settings are divided in many pages (there are a lot of them).
+
 ## KIO Admin
 
 Dolphin (KDE File manager) refuses to run as root.
@@ -37,3 +45,22 @@ Add `export GTK_USE_PORTAL=1` to `.profile` and logout/login [Arch Wiki](https:/
 + Enable RedShift
 + [SafeEyes](https://slgobinath.github.io/SafeEyes/)
 
+## KDE Connect
+
+Project's website: [kdeconnect.kde.org](https://kdeconnect.kde.org/)
+
+_KDE Connect_ is an application that enables all your devices (smartphones, tablets and computers) to communicate with each other.
+
+KDE Connect has a lot of features:
+* Share files and link between devices
+* Share the clipboard (what you copied on the phone can be instantly pasted on the computer)
+* Sync phone notifications to your computers
+* Control music and video playback on one device from another one
+* Browse files on your phone from your computer
+* And many more...
+
+In order to use KDE Connect, you need to open the app on both your computer _and_ your phone; they must be connected to same network (e.g. your home Wi-Fi).
+You should now be able to see in each screen the name of the device you wish to pair with.
+If it's not working, you may need to [modify your firewall settings](./firewall.md#kde-connect).
+
+You can find detailed information about KDE Connect on [this page](https://userbase.kde.org/KDEConnect) of the KDE UserBase Wiki.