Skip to content

pdf/kdeconnect-chrome-extension

Repository files navigation

KDE Connect Browser Extension License-MIT

A Chrome (and compatible) browser extension to send pages and content from your browser to connected KDE Connect devices, via browser action or context menu.

Update: As of v0.1.0 the browser extension and installer now also supports Firefox.

Installation

This extension relies on a Native Messaging Host to communicate with KDE Connect devices. As a result, installation is a little more involved than stand-alone extensions.

  1. Download the latest release of the host application.

  2. Close your browser

  3. Extract the host application anywhere, open a terminal and run the install command:

    ./kdeconnect-chrome-extension -install

    It will prompt you to select the browser you wish to install for, use Space to select your browser(s), and Enter to accept. The installer will deploy itself to the appropriate location for the selected browser.

    If prompted for an extension ID, just hit Enter to continue, unless you are a developer.

    If you wish to deploy system-wide, rather than for the current user, simply run as root:

    sudo ./kdeconnect-chrome-extension -install
  4. Start your browser.

  5. Install the extension from the Chome Web Store or Mozilla Add-ons.

  6. Done

Currently only Linux amd64 builds are produced, however please file an issue if you would like other operating systems or architectures, as the host should run anywhere.

Upgrading

Updates to the extension will be delivered automatically via the Chrome Store. If you are prompted to upgrade the host application, follow these instructions.

  1. Download the latest release of the host application.

  2. Close your browser

  3. Extract the host application anywhere, open a terminal and run the install command:

    ./kdeconnect-chrome-extension -install

    It will prompt you to select the browser you wish to install for, use Space to select your browser(s), and Enter to accept. The installer will deploy itself to the appropriate location for the selected browser.

    If prompted for an extension ID, just hit Enter to continue, unless you are a developer.

    If you wish to deploy system-wide, rather than for the current user, simply run as root:

    sudo ./kdeconnect-chrome-extension -install
  4. Start your browser.

  5. Done

Building the Host from source

  1. Install the Go toolchain v1.7+

  2. Install glide:

    go get -u github.com/Masterminds/glide
  3. Obtain the source:

    git clone https://github.com/pdf/kdeconnect-chrome-extension.git
    cd kdeconnect-chrome-extension
  4. Install dependecies:

    glide install
  5. Install the binary:

    go install

You will find the binary in ${GOPATH}/bin/kdeconnect-chrome-extension if $GOPATH is set, or ${HOME}/go/bin/kdeconnect-chrome-extension for Go v1.8+ without $GOPATH.