Skip to content
This repository has been archived by the owner on Mar 11, 2018. It is now read-only.

Installation

Andy Holmes edited this page Aug 25, 2017 · 12 revisions

The extension is now available on the official extension website! The latest stable release can always be found in the releases page.

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-mconnect.git
meson gnome-shell-extension-mconnect/ build
cd build
ninja install-zip

Dependencies

The extension is tested with Gnome Shell 3.24.x and has been reported working on 3.18.x. Other recent versions may also work; please report your results. In order to use this extension, you must also install either KDE Connect or MConnect.

For dependencies required for optional features, please see the Nautilus Integration and SMS pages in the Wiki.

KDE Connect

KDE Connect is the most supported backend, but will require about ~500MB of KDE dependencies for most Gnome Shell users. You should install KDE Connect through normal, stable distribution channels - current builds from git are known to contain some DBus API breaks and are not supported.

MConnect

As of August 2017, MConnect is in an early stage of development. If you have experience with Vala, consider contributing to the project. Currently MConnect supports:

  • Pairing and unpairing with devices
  • Sending and receiving notifications (automatically handled by MConnect)
  • Monitoring battery level and charging state

MConnect support relies on the dbus-support branch and must be built from git. See the repository for dependencies.

git clone -b bboozzoo/dbus-support https://github.com/bboozzoo/mconnect.git
cd mconnect
autoreconf -if 
./configure --prefix=/usr
make

Once you have run make you may install it cleanly as a package if checkinstall is available:

sudo checkinstall --type=<slackware|rpm|debian>

If you have installed MConnect as a package or it is in your PATH, it can either be started from the User Menu or the extension can be configured to start it automatically. Otherwise you may run MConnect from the build directory:

./mconnect -d

Device Mounting

Mounting devices in KDE Connect is known to contain bugs, while mounting devices in MConnect is not yet supported.

Users of some distributions, Arch-based in particular, have reported that sshfs is not marked as a dependancy for KDE Connect and must be installed manually.

Clone this wiki locally