View source for KDEConnect/he

<languages />
<span id="Overview"></span>
== סקירה ==

זהו דף התיעוד של '''KDE Connect'''. אם אתה מפתח, מנפה באגים או בונה שחרור של '''KDE Connect''', אנא עיין ב[https://community.kde.org/KDEConnect דף הקהילה].

ל-'''KDE Connect''' ישנם שני חלקים: תוכנה למחשב ואפליקציה לטלפון.

<span id="What_is_KDE_Connect?"></span>
== מה זה KDE Connect? ==

'''KDE Connect''' הוא פרויקט שמאפשר לכל המכשירים שלך לתקשר אחד עם השני. הנה כמה דברים ש-'''KDE Connect''' יכול לעשות:


* לקבל את ההתראות של הטלפון שלך במחשב ולהשיב להודעות
* לשלוט במוזיקה המתנגנת במחשב מהטלפון שלך
* להשתמש בטלפון שלך כשלט רחוק למחשב שלך
* להריץ פקודות מוגדרות מראש במחשב שלך מטלפונים מחוברים. לפרטים נוספים ראה את רשימת הפקודות לדוגמה.
* לבדוק את אחוז טעינת הסוללה של הטלפון שלך מהמחשב
* לגרום לטלפון שלך לצלצל כדי לעזור למצוא אותו
* לשתף קבצים ולינקים בין מכשירים
* לעיין בקבצים שבטלפון שלך מהמחשב שלך
* לשלוט בעוצמת הקול של המחשב באמצעות הטלפון שלך
* לשלוח SMS מהמחשב שלך

<span id="Installation"></span>
== התקנה ==

סביר להניח שתמצא את רכיב שולחן העבודה '''KDE Connect''' כחבילה במאגרי הפצת הלינוקס שלך. אם לא, אתה יכול לבקש מהמפיצים לארוז אותו.

למרות הטעות הנפוצה, אפשר להשתמש ב-'''KDE Connect''' בכל סביבות שולחנות העבודה. מכיוון שרוב המפתחים של '''KDE Connect''' משתמשים ב-Plasma, ייתכן שתכונה כלשהי תהיה פגומה או לא נגישה בסביבות שולחן עבודה אחרות. במקרה כזה, אנא [https://bugs.kde.org/enter_bug.cgi?product=kdeconnect דווח על באג].

ישנן מספר דרכים לשפר את חוויית השימוש ב-'''KDE Connect''' בשולחנות עבודה שאינם Plasma. אם אתה משתמש GNOME אולי תעדיף להשתמש ב [https://extensions.gnome.org/extension/1319/gsconnect/ GSConnect], הרחבה למעטפת של GNOME. שולחנות עבודה עם תמיכה ב-‏AppIndicator (Budgie, Cinnamon, ‏XDE, Pantheon, Unity) כבר כוללים את KDE Connect ומגיעים עם הקובץ הבינארי '''kdeconnect-indicator''', שניתן להגדיר להפעלה אוטומטית בכל סביבת שולחן עבודה.

את האפליקציה לאנדרואיד אפשר למצוא  גם ב [https://play.google.com/store/apps/details?id=org.kde.kdeconnect_tp Google Play] וגם בחנות החופשית והפתוחה [https://f-droid.org/repository/browse/?fdid=org.kde.kdeconnect_tp F-Droid].

את האפליקציה ל-iOS אפשר למצוא ב-[https://apps.apple.com/app/kde-connect/id1580245991 App Store הקניינית של אפל]. בנוסף, ניתן להוריד גרסת בדיקה מוקדמת של KDE Connect מ-[https://testflight.apple.com/join/vxCluwBF TestFlight]. אנא עיין ב-[https://invent.kde.org/network/kdeconnect-ios/-/blob/master/README.md iOS README] כדי לקבל מידע חשוב על חשיפת נתונים, מגבלות ידועות ומידע על דיווח באגים.

'''KDE Connect''' זמינה גם עבור SailfishOS ב [https://openrepos.net/content/r1tschy/sailfish-connect sailfish-connect] ואנחנו עובדים להביא אותה לטלפונים מבוססי לינוקס אחרים (Plasma Mobile ,PostmarketOS ועוד).

[https://kdeconnect.kde.org/download.html ראה את דף ההורדות של KDE Connect] לקישורי התקנה עבור פלטפורמות אחרות (כולל Windows ו-macOS).

<span id="Pairing_two_devices_together"></span>
== צימוד שני מכשירים יחד ==

ראשית, אתה צריך לפתוח את '''KDE Connect''' במחשב שלך ''וגם'' בטלפון. כעת אתה אמור להיות מסוגל לראות בכל אחד מהמסכים את שם המכשיר אליו אתה רוצה לבצע צימוד. אם זה לא עובד, ודא ששני המכשירים מחוברים לאותה רשת ושאינה קיימת חומת אש שחוסמת את שני המכשירים מלראות אחד את השני. ראה את הסעיף [[Special:myLanguage/KDEConnect#I_have_two_devices_running_KDE_Connect_on_the_the_network.2C_but_they_can.27t_see_each_other|פתרון בעיות]].

[[File:KDE_Connect_computer_sync.png|700px|center]]

[[File:KDE_Connect_android_sync.jpg|300px|center]]

כעת תוכל לבקש צימוד באחד משני המכשירים. המכשיר השני יציג בקשה לאשר את דרישת הצימוד. אשר את זה, ו-זהו! המכשירים שלך מוצמדים כעת.

While a typical configuration might include one computer and one phone, it's also possible to pair two computers instead.

== 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:KDEConnectRename.png|1000px|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.

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

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:KDEConnectMultimediaControlReceiverAndroid.png|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.

[[FIle:KDE_Connect_ping_android.jpg|center|300px|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===
''"Browse the remote device filesystem using SFTP."''

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

[[File:KDEConnectBrowse.png|1000px|center]]

[[File:KDEConnectViewBrowser.png|500px|center]]

===Ring My Phone===
''"Find your lost phone by making it play an alarm sound."''

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

[[File:KDEConnectRing.png|500px|center]]

===Run Commands===
''"Execute console commands directly."''

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]].
Some sample commands, such as suspend and lock screen, are also available. 

If your device supports Device Controls (Android 11+), KDE Connect will display configured commands there. You can then quickly control your remote device, such as locking the screen. See Google's documentation for more description of device controls: https://developer.android.com/develop/ui/views/device-control

[[File:20231023-KDE Connect Device Controls Screenshot Samsung.jpg|thumb|alt=Screenshot of the device controls pane on a Samsung device, showing two configured commands, "Suspend" and "Lock Screen". In each device control tool is the command it will execute, and a prompt which says "Tap to execute".|Screenshot of the device controls pane on a Samsung device|center]]

===Send Notifications===
''"Broadcast this computer's notifications, so they can be shown on other devices."''

This is pretty self-explanatory: notifications from your computer will show up on your phone.

You can configure if you want to send the notification description, the icons pertaining to the application and persistent or very important 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===
''"Receive and send files, URLs or plain text easily."''

This integrates your desktop and your browser so that you can right-click on files or links and send it immediately to your phone!

Files show the right-click option "Send to phone via KDEConnect" and will send the file directly, showing it among your notifications.

Links show the right-click option "Open on phone" and will automatically open your phone's default browser on the chosen website. Really handy!

When receiving files from your phone into your computer, they will go to your Downloads folder by default. If you wish, you can change that too.

===Telephone Integration===
''"Show notifications for incoming calls."''

Whenever you get a call on your phone, a notification telling you which number is calling appears. Paired with "Pause media during calls", you'll surely be able to answer readily and never lose a call!

===Virtual Input===
''"Use your phone as a touchpad and keyboard."''

With this enabled, by going to your phone app and selecting Remote input, a touch screen will immediately be available for you to control your computer mouse, similarly to a touchpad. One touch equals one click.

The keyboard icon in the upper right allows you to type on your phone and see the result on your computer too.

If you press the hamburger menu right by its side, you'll be able to send right and middle clicks.

===Presentation control===
It is possible to control presentations using the previous/next slide button. When the device is locked, you can use the volume up/down button to do that. You can also highlight something using the laserpointer. Just move your phone and the blue circle will follow! Using the hamburger menu, you can toggle fullscreen (F5) or quit the presentation (Esc).

== Permissions Explanations and Tutorial Videos ==

From time to time, Google will require video submissions to prove that we use permissions in ways which are allowed by Play Store policies. Those videos are gathered here for future reference, but also because they provide nice tutorials of how to use certain features, and are also useful to demonstrate permissions usage to a wider audience.

=== Android Mouse Receiver (Accessibility Permission) ===

In order to be a fake input device, Android requires that we take the Accessibility permission. The mouse receiver plugin is demonstrated in the following video.
{{#ev:youtube|PQ-Oubt4Rks}}

=== Other Permissions ===

This video demonstrates several KDE Connect features, in particular it demonstrates how KDE Connect uses certain privacy-impacting permissions, such as the SMS permissions.
{{#ev:youtube|QGHzXpX0vtk}}

== Missing or limited features on some platforms ==

Some platforms are missing some features due to technical limitations or other reasons. 

=== iOS ===

==== Missing ====

* Notification sync
* SMS
* Keeping connection alive when app is not on-screen
* Virtual Display

==== One way - only from iOS to desktop ====

* Remote Input
* Run Command
* Slideshow Remote
* Shared clipboard (limited, need to tap "push clipboard" on the app to push clipboard to the PC)

=== Android ===

==== Missing ====

* Virtual Display

==== One way - only from Android to desktop ====

* Run Command
* Slideshow Remote
* SMS (transfer messages to desktop and handle sending)
* Contacts

==== One way - only from desktop to Android ====

* SMS (retrieve from phone and dispatch send requests to phone)

== Troubleshooting ==
<span id="I have two devices running KDE Connect on the same network, but they can't see each other"></span>
=== I have two devices running KDE Connect on the same network, but they can't see each other ===

'''KDE Connect''' uses dynamic ports in the range 1714-1764 for UDP and TCP. So if you are behind a firewall, make sure to open this port range for both TCP and UDP. Otherwise, make sure your network is not blocking UDP broadcast packets.

Check that the process is listening on the network:

<syntaxhighlight lang="bash">
sudo netstat -tunelp | grep -i kdeconnect
</syntaxhighlight>

Are the ports open/blocked?

<syntaxhighlight lang="bash">
netcat -z -v <your-phones-ip> 1714-1764
</syntaxhighlight>

Example output:

Connection to <your -phones-ip> 1716 port [tcp/*] succeeded!

You also get lots of Connection refused, but you need 1 “succeeded”

If the network connection is not the problem, you might try starting from a clean configuration again:

<syntaxhighlight lang="bash">
killall kdeconnectd
mv ~/.config/kdeconnect ~/.config/kdeconnect.bak
</syntaxhighlight>

==== ufw ====

If your firewall is '''ufw''', you can open the necessary ports with:

<syntaxhighlight lang="bash">
sudo ufw allow 1714:1764/udp
sudo ufw allow 1714:1764/tcp
sudo ufw reload
</syntaxhighlight>

==== firewalld ====

If your firewall is '''firewalld''', you can open the necessary ports with:

<syntaxhighlight lang="bash">
sudo firewall-cmd --permanent --zone=public --add-service=kdeconnect
sudo firewall-cmd --reload
</syntaxhighlight>

==== Firewall Configuration (firewall-config) ====

Open Firewall Configuration (<code>firewall-config</code>). In '''Zones''' ➔ '''Services''', check the kde-connect service.

Make sure you choose the "Permanent" '''Configuration:''' option in the drop-down menu at the top, otherwise rebooting will discard your settings changes.

==== iptables ====

If your firewall is '''iptables''', you can open the necessary ports with:
 
<syntaxhighlight lang="bash">
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
</syntaxhighlight>

===  KDE Connect crashes or restarts when trying to pair with another device ===

Sometimes, a corrupt config file may cause '''KDE Connect''' to crash when trying to pair with a device. In that case, deleting the config  ~/.config/kdeconnect might help.

=== KDE Connect Android app crashes ===

If the KDE Connect Android app crashes, you might be able to get more information about the crash by using '''adb logcat'''.

Set up ADB using the [https://developer.android.com/studio/command-line/adb official instructions]

The following command should list all information relevant to your crash. Run '''adb logcat''' *before* triggering the crash.

<syntaxhighlight lang="bash">
adb logcat --pid=$(adb shell pidof -s org.kde.kdeconnect_tp)
</syntaxhighlight>

===  Can I run KDE Connect without a display server? ===

Yes, you can pass the command line argument <code>-platform offscreen</code> to the daemon (eg: <code>killall -9 kdeconnectd; /usr/lib/libexec/kdeconnectd -platform offscreen</code>)

=== GSConnect ===

'''GSConnect''' is an independent project which implements the '''KDE Connect''' protocol into GNOME and uses the same Android app. If you are running '''GSConnect''', please visit that project's [https://github.com/andyholmes/gnome-shell-extension-gsconnect/wiki GitHub page] first for support. If you and the '''GSConnect''' team determine the issue is the Android app or protocol, feel free to report those in the '''KDE Connect''' bug tracker.

===  My problem is not in this list :( ===

In case you find a bug and want to report it, you can do so in the [https://bugs.kde.org/enter_bug.cgi?product=kdeconnect KDE bug tracker].