Skip to content

Latest commit

 

History

History
157 lines (116 loc) · 6.73 KB

README.md

File metadata and controls

157 lines (116 loc) · 6.73 KB

KDE Connect implementation for Gnome Shell 3.24+

Extension Screenshot

ATTENTION

GSConnect is in the process of merging a rewrite. It is approaching maturity, but introduces major changes and has not been thoroughly tested. Support has has always been positive and your patience is appreciated.

Translators: translatable strings are not finalized and pull requests for translations will be considered work-in-progress until further notice. Subscribe to the Translations Discussion thread to receive updates.

For more information, see v13 Status.

Overview

NOTE: The current stable release (v12) does not support Gnome Shell 3.30

The KDE Connect project allows devices to securely share content such as notifications and files as well as interactive features such as SMS messaging and remote input. The KDE Connect team maintains cross-desktop, Android and Sailfish applications as well as an interface for KDE Plasma.

GSConnect is a complete implementation of KDE Connect especially for Gnome Shell with Nautilus, Chrome and Firefox integration. It is does not rely on the KDE Connect desktop application and will not work with it installed.

See Related Projects for a list of implementations.

Getting Started

The easiest way to get started is to install the extension from the official GNOME Shell Extensions website. The Wiki has a short guide for pairing your first device and a list of dependencies.

The Chrome extension and Firefox Add-on can be installed after Web Browser Integration has been enabled in the preferences.

To connect a mobile device, install the KDE Connect Android app from the Google Play Store or F-Droid, or the Sailfish app from OpenRepos.

Getting Help

Please see the FAQ before opening a New Issue to report a problem or request a new feature. There is also a IRC/Matrix channel available for general discussion:

The KDE Connect team has resources available for problems and contributions to their desktop, Android and Sailfish applications. Additionally, any protocol related discussion should take place upstream within the KDE Connect project.

Credits

Code and assistance from @getzze implementing Bluetooth support.

Code from python-folks by @hugosenari was adapted to provide libfolks integration.

Code from application-overview-tooltip by @RaphaelRochet was adapted to provide tooltips.

Code from kdeconnect-chrome-extension by @pdf was used as a template for the Web Extension.

Icons from the Numix project and Google's Material Design project are included to provide fallbacks and supplement icon themes.

Related Projects

Thanks

Most of all thank you to users, translators, bug reporters and contributors.

@albertvaka, @nicolasfella, @aleixpol, @mtijink, @sredman and others for creating KDE Connect.

@ptomato, @pwithnall, @nielsdg, @TingPing and others for help with Gnome APIs.

@didrocks and @jtojnar for help supporting distribution packaging.

@piotrdrag for help and advice with translation support.

The many blogs and news sites reporting with screenshots and user guides, especially those sharing GSConnect with non-English speaking users.