Installation

Most users should follow the Basic instructions to setup GSConnect. More advanced users can refer to the instructions for installing from ZIP or Git.

• Basic
• Installing from ZIP
• Building from Git
• Dependencies

Basic

1. Install GSConnect from the GNOME Shell Extensions website

   

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

   

3. Open the App and tap ⊕ Pair new device in the sidebar

   

4. Swipe down to refresh and you should see your device

   

5. Tap on GSConnect and then tap REQUEST PAIRING

   

6. Complete the pairing process by clicking Accept in the notification

   

Your Android device is now paired to your desktop and you can now configure your device and plugins.

If you are having trouble connecting a device, please see Troubleshooting before opening a New Issue.

Installing from Zip

As of 3.26, Gnome Tweaks can no longer install extensions from Zip files. You can install the latest stable release from Zip using the following commands:

mkdir -p ~/.local/share/gnome-shell/extensions
unzip -o gsconnect.andyholmes.github.io.zip -d ~/.local/share/gnome-shell/extensions/gsconnect@andyholmes.github.io

• Xorg users can restart Gnome Shell using Alt + F2 then restart
• Wayland users must log out and log back in.

Building from Git

The master branch of this repository is usually fairly stable but may contain some features still in development or unpolished user interface elements. If that's okay, you can build and install from git with Meson:

$ git clone https://github.com/andyholmes/gnome-shell-extension-gsconnect.git
$ meson gnome-shell-extension-gsconnect/ _build
$ mkdir -p ~/.local/share/gnome-shell/extensions
$ ninja -C _build install-zip

If you are interested in packaging GSConnect for your distribution, please see the Packaging page. It can be built for system installation using the default install target:

meson --prefix /usr --libdir lib/ gnome-shell-extension-gsconnect/ _build
ninja -C _build install

Dependencies

This extension does not depend on the KDE Connect desktop application

v12 requires gnome-shell 3.24-3.28, while v13 will require gnome-shell >= 3.28. Some plugin features require additional software to be installed. As of v13, GSConnect can install dependencies using PackageKit:

• Remote Filesystems require sshfs to be mounted and accessed. This is required by the SFTP plugin.

  Distribution	Required Packages
  Arch	sshfs
  Debian/Ubuntu	sshfs
  Fedora	fuse-sshfs
  Gentoo	sshfs
  openSUSE	sshfs

• Sound Effects require libcanberra and GSound can be used if available. This is required by the Find My Phone plugin.

  Distribution	Required Packages	Optional Packages
  Arch	libcanberra	gsound
  Debian/Ubuntu	gnome-session-canberra	gir1.2-gsound-1.0
  Fedora	libcanberra-gtk3	gsound
  Gentoo	libcanberra	gsound
  openSUSE	canberra-gtk-play	typelib-1_0-GSound

• Contacts Integration requires Folks to access desktop contacts (Gnome Online Accounts, Evolution, local address book). This can be used by the Telephony and Notifications plugins.

  Distribution	Required Packages
  Arch	folks
  Debian/Ubuntu	libglib2.0-dev, gir1.2-folks-0.6, libfolks-eds25
  Fedora	folks
  Gentoo	folks
  openSUSE	typelib-1_0-FolksEds-0_6

• Files Integration requires Nautilus Extensions to modify the context menu. This can be used to share files from Nautilus.

  Distribution	Required Packages
  Arch	python-nautilus
  Debian/Ubuntu	python-nautilus, gir1.2-nautilus-3.0
  Fedora	nautilus-python, nautilus-extensions
  Gentoo	nautilus-python
  openSUSE	python-nautilus