Warning, /network/kdeconnect-kde/README.md is written in an unsupported language. File is not indexed.
0001 # KDE Connect - desktop app 0002 0003 KDE Connect is a multi-platform app that allows your devices to communicate (eg: your phone and your computer). 0004 0005 ## (Some) Features 0006 - **Shared clipboard**: copy and paste between your phone and your computer (or any other device). 0007 - **Notification sync**: Read and reply to your Android notifications from the desktop. 0008 - **Share files and URLs** instantly from one device to another including some filesystem integration. 0009 - **Multimedia remote control**: Use your phone as a remote for Linux media players. 0010 - **Virtual touchpad**: Use your phone screen as your computer's touchpad and keyboard. 0011 - **Presentation remote**: Advance your presentation slides straight from your phone. 0012 - **Run Commands**: Run shell commands on your computer from your phone. 0013 - **Access SMS**: Read, send and reply to SMS and MMS from your computer. 0014 0015 All this is done completely wirelessly, utilising TLS encryption. 0016 0017 ## Userbase wiki 0018 A user-focused wiki can be found on [KDE Userbase](https://userbase.kde.org/KDEConnect) 0019 0020 ## Supported platforms 0021 - Computers running Linux with Plasma 5, Gnome 3, Elementary OS... any distro with Qt5 support :) 0022 - Android, by installing the KDE Connect app from the [Play Store](https://play.google.com/store/apps/details?id=org.kde.kdeconnect_tp) or [F-Droid](https://f-droid.org/repository/browse/?fdid=org.kde.kdeconnect_tp). 0023 - iPhone and iPad, by installing from the [App Store](https://apps.apple.com/us/app/kde-connect/id1580245991) 0024 - Computers running Windows, by installing from the [Microsoft Store](https://apps.microsoft.com/store/detail/kde-connect/9N93MRMSXBF0) 0025 0026 ## How to install 0027 These instructions explain how to install KDE Connect on your computer. You will also need to install it on your Android device and pair them together in the app before using this application. The Android app repository can be found [here](https://invent.kde.org/network/kdeconnect-android) 0028 0029 ### On Linux 0030 Look in your distribution repo for a package called `kdeconnect-kde`, 0031 `kdeconnect-plasma`, just `kdeconnect` or `kde-connect`. 0032 If it's not there and you know how to build software from sources, you just 0033 found the repo :), instructions are 0034 [here](https://community.kde.org/KDEConnect#Linux_Desktop) 0035 0036 ### On Mac or Windows 0037 Platforms other than Linux are not officially supported, as there has yet to be an official release of KDE Connect for MacOS or Windows. However, most of the features have already been ported to windows so you can compile KDE Connect for Windows using [Craft](https://community.kde.org/Craft). It hasn't yet been completely tested on MacOS, contributions and feedback are welcome! 0038 0039 ### On BSD 0040 It should work, but no promises :) 0041 0042 0043 ## How does it work? 0044 KDE Connect consists of a UI-agnostic "core" library that exposes a series of DBus interfaces, and several UI components that consume these DBus interfaces. This way, new UI components can be added to integrate better with specific platforms or desktops, without having to reimplement the protocol or any of the internals. The core KDE Connect library is also divided into 4 big blocks: 0045 0046 - **LinkProviders**: Are in charge of discovering other KDE Connect-enabled devices in the network and establishing a Link to them. 0047 - **Devices**: Represent a remote device, abstracting the specific Link that is being used to reach it. 0048 - **NetworkPackets**: JSON-serializable and self-contained pieces of information to be sent by the plugins between devices. 0049 - **Plugins**: Independent pieces of code that implement a specific feature. Plugins will use NetworkPackets to exchange information through the network with other Plugins on a remote Device. 0050 0051 The basic structure of a NetworkPacket is the following: 0052 0053 ``` 0054 { 0055 "id": 123456789, 0056 "type": "com.example.myplugin", 0057 "body": { }, 0058 "version": 5 0059 } 0060 ``` 0061 0062 The content of the `"body"` section is defined by each Plugin. Hence, only the emitter and receiver plugins of a given packet type need agree on the contents of the body. 0063 0064 NetworkPackets can also have binary data attached that can't be serialized to JSON. In this case, two new fields will be added: 0065 0066 `"payloadSize"`: The size of the file, or -1 if it is a stream without known size. 0067 `"payloadTransferInfo"`: Another JSON object where the specific Link can add information so the Link in the remote end can establish a connection and receive the payload (eg: IP and port in a local network). It's up to the Link implementation to decide how to use this field. 0068 0069 ## Contributing 0070 0071 To contribute patches, use [KDE Connect's GitLab](https://invent.kde.org/network/kdeconnect-kde). There you can also find a task list with stuff to do and links to other relevant resources. It is a good idea to also subscribe to the [KDE Connect mailing list](https://mail.kde.org/mailman/listinfo/kdeconnect). We can also be reached on IRC at #kdeconnect on irc.libera.chat or on [Telegram](https://t.me/joinchat/AOS6gA37orb2dZCLhqbZjg), contributions and feedback are warmly welcomed. 0072 0073 For bug reporting, please use [KDE's Bugzilla](https://bugs.kde.org). Please do not use the issue tracker in GitLab since we want to keep everything in one place. 0074 0075 Please know that all translations for all KDE apps are handled by the [localization team](https://l10n.kde.org/). If you would like to submit a translation, that should be done by working with the proper team for that language. 0076 0077 ## License 0078 [GNU GPL v2](https://www.gnu.org/licenses/gpl-2.0.html) and [GNU GPL v3](https://www.gnu.org/licenses/gpl-3.0.html) 0079 0080 If you are reading this from Github, you should know that this is just a mirror of the [KDE Project repo](https://invent.kde.org/network/kdeconnect-kde).