Skip to content

Help

Jump to bottom Edit New page
Terence edited this page Dec 26, 2019 · 60 revisions

Connecting an Android device

  1. Install KDE Connect Android from Google Play or F-droid

  2. Open the Android App and GSConnect Preferences

    GSConnect & KDE Connect Android

  3. Click Refresh in GSConnect preferences or the Android app

    Service Preferences

  4. Connect to GSConnect by IP

  5. Connect to Android by IP

    Connect to...

  6. Check your Firewall, Proxy, Router and VPN

    Open ports 1716-1764 for TCP and UDP and allow broadcasts.

  7. Open a New Issue

Generate Support Log

When a problem requires detailed information to debug, you may use the built-in function for generating a support log. The log will contain information about your desktop, GSConnect and detailed debugging messages.

Generate Support Log

  1. Select Generate Support Log in the menu

    A dialog will open and debug information will start being logged. Do not close the dialog yet.

  2. Take any steps necessary to reproduce the problem

    This is the most important step. You must use the functionality which is not working. For example, if you are having trouble connecting devices you must activate the Refresh action for both devices or errors will not be logged.

    Any errors or debug messages will be recorded during this period. You must leave the dialog open as long as necessary to reproduce the problem.

  3. Select Review Log in the dialog

    The default text editor will now open, allowing you to review the log. You should remove or censor any information you consider private before submitting this log.

File and Settings

WARNING: Clearing the settings in GSConnect or the KDE Connect Android App will rarely solve problems. It is far more likely that you will cause problems by doing so.

Where are the files and settings?

Cached data is stored in the user cache directory under gsconnect; usually ~/.cache/gsconnect/.

~/.cache/gsconnect/contacts.json
~/.cache/gsconnect/7b2c8d552e9043232d1466e28af55367

Cached data specific to a device is stored in a sub-directory. Plugin data is also stored in memory when in use, so you must disable a plugin before deleting its cache.

~/.cache/gsconnect/<device-id>/<plugin-name>.json
~/.cache/gsconnect/<device-id>/8ae5f579bd08e1167274e88aa79b37ea

Most settings are stored using GSettings and you can access it with dconf-editor at the path:

/org/gnome/shell/extensions/gsconnect/

The service certificate and private key are stored at the path

~/.config/gsconnect

How can I reset the settings?

To completely remove a device and all its settings, open the device preferences for that device and select Unpair from the menu. The device's stored data will be deleted, either immediately or (in the case of a connected device) when the connection is closed.

To completely remove GSConnect, all files and settings run following commands in order from the command-line:

gnome-shell-extension-tool -d [email protected]
rm -rf ~/.local/share/gnome-shell/extensions/[email protected]
rm -rf ~/.cache/gsconnect
rm -rf ~/.config/gsconnect
dconf reset -f /org/gnome/shell/extensions/gsconnect/

Common Problems

Contacts Don't Sync

Some phone models or apps seem to have trouble exporting contacts. Please see Issue #277 for more information.

There are two ways to sync your contacts, but neither are required. If you would like to sync your contacts from Gnome Online Accounts or Evolution, please see Desktop Contacts in the Optional Dependencies section. You should disable the Contacts plugin for any devices that you want to fallback to desktop contacts.

If either of these methods fail, GSConnect will try to gather contact information from incoming phone calls and messages.

SMS Messages Don't Sync

Some phone models (especially Samsung) and SMS apps (especially Signal) either don't use the standard Android database, encrypt messages or use proprietary methods for storage and access. Please see Issue #320 and KDE Connect Bug #401677 for more information.

Phones Reported

  • Samsung Galaxy S6, S7, S8
  • Motorola G6
  • Nokia 7 Plus
  • Huawei P10 Lite

Apps Reported

  • Samsung Messages
  • Signal

Mount Doesn't Work

  1. First see Generate Support Log

    If there are errors in the log related to mounting you should open a New Issue

  2. Set a location in the Android App

    You must configure at least on storage location in the Filesystem expose settings.

  3. Force Quit the Android App

    Sometimes the SFTP server in the Android App gets stuck after a number of connections. Force quitting the App from the App Info screen and re-opening it has been know to fix this.

  4. Debug the Android App

    If there are no mounting errors in the log, you have configured a storage location in the app and restarted the Android App there may be a bug in the App. Assuming you have adb setup you can run the following command in a terminal:

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

    If there is an error in the Android logcat, you should open a bug at bugs.kde.org in the android-application component.

Remote Input Doesn't Work

As of v28, remote mouse and keyboard input is only support on X11/Xorg or Wayland on distributions that support Mutter's RemoteDesktop interface.

Up to and including Ubuntu 19.10, remote input is NOT SUPPORTED in Wayland. This is not a bug in GSConnect.

Uncommon Problems

Interference with Other Equipment

Some users have reported that KDE Connect broadcasts (UDP Port 1716) can interfere with some equipment. The cause is unknown, but seems to only affect very very network connected devices such as PLCs and WiFi repeaters.

Firewall or iptables blocking port

Some users have reported that even when port 1714 to 1764 are open on firewall, iptables still need to be configured to allow connection. If that is the case, execute following commands in terminal

sudo iptables -I INPUT -i <your-interface> -p udp --dport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -I INPUT -i <your-interface> -p tcp --dport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -A OUTPUT -o <your-interface> -p tcp --sport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -A OUTPUT -o <your-interface> -p udp --sport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT

Where <your-interface> is your interface name without brackets, It is first name on nmcli or can be found using ifconfig -a or with inet addr or your network settings in GUI. Note: iptables is not persistent by itself, use iptables-save and iptables-restore (or iptables-persistent on debian/ubuntu based os) to save your rules between reboots.

Further information regarding similar issues can be found on KDEConnect comunity wiki

Detected Problems

These problems are automatically detected. Do not edit this section.

Network Error

GSConnect requires ports 1716-1764 for TCP and UDP. This error means another program is using those ports, usually KDE Connect (kdeconnectd).

  1. Check if KDE Connect is running

    If you have recently uninstalled KDE Connect the server may still be running.

    $ pidof kdeconnectd
18839
$ lsof -i UDP:1716
COMMAND     PID   USER   FD   TYPE  DEVICE SIZE/OFF NODE NAME
kdeconnec 18839 andrew   19u  IPv6 2394913      0t0  UDP *:1716

  2. Stop KDE Connect (kdeconnectd) if it is running

    You should also uninstall KDE Connect, since it will start each time you log into your session.

    $ killall -9 kdeconnectd

Proxy Error

This error means a connection failed to connect or authenticate with the network proxy. As a rule, neither GSConnect nor KDE Connect (#376187) will use the system proxy.

If you require GSConnect to open connections through the system proxy, please open a New Issue and be prepared to help test.

PulseAudio Error

GSConnect uses the PulseAudio bindings shipped with Gnome Shell for volume control features. This error means that GSConnect failed to find the required typelib (Gvc-1.0.typelib).

If you installed GSConnect from https://extensions.gnome.org or Zip file, please open a New Issue including your distribution and output of locate Gvc-1.0.typelib.

If you installed GSConnect from a distribution package, please file a bug with the package maintainer and reference the Packaging page.

Add a custom footer
Clone this wiki locally