KDEConnect: Difference between revisions

    From KDE UserBase Wiki
    (A few fixes in preparation to fill the page)
    (Marked this version for translation)
    (2 intermediate revisions by 2 users not shown)
    Line 1: Line 1:
    <languages />
    <languages />
    <translate>
    <translate>
    == What is KDE Connect? ==
    == What is KDE Connect? == <!--T:1-->


    <!--T:2-->
    '''KDE Connect''' is a project that enables all your devices to communicate with each other. Here's a few things '''KDE Connect''' can do:
    '''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</translate>
    <!--T:3-->
    * Receive your phone notifications on your desktop computer and reply to messages</translate>
    <translate>
    <translate>
    <!--T:4-->
    * Control music playing on your desktop from your phone</translate>
    * Control music playing on your desktop from your phone</translate>
    <translate>
    <translate>
    <!--T:5-->
    * Use your phone as a remote control for your desktop</translate>
    * Use your phone as a remote control for your desktop</translate>
    <translate>
    <translate>
    <!--T:6-->
    * Run predefined commands on your PC from connected devices. See the list of example commands for more details.</translate>
    * Run predefined commands on your PC from connected devices. See the list of example commands for more details.</translate>
    <translate>
    <translate>
    * Check your phones battery level from the desktop</translate>
    <!--T:7-->
    * Check your phone's battery level from the desktop</translate>
    <translate>
    <translate>
    * Ring your phone to help finding it</translate>
    <!--T:8-->
    * Ring your phone to help find it</translate>
    <translate>
    <translate>
    <!--T:9-->
    * Share files and links between devices</translate>
    * Share files and links between devices</translate>
    <translate>
    <translate>
    * Browse your phone from the desktop</translate>
    <!--T:10-->
    * Browse your phone from your desktop</translate>
    <translate>
    <translate>
    * Control the desktop's volume from the phone
    <!--T:11-->
    * Control the desktop's volume using your phone




    <!--T:12-->
    Despite common misconception, you can use '''KDE Connect''' on all desktop environments. Since most developers are using Plasma, it may occur that a feature is broken or inaccessible on other desktop environments. In this case, please report it as a bug. There are multiple ways to enhance the KDE Connect experience on non-Plasma desktops. If you are a GNOME user you might prefer '''GSConnect''', a GNOME shell extension. For desktops with AppIndicator support (Budgie, Cinnamon, LXDE, Pantheon, Unity), indicator-kdeconnect is available.  
    Despite common misconception, you can use '''KDE Connect''' on all desktop environments. Since most developers are using Plasma, it may occur that a feature is broken or inaccessible on other desktop environments. In this case, please report it as a bug. There are multiple ways to enhance the KDE Connect experience on non-Plasma desktops. If you are a GNOME user you might prefer '''GSConnect''', a GNOME shell extension. For desktops with AppIndicator support (Budgie, Cinnamon, LXDE, Pantheon, Unity), indicator-kdeconnect is available.  


    <!--T:13-->
    '''KDE Connect''' for the moment only supports Android and SailfishOS. The '''KDE Connect''' developers are working on supporting more phone os (plasma mobile, postmarketOS, etc. ).
    '''KDE Connect''' for the moment only supports Android and SailfishOS. The '''KDE Connect''' developers are working on supporting more phone os (plasma mobile, postmarketOS, etc. ).


    == Installation==
    == Installation== <!--T:14-->


    <!--T:15-->
    Before using '''KDE Connect''', you need to install it on your computer through your distro's repositories and your phone.
    Before using '''KDE Connect''', you need to install it on your computer through your distro's repositories and your phone.


    <!--T:16-->
    You can install '''KDE Connect''' on your computer by searching it on '''Discover''' or using one of the following commands:
    You can install '''KDE Connect''' on your computer by searching it on '''Discover''' or using one of the following commands:




    * On Debian, Ubuntu and Ubuntu-based distros: sudo apt install kdeconnect
    <!--T:17-->
    * On Fedora: sudo yum install kdeconnect
    * On Debian, Ubuntu and Ubuntu-based distros: sudo apt install kdeconnect</translate>
    * On openSUSE: sudo zypper install kdeconnect
    <translate>
    <!--T:18-->
    * On Fedora: sudo yum install kdeconnect</translate>
    <translate>
    <!--T:19-->
    * On openSUSE: sudo zypper install kdeconnect</translate>
    <translate>
    <!--T:20-->
    * On Arch and Arch-based distros: sudo pacman -S kdeconnect OR yay -S kdeconnect
    * On Arch and Arch-based distros: sudo pacman -S kdeconnect OR yay -S kdeconnect




    <!--T:21-->
    A more complete guide explaining how to install KDE software on your computer is available [[Special:myLanguage/Tutorials/Install_KDE_software|here]].
    A more complete guide explaining how to install KDE software on your computer is available [[Special:myLanguage/Tutorials/Install_KDE_software|here]].


    <!--T:22-->
    On your phone, '''KDE Connect''' is available on the [https://play.google.com/store/apps/details?id=org.kde.kdeconnect_tp Play Store] or on [https://f-droid.org/en/packages/org.kde.kdeconnect_tp/ F-Droid].</translate>
    On your phone, '''KDE Connect''' is available on the [https://play.google.com/store/apps/details?id=org.kde.kdeconnect_tp Play Store] or on [https://f-droid.org/en/packages/org.kde.kdeconnect_tp/ F-Droid].</translate>


    <translate>  
    <translate>  
    <!--T:23-->
    For '''SailfishOS''', you can find more information in the [https://openrepos.net/content/piggz/kde-connect community store].
    For '''SailfishOS''', you can find more information in the [https://openrepos.net/content/piggz/kde-connect community store].




    ==Pairing two devices together==
    ==Pairing two devices together== <!--T:24-->


    <!--T:25-->
    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 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 troubleshooting section available in the [https://community.kde.org/KDEConnect#I_have_two_devices_running_KDE_Connect_on_the_same_network.2C_but_they_can.27t_see_each_other Community wiki].  
    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 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 troubleshooting section available in the [https://community.kde.org/KDEConnect#I_have_two_devices_running_KDE_Connect_on_the_same_network.2C_but_they_can.27t_see_each_other Community wiki].  


    <!--T:26-->
    [[File:KDE_Connect_computer_sync.png|4000px|center]]
    [[File:KDE_Connect_computer_sync.png|4000px|center]]


    <!--T:27-->
    [[File:KDE_Connect_android_sync.jpg|300px|center]]
    [[File:KDE_Connect_android_sync.jpg|300px|center]]


    <!--T:28-->
    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.
    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.


    <!--T:29-->
    While a typical configuration might include one computer and one phone, it's also possible to pair two computers instead.
    While a typical configuration might include one computer and one phone, it's also possible to pair two computers instead.


    <!--T:30-->
    {{Construction}}
    {{Construction}}


    == Overview ==
    == Overview == <!--T:31-->


    <!--T:32-->
    This is the documentation page for '''KDEConnect'''. You can see the community page here [https://community.kde.org/KDEConnect] which explains what '''KDEConnect''' is and how to install it.
    This is the documentation page for '''KDEConnect'''. You can see the community page here [https://community.kde.org/KDEConnect] which explains what '''KDEConnect''' is and how to install it.


    KDEConnect has two parts. The desktop program and the phone app.
    <!--T:33-->
    '''KDE Connect''' has two parts. The desktop program and the phone app.


    == Changing Device Names ==
    == Changing Device Names == <!--T:34-->


    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. If you want to change the name of your phone or tablet you must make the change in the phone app. Once a device is renamed it will automatically sync with all other connected devices.
    <!--T:35-->
    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. 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.


    == Plugins ==
    ==Available Plugins == <!--T:36-->


    ===Battery Monitor===
    ===Battery Monitor=== <!--T:37-->


    <!--T:38-->
    Show your phone battery next to your computer battery.
    Show your phone battery next to your computer battery.


    ===Clipboard===
    ===Clipboard=== <!--T:39-->
     
    <!--T:40-->
    ''Share the clipboard between devices.''


    Share the clipboard between devices.
    ===Inhibit Screensaver=== <!--T:41-->


    ===Inhibit Screensaver===
    <!--T:42-->
    ''Inhibit the screensaver when the device is connected.''


    Inhibit the screensaver when the device is connected.
    <!--T:43-->
    This makes sure that your screensaver will not run while your device is connected.


    ===Multimedia Control Receiver===
    ===Multimedia Control Receiver=== <!--T:44-->


    With this feature, you can remote control your music and videos. You can also change the application sound volume.
    <!--T:45-->
    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.


    <!--T:46-->
    [[File:KDEConnectMultimediaControlReceiverAndroid.png|300px|center|Multimedia control receiver with KDE Connect in Android]]
    [[File:KDEConnectMultimediaControlReceiverAndroid.png|300px|center|Multimedia control receiver with KDE Connect in Android]]


    ===Pause Media During Calls===
    ===Pause Media During Calls=== <!--T:47-->


    Pause music/videos during the call. This features can be powerfully combined with the [[Special:myLanguage/Plasma-browser-integration|Plasma Browser Integration]]. For example, when you are listening to some music on Youtube, the music will be paused during the call.
    <!--T:48-->
    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 Youtube, the video will be paused whenever you receive a call.


    <!--T:49-->
    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.  
    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===
    ===Ping=== <!--T:50-->


    Send and receive ping
    <!--T:51-->
    ''Send and receive ping.''


    <!--T:52-->
    This serves to test your connection to a given device. Once selected, a "Ping!" will appear as a notification on your receiving device.
    <!--T:53-->
    On your desktop, you can send a ping through the KDE Connect settings or through the widget on the tray.
    <!--T:54-->
    On your phone, you can send a ping through the upper right hamburger menu on the '''KDE Connect''' app.
    <!--T:55-->
    [[FIle:KDE_Connect_ping_android.jpg|center|300px|Send a ping to your computer with android]]
    [[FIle:KDE_Connect_ping_android.jpg|center|300px|Send a ping to your computer with android]]


    ===Receive Notifications===
    ===Receive Notifications=== <!--T:56-->


    Show your phone notifications on your computer and keep them in sync.
    <!--T:57-->
    ''Show your phone notifications on your computer and keep them in sync.''


    ===Remote File System Browser===
    <!--T:58-->
    This keeps you in touch with what happens on your phone! Any notifications you receive on your phone will be shown in your computer. Some notifications, such as those of Instant Messengers (IM) like Telegram can be replied on the fly through the computer notification itself.


    explanation here
    ===Remote File System Browser=== <!--T:59-->
     
    <!--T:60-->
    This allows you to access your phone storage! When enabled, a device will appear in Dolphin, with which you can navigate your internal and external storage.


    ===Ring My Phone===
    ===Ring My Phone=== <!--T:61-->


    explanation here
    <!--T:62-->
    This also serves to test your connection to a given device, and by ringing your phone remotely, you can quickly find its location!


    ===Run Commands===
    ===Run Commands=== <!--T:63-->


    With KDE Connect, you can run from your phone with only one click predefined commands on your computer.
    <!--T:64-->
    There is a tutorial about adding new command in [[Special:myLanguage/KDE_Connect/Tutorials/Adding_commands|userbase]]. A set of useful commands can also be found [[Special:myLanguage/KDE_Connect/Tutorials/Useful_commands|here]].
    With '''KDE Connect''', you can run predefined commands on your computer by pressing buttons on your phone!
    Instructions on how to add a command are shown in [[Special:myLanguage/KDE_Connect/Tutorials/Adding_commands|userbase]]. A set of useful commands can also be found [[Special:myLanguage/KDE_Connect/Tutorials/Useful_commands|here]].


    ===Send Notifications===
    ===Send Notifications=== <!--T:65-->


    explanation here
    <!--T:66-->
    This keeps you in touch with what happens on your computer! Any notifications you receive on your computer will be shown in your phone.


    ===Share and Receive===
    ===Share and Receive=== <!--T:67-->


    <!--T:68-->
    explanation here
    explanation here


    ===Telephony Integration===
    ===Telephone Integration=== <!--T:69-->


    <!--T:70-->
    explanation here
    explanation here


    ===Virtual Input===
    ===Virtual Input=== <!--T:71-->


    <!--T:72-->
    explanation here
    explanation here
    </translate>
    </translate>

    Revision as of 09:47, 13 September 2019

    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


    Despite common misconception, you can use KDE Connect on all desktop environments. Since most developers are using Plasma, it may occur that a feature is broken or inaccessible on other desktop environments. In this case, please report it as a bug. There are multiple ways to enhance the KDE Connect experience on non-Plasma desktops. If you are a GNOME user you might prefer GSConnect, a GNOME shell extension. For desktops with AppIndicator support (Budgie, Cinnamon, LXDE, Pantheon, Unity), indicator-kdeconnect is available.

    KDE Connect for the moment only supports Android and SailfishOS. The KDE Connect developers are working on supporting more phone os (plasma mobile, postmarketOS, etc. ).

    Installation

    Before using KDE Connect, you need to install it on your computer through your distro's repositories and your phone.

    You can install KDE Connect on your computer by searching it on Discover or using one of the following commands:


    • On Debian, Ubuntu and Ubuntu-based distros: sudo apt install kdeconnect
    • On Fedora: sudo yum install kdeconnect
    • On openSUSE: sudo zypper install kdeconnect
    • On Arch and Arch-based distros: sudo pacman -S kdeconnect OR yay -S kdeconnect


    A more complete guide explaining how to install KDE software on your computer is available here.

    On your phone, KDE Connect is available on the Play Store or on F-Droid.


    For SailfishOS, you can find more information in the community store.


    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 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 troubleshooting section available in the Community wiki.

    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.

    Under Construction

    This is a new page, currently under construction!


    Overview

    This is the documentation page for KDEConnect. You can see the community page here [1] which explains what KDEConnect is and how to install it.

    KDE Connect has two parts. The desktop program and the phone app.

    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. 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.

    Available Plugins

    Battery Monitor

    Show your phone battery next to your computer battery.

    Clipboard

    Share the clipboard between devices.

    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

    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.

    Multimedia control receiver with KDE Connect in Android
    Multimedia control receiver with KDE Connect in Android

    Pause Media During Calls

    Pause music/videos during a call. This feature can be powerful when combined with Plasma Browser Integration. For example, when you are listening to some music on 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 ping.

    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.

    Send a ping to your computer with android
    Send a ping to your computer with android

    Receive Notifications

    Show your phone notifications on your computer and keep them in sync.

    This keeps you in touch with what happens on your phone! Any notifications you receive on your phone will be shown in your computer. Some notifications, such as those of Instant Messengers (IM) like Telegram can be replied on the fly through the computer notification itself.

    Remote File System Browser

    This allows you to access your phone storage! When enabled, a device will appear in Dolphin, with which you can navigate your internal and external storage.

    Ring My Phone

    This also serves to test your connection to a given device, and by ringing your phone remotely, you can quickly find its location!

    Run Commands

    With KDE Connect, you can run predefined commands on your computer by pressing buttons on your phone! Instructions on how to add a command are shown in userbase. A set of useful commands can also be found here.

    Send Notifications

    This keeps you in touch with what happens on your computer! Any notifications you receive on your computer will be shown in your phone.

    Share and Receive

    explanation here

    Telephone Integration

    explanation here

    Virtual Input

    explanation here