Installation

Contents

• Dependencies
• Standard
• Install from Zip
• Install from Git
• Optional Features

Dependencies

GSConnect only requires and supports the latest, stable release of GNOME Shell. It does NOT depend on the KDE Connect desktop application and WILL NOT WORK with it installed.

For other Gtk based desktops, such as XFCE or Budgie, please see KDE Connect Indicator.

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. Click Accept in the notification

   

If you are having trouble connecting a device, please see the Help page.

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/[email protected]
   unzip -o [email protected] -d ~/.local/share/gnome-shell/extensions/[email protected]

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. You might need to install libglib2.0-dev and meson before:

git clone https://github.com/andyholmes/gnome-shell-extension-gsconnect.git
cd gnome-shell-extension-gsconnect/
meson _build .
ninja -C _build install-zip

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

Optional Features

Some optional features require additional software that must be installed by users.

Files Integration

Nautilus Extensions is REQUIRED to share files from Nautilus.

This is NOT REQUIRED to share files or browse remote filesystems.

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

Desktop Contacts

NOTE: The following applies to v31+

Evolution Data Server is REQUIRED to access contacts in GNOME Online Accounts, Evolution or the local address book.

This is NOT REQUIRED for the Contacts plugin to sync contacts from Android.

Distribution	Required Packages
Arch	evolution-data-server
Debian/Ubuntu	gir1.2-ebook-1.2, gir1.2-ebookcontacts-1.2, gir1.2-edataserver-1.2
Fedora	evolution-data-server
Gentoo	evolution-data-server
openSUSE	typelib-1_0-EBook-1_2, typelib-1_0-EBookContacts-1_2, typelib-1_0-EDataServer-1_2

Desktop Contacts (Legacy)

Folks is REQUIRED to access contacts in GNOME Online Accounts, Evolution or local address book.

This is NOT REQUIRED for the Contacts plugin to sync contacts from Android.

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