KDEConnect

From KDE UserBase Wiki
Revision as of 11:13, 17 November 2022 by Claus chr (talk | contribs) (Importing a new version from external source)

Had er KDE Connect?

KDE Connect er et projekt, som lader alle dine enheder kommunikere med hinanden. Her er et par af det ting KDE Connect kan gøre:


  • Modtage bekendtgørelser fra din telefon på din computer og svare på beskeder.
  • Kontrollere afspilning af musik på din computer fra din telefon
  • Bruge din telefon som fjernkontrol til din computer
  • Køre forhåndsdefinerede kommandoer på din computer fra tilsluttede enheder. Se listen med eksempler på kommandoer for flere detaljer.
  • Tjek din telefons batteriniveau fra computeren
  • Ring til din telefon for at hjælpe med at finde den
  • Dele filer og links imellem enheder
  • Gennemse din telefon fra skrivebordet
  • Kontrollere computerens lydstyrke fra din telefon
  • Sende SMS'er fra din computer

Installation

Du kan højst sandsynligt finde KDE Connects skrivebordskomponent som en pakke i din distributions arkiver. Hvis ikke, så kan du bede dem om at tilføje den.

Fejlagtige forestillinger til trods kan du bruge KDE Connect i ethvert skrivebordsmiljø. Da de fleste af udviklerne bruger Plasme, så kan det være, at en funktion ikke virker eller er utilgængelig i et andet skrivebordsmiljø. I så fald beder vi dig indsende en fejlrapport. Der er mange måder at forbedre oplevelsen af KDE Connect i andre miljøer end Plasme. Hvis du bruger GNOME vil du måske foretrække GSConnect, som er en udvidelse til GNOME shell. Til miljøer, som understøtter AppIndicator (Budgie, Cinnamon, LXDE, Pantheon, Unity) findes indicator-kdeconnect.

Android-appen kan findes i Google Play Store og den fri og åbne appstore F-Droid.

Der var noget arbejde på en KDE Connect-klientapp til iOS i 2014 (se source code), som lå stille i nogle år indtil det blev genoptaget omkring 2018-19 med nogle rettelser og understøttelse af TLS. I 2021 blev der påbegyndt et større projekt med opdatering af meget af den gamle kodebase på nyere fundamenter med mulighed for fremtidig udvidelse.

KDE Connect findes også på sailfish-connect og vi arbejder på at bringe den til andre Linux-based telefoner (Plasma Mobile, PostmarketOS etc.)

Se KDE Connects downloadside

Oversigt

Dette er siden med dokumentation til KDE Connect. Du kan se fællesskabets side her: community.kde.org/KDEConnect, som forklarer, hvad KDE Connect er og hvordan man installerer det.

KDEConnect har to komponenter. Programmet til computeren og telefonapp'en.

Parring af to enheder

Først skal du åbne KDE Connect på din computer og telefon. Du skulle nu på hver skærm kunne se navnet på den enhed, som du vil parre med. Hvis det ikke virker, så sørg for, at de to enheder er forbundet til det samme netværk og at der ikke er en firewall, som blokerer for, at de to enheder kan se hinanden. Se afsnittet om fejlsøgning.

Du kan nu bede om, at få de to enheder parret. På den anden enhed dukker der et vindue op, hvor du bliver bedt om at acceptere parringen. Bekræft det; så er du færdig. Dine enheder er nu parrede.

Mens en typisk konfiguration vil omfatte en computer og en telefon, så er det også muligt at parre to computere.

Integration af browser

Plasma Browser Integration gør KDE Connect endnu stærkere. Den lader dig styre indhold fra fx Youtube og Netflix fra din telefon og sende browser-faneblade til din telefon. På trods af navnet kan den også bruges på andre skriveborde end Plasma.

Ændring af enheders navne

Du kan kun ændre en enheds navn på enheden selv. Hvis du vil ændre navnet på din computer skal du altså bruge skrivebordsprogrammet, og hvis du vil ændre navnet på din telefon eller tablet, så skal du ændre det i KDE Connect-appen. Når en enhed har fået ændret sit navn, så bliver dette automtisk synkroniseret til alle forbundne enheder.

Kør KDE Connect over OpenVPN

Der kan være mange grunde til at bruge KDE Connect over VPN. Måske er du væk hjemmefra og vil køre en kommando, eller måske er du tilsluttet et offentligt wifi-netværk, som ikke tillader enheder at kommunikere og du vil bruge enheden som fjernkontrol til at give en præsentation.

Opsætning af OpenVPN

Hvis du har din egen server med en IP-adresse, som kan tilgås udefra, så kan du selv opsætte OpenVPN. Det er ikke det nemmeste software at sætte op, men ved at følge en vejledning i opsætning som fx denne skulle du kunne klare det.

KDE Connect bruger UDP broadcast packets til at finde to enheder. For at tillade det, skal OpenVPN opsættes til bridging (TAP enhed). Hvis du bruger en tun-enhed kan du stadig forbinde manuelt med IP-adresse.

Hvis du vil leje en forhånds-konfigureret OpenVPN-service i stedet for at opsætte din egen, så skulle det fungere, men du skal tage hensyn til de samme overvejelser om server-indstillinger.

Når først serveren kører kan du bruge den officielle OpenVPN-klient til at forbinde computeren med serveren. Der er ingen officiel OpenVPN-klient til Android, men OpenVPN for Android-klienten fungerer godt: openvpn

Når begge enheder er forbundne, så test, at de kan kommunikere over VPN ved at foretage et netværks-ping imellem dem.

Indstil KDE Connect

Hvis din OpenVPN-instans er opsat til bridging, så skulle KDE Connect fungere ligesom på et lokalt netværk.

Hvis du bruger OpenVPN med en tun-enhed, så skal du manuelt tilføje din enhed ved dens IP-adresse. Når du så forbinder opev VPN skulle KDE Connect automatisk finde din enhed og ented forbinde til den eller være klar til parring.

Tilgængelige plugins

Batteriovervågning

"Vis din telefons batteri ved siden af dit computerbatteri."

Ved at aktivere dette vil KDE Connect-widgetet i panelets statusområde vise din telefons batteriniveau.

Udklipsholder

"Del udklipsholderen imellem enheder."

Med dette kan du nemt kopiere tekst fra din computer, sådan at den umiddelbart bliver tilgængelig til at indsætte på din telefon og vice versa. Dette fungerer dog ikke med billeder.

Auto-sync på Android 10+

Android 10 forhindrer apps i at tilgå udklipsholderen for at forhindre ondsindede apps i at tilgå dine data. Dette gør det ubekvemt at bruge udklipsholder-plugin'et i KDE Connect. \

Magisk-modul (kun som root)

Hvis du er root kan du bruge et Magisk-modul til atfjerne denne restriktion.

Log Reading

Hvis du har en version som indeholder bidraget edc655da5ac1eb5c3027c8556cc62037a1d4c5ac, så kan du aktivere tilladelsen READ_LOGS for at aktivere en måde at omgå udklipsholdersynkronisering.

Kør disse kommandoer:

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;

Hvordan virker det?

Med log reading aktiveret vil KDE Connect overvåge sin egen log. Hvis den ser en linje, som indikerer at den er blevet nægtet adgang til at læse fra udklipsholderen, så åbner den et usynligt vindue op i forgrunden, får fat i udklipsholderen og lukker vinduet.

Kontakter

"Synkroniser kontakter imellem desktoppen og den tilsluttede enhed"

Dette plugin synkroniserer automatisk kontakter i vcard-format fra din telefon til dit skrivebord.

Mens dette skrives går synkroniseringen kun den ene vej; data sendes fra Android-appen til skrivebordet, hvor det bruges i ethvet program, som bruger KPeople-biblioteket med KPeopleVCard-plugin'et som for eksempel KDE Connects SMS-app.

Placering af VCards

På ikk-Windows-platforme skrives kontaktkort til QStandardPaths::writableLocation(QStandardPaths::GenericDataLocation) + "/kpeoplevcard". Det kan være konfigureret anderledes på dit system, men bliver normalt omsat til ~/.local/share/kpeoplevcard.

Under Windows omsættes stien til %LocalAppData%.

Tilbagehold pauseskærm

"Tilbagehold pauseskærmen når enhed er tilsluttet."

Dette sikrer, at din pauseskærm ikke kører mens din enhed er tilsluttet.

Modtager til multimediekontrol

"Fjernbetjening til musik og videoer."

Med denne funktion kan du kontrollere musik og videoer fra telefonen med pause/spil, forrige/næste, 5 s frem/tilbage. Du kan også styre, hvilken medieafspiller du vil kontrollere samt programmets og systemets lydstyrke.

Modtager til multimediekontrol med KDE Connect på Android
Modtager til multimediekontrol med KDE Connect på Android

Sæt medier på pause under opkald

"Sæt musik/videoer på pause under opkald."

Sæt musik/videoer på pause under et opkald. Denne funktion kan være meget nyttig når den kombineres med Plasma-browser-integration. Når du for eksempel modtager en opringning mens du lytter til musik på Peeertube eller Youtube, vil videoen blive sat på pause.

Du kan indstille denne funktion til først at sætte på pause, når du tager telefonen eller med det samme den begynder at ringe. Du kan også vælge om du vil sætte medieafspilning på pause og/eller forhindre systemlyde.

Ping

"Send og modtag ping."

Dette bruges til at teste din forbindelse til en given enhed. Når du vælger denne funktion, så dukker der en besked med "Ping!" op på den modtagende enhed.

På dit skrivebord kan du sende et ping fra KDEConnects indstillinger eller fra statusområde-widget'et.

På din telefon kan du sende et ping fra hamburgermenuen øverst til højre i KDE Connect-appen.

Send et ping til din computer på android
Send et ping til din computer på android

Modtag bekendtgørelser

"Vis enhedens bekendtgørelser på denne computer og hold dem synkroniseret."

Dette holder dig opdateret med, hvad der sker på din telefon! Enhver bekendtgørelse du modtager på telefonen vis blive vist på din computer. Nogle bekendtgørelser, blandt andet den fra Instant Messaging (IM) som Telegram, kan du besvare med det samme fra computerens bekendtgørelse.

Browser til eksternt filsystem

"Gennemse den eksterne enheds filsystem med SFTP."

Dette lader dig tilgå din telefons lager. Når det er aktiveret dukker der en enhed op i Dolphin, som du kan bruge til at gennemse dit eksterne lager.

Ring min tlefon op

"Find din forsvundne telefon ved at få den ril at afspille en alarm."

Dette kan også bruges til at teste forbindelsen til en enhed, og ved at ringe til din telefon kan du hurtigt finde dens placering!

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 userbase. A set of useful commands can also be found here. Some sample commands, such as suspend and lock screen, are also available.

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

Troubleshooting

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:

sudo netstat -tunelp | grep -i kdeconnect

Are the ports open/blocked?

netcat -z -v <your-phones-ip> 1714-1764

Example output:

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

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

ufw

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

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:

sudo firewall-cmd --permanent --zone=public --add-service=kdeconnect
sudo firewall-cmd --reload

Firewall Configuration (firewall-config)

Open Firewall Configuration (firewall-config). In ZonesServices, 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:

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

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 official instructions

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

adb logcat --pid=$(adb shell pidof -s org.kde.kdeconnect_tp)

Can I run KDE Connect without a display server?

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

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 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 KDE bug tracker.