Installation

---

title: Installation

Contents

• Standard
• Install from Zip
• Install from Git
• Dependencies

Standard

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

   

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

Install from Zip

1. Download the Latest Release

   The GNOME Extensions website reviews all submissions and often distributes an older version.

2. Extract the extension

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

3. Restart Gnome Shell

   • X11/Xorg: Alt + F2 then restart
   • Wayland: Log out and log in.

Install from Git

You can build or 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

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

Please see the Packaging page if you are interested in packaging GSConnect for a distribution.

Dependencies

This extension does not depend on the KDE Connect desktop application

As of v13 GSConnect requires gnome-shell >= 3.28. Some features require additional software that can be installed using PackageKit, if supported.

• 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

• Extended Keyboard Support (not yet in released version) requires Caribou for modifiers (Alt, Ctrl, Super, etc) and Unicode. This is used by the Mousepad plugin when simulating local keyboard events.

  Distribution	Required Packages
  Arch	caribou
  Debian/Ubuntu	gir1.2-caribou-1.0
  Fedora	caribou
  Gentoo	caribou
  openSUSE	typelib-1_0-Caribou-1_0

• Desktop Contacts 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	python2-nautilus, nautilus-extensions
  Gentoo	nautilus-python
  openSUSE	python-nautilus