Skip to content
Frank Dana edited this page Jan 25, 2019 · 17 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

Once the dialog opens, you should take any steps necessary to reproduce the problem. You may leave the dialog open as long as necessary to gather the required information.

When you click Review Log the contents will be opened in the default text editor. Before you submit this log you should remove or censor any information you consider private.

File and Settings

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 it's settings, use the button in the Advanced page of the device preferences.

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

gnome-shell-extension-tool -d gsconnect@andyholmes.github.io
rm -rf ~/.local/share/gnome-shell/extensions/gsconnect@andyholmes.github.io
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 S8
  • Motorola G6
  • Nokia 7 Plus
  • Huawei P10 Lite

Apps Reported

  • Samsung Messages
  • Signal

Remote Input Doesn't Work

Remote mouse and keyboard is only available for X11/Xorg sessions and will not function in Wayland (see Wayland + Accessibility). You must install Caribou to support Unicode characters and keyboard modifiers (Alt, Shift, etc).

It has been reported that Remote Input will not work if GNOME Shell is not started by GDM. A common example is starting GNOME Shell using startx. In this case, your logs may contain messages such as Keystring synthesis failure, string=a.

Files and directories open in the wrong application

Sometimes the wrong application is registered as the default handler for the inode/directory mime-type. You can set the correct handler by running the following command in a terminal as a regular user:

$ xdg-mime default org.gnome.Nautilus.desktop inode/directory

org.gnome.Nautilus.desktop can be replaced with another file manager or application if desired.

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.

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.

You can’t perform that action at this time.