Jump to content

Translate

AllKDEConnect
Translate to Ελληνικά

Translation of the wiki page KDEConnect from English (en).

This tool does not work without JavaScript. JavaScript is disabled, failed to work, or this browser is unsupported.
KDEConnect
KDEConnect
You need translation rights to translate messages.Get permission
Loading...
Latest updatesAll changes
Suggestions
In other languages
== Overview ==
== Overview ==
You need translation rights to translate messages.Get permission
Loading...
Latest updatesAll changes
Suggestions
In other languages
This is the documentation page for '''KDE Connect'''. If you are developing, debugging, or building a release of '''KDE Connect''', please refer to the [https://community.kde.org/KDEConnect community page].
'''KDE Connect''' has two parts: the desktop program and the phone app.
== What is KDE Connect? ==
'''KDE Connect''' is a project that enables all your devices to communicate with each other. Here's a few things '''KDE Connect''' can do:
* Receive your phone notifications on your desktop computer and reply to messages
* Control music playing on your desktop from your phone
* Use your phone as a remote control for your desktop
* Run predefined commands on your PC from connected devices. See the list of example commands for more details.
* Check your phone's battery level from the desktop
* Ring your phone to help find it
* Share files and links between devices
* Browse your phone from your desktop
* Control the desktop's volume using your phone
* Send SMS from your desktop
== Installation==
You will most likely find the '''KDE Connect''' desktop component as a package in your distribution's repos. If not, you can ask them to package it.
Despite common misconception, you can use '''KDE Connect''' on all desktop environments. Since most of the developers are using Plasma, it may occur that a feature is broken or inaccessible on other desktop environments. In this case, please file a [https://bugs.kde.org/enter_bug.cgi?product=kdeconnect bug report].
There are multiple ways to enhance the '''KDE Connect''' experience on non-Plasma desktops. If you are a GNOME user you might prefer [https://extensions.gnome.org/extension/1319/gsconnect/ GSConnect], a GNOME shell extension. For desktops with AppIndicator support (Budgie, Cinnamon, LXDE, Pantheon, Unity), KDE Connect already comes with the '''kdeconnect-indicator''' binary, which can be set to autostart in each environment.
The app for Android can be found in both the [https://play.google.com/store/apps/details?id=org.kde.kdeconnect_tp Google Play Store] and the free and open store [https://f-droid.org/repository/browse/?fdid=org.kde.kdeconnect_tp F-Droid].
The app for iOS can be found in [https://apps.apple.com/app/kde-connect/id1580245991 Apple's proprietary App Store]. Additionally, a pre-release, testing version of KDE Connect can be downloaded from [https://testflight.apple.com/join/vxCluwBF TestFlight]. Please see the [https://invent.kde.org/network/kdeconnect-ios/-/blob/master/README.md iOS README] for important data disclosure information, known limitations, and bug reporting information.
'''KDE Connect''' is also available for SailfishOS via [https://openrepos.net/content/r1tschy/sailfish-connect sailfish-connect] and we are working on bringing it to other Linux-based phones (Plasma Mobile, PostmarketOS etc.)
[https://kdeconnect.kde.org/download.html See KDE Connect download page] for installation links for other platforms (including Windows and macOS).
==Pairing two devices together==
First, you need to open '''KDE Connect''' on your computer ''and'' phone. 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, make sure that the two devices are connected to the same network and that there isn't any firewall blocking the two devices from seeing each other. See the [[Special:myLanguage/KDEConnect#I_have_two_devices_running_KDE_Connect_on_the_same_network.2C_but_they_can.27t_see_each_other|troubleshooting section]].
[[File:kde_connect_desktop.png|700px|center]]
[[File:kde_connect_on_android_phone_devices.png|300px|center]]
You can now request pairing in one of the two devices. The other device will show a prompt asking to accept the pairing request. Confirm it and that's it! Your devices are now paired.
While a typical configuration might include one computer and one phone, it's also possible to pair two computers instead.
== Bluetooth Connectivity ==
In recent versions (for example v24.08.1) bluetooth connectivity has been enabled by default. To use this, you must first bluetooth pair your computer and phone.
[[File:KDEConnect-Bluetooth-1.png|300px|center]]
Click Add device:
[[File:KDEConnect-Bluetooth-2.png|300px|center]]
Make sure your phone is visible to pairing and it will appear, once appeared click pair:
[[File:KDEConnect-Bluetooth-3.png|300px|center]] [[File:KDEConnect-Bluetooth-4.png|300px|center]]
It will pop up with a PIN to be confirmed on both the computer and the phone:
[[File:KDEConnect-Bluetooth-5.png|300px|center]] [[File:KDEConnect-Bluetooth-A1.png|300px|center]]
Click matches on the desktop and pair on Android
It will then be connected correctly:
[[File:KDEConnect-Bluetooth-6.png|300px|center]] [[File:KDEConnect-Bluetooth-7.png|300px|center]] [[File:KDEConnect-Bluetooth-A2.png|300px|center]]
Once this has been achieved open the KDE Connect on Android and enable bluetooth
[[File:KDEConnect-Bluetooth-A-KDEBluetoothEnable.png|300px|center]]
On the "Add new devices" page, the computer should appear and the pairing process can be followed as usual. Refreshing this view can force the phone to attempt to rediscover. ''This may take some time to appear, both Android and Bluez seem to implement quite a lot of caching and this can delay how long it takes to be detected''.
[[File:KDEConnect-Bluetooth-A3.png|300px|center]]
== Browser Integration ==
[https://community.kde.org/Plasma/Browser_Integration Plasma Browser Integration] makes '''KDE Connect''' even more powerful. It allows you to control content from e.g. Youtube or Netflix from your phone and send browser tabs to your phone. Despite the name, it can also be used on non-Plasma desktops.
== Changing Device Names ==
You can only change the name of your device on the device itself. So if you want to change the name of your computer then you must use the desktop program and if you want to change the name of your phone or tablet you must make the change in the '''KDE Connect''' app. Once a device is renamed, it will automatically sync with all other connected devices.
[[File:kde_connect_renaming_device.png|800px|center]]
== Running KDE Connect over OpenVPN ==
There may be a variety of reasons for using '''KDE Connect''' with a VPN. Maybe you have left home and want to run a command, or maybe you’re on a public wifi network where your devices aren’t allowed to communicate and you want to use the remote control to give a presentation.
=== Set up OpenVPN ===
If you have your own server with a public-facing IP address, you can set up '''OpenVPN''' yourself. It is not the easiest piece of software to set up, but by following a setup tutorial such as [https://openvpn.net/howto.html this one], you should be able to manage.
In order to allow UDP broadcast packets, which are what '''KDE Connect''' uses to automatically discover two devices, '''OpenVPN''' needs to be set up for bridging (TAP device). If you use a tun device, you can still manually connect by IP address.
If you want to rent a pre-configured '''OpenVPN''' service rather than set up your own, it should work, but the same considerations about the server settings need to be taken into account.
Once the server is running, you can use the official '''OpenVPN''' client to connect the desktop to the server. There is no official '''OpenVPN''' client for Android, but the '''OpenVPN for Android''' client works well: [https://play.google.com/store/apps/details?id=de.blinkt.openvpn openvpn]
Once both devices are connected, test that they are able to communicate over the VPN by trying to do a network ping between them.
=== Configure KDE Connect ===
If your '''OpenVPN''' instance is set up for bridging, '''KDE Connect''' should work just like on a local network.
If you are using '''OpenVPN''' with a tun device, you will have to manually add your devices by IP. Then, once you connect to the VPN, '''KDE Connect''' should automatically detect your device and either connect or be ready for pairing!
==Available Plugins ==
===Battery Monitor===
''"Show your phone battery next to your computer battery."''
By enabling this, the '''KDE Connect''' widget on your panel tray will display your phone's battery.
[[File:KDEConnectBattery.png|500px|center]]
===Clipboard===
''"Share the clipboard between devices."''
With this, you can simply copy text from your computer and it will be immediately available to paste on your phone, and vice-versa. This does not work with images though.
====Auto-sync on Android 10+==== Android 10 prevents apps from accessing the clipboard to prevent malicious apps from accessing your data. This makes the clipboard plugin in KDE Connect uncomfortable to use.
On Android 14, there's a tile in the pull-down menu called "Send clipboard", that can be moved to a convenient slot (e.g. in the partial pull-down section).
=====Magisk Module (root only)===== If you are rooted, you can use a Magisk module to remove this restriction.
=====Log Reading===== If you have a build containing commit [https://invent.kde.org/network/kdeconnect-android/commit/edc655da5ac1eb5c3027c8556cc62037a1d4c5ac edc655da5ac1eb5c3027c8556cc62037a1d4c5ac], you can enable the READ_LOGS permission in order to enable a workaround to clipboard sync.
Enable [https://developer.android.com/studio/debug/dev-options USB debugging] on your phone.
Run these commands:
<syntaxhighlight lang="bash"> adb -d shell pm grant org.kde.kdeconnect_tp android.permission.READ_LOGS; adb -d shell appops set org.kde.kdeconnect_tp SYSTEM_ALERT_WINDOW allow; adb -d shell am force-stop org.kde.kdeconnect_tp; </syntaxhighlight>
''How does it work?''
With log reading enabled, KDE Connect watches its own log. If it sees a line indicating that it has been denied access to read the clipboard, it pops up an invisible window to the foreground, grabs the clipboard, and closes the window.
===Contacts===
''"Synchronize contacts between devices"''
This plugin silently synchronizes contacts, in vcard format, from your phone to your desktop.
As of this writing, the synchronization is one-way, with data being sent from the Android implementation to the desktop, to be consumed by any application which uses the KPeople library with the KPeopleVCard plugin, such as the KDE Connect SMS app.
====VCard Location====
On non-Windows platforms, contact cards are written to ''QStandardPaths::writableLocation(QStandardPaths::GenericDataLocation) + "/kpeoplevcard"''. This might be configured differently by your system, but normally resolves to ''~/.local/share/kpeoplevcard''.
On Windows, the path resolves to ''%LocalAppData%''.
===Inhibit Screensaver===
''"Inhibit the screensaver when the device is connected."''
This makes sure that your screensaver will not run while your device is connected.
===Multimedia Control Receiver=== ''"Remote control your music and videos."''
With this feature, you can control your music and videos remotely, with pause/play, previous/next, 5 s before/later. You can also change which media player to control, in addition to application and system volume.
[[File:Kde connect media player on android phone.jpg|300px|center|Multimedia control receiver with KDE Connect in Android]]
===Pause Media During Calls=== ''"Pause music/videos during a phone call."''
Pause music/videos during a call. This feature can be powerful when combined with [[Special:myLanguage/Plasma-browser-integration|Plasma Browser Integration]]. For example, when you are listening to some music on Peertube or Youtube, the video will be paused whenever you receive a call.
You can configure this option to pause only when you pick up your phone or directly when your phone starts to ring. You can also decide if you want to only pause the media player or/and mute the system sound.
===Ping===
''"Send and receive pings."''
This serves to test your connection to a given device. Once selected, a "Ping!" will appear as a notification on your receiving device.
On your desktop, you can send a ping through the KDE Connect settings or through the widget on the tray.
On your phone, you can send a ping through the upper right hamburger menu on the '''KDE Connect''' app.
96 more messages
0% translated, 0% reviewed
All
Recent