GNOME Shell browser integration Installation Guide

Distro packages

The easiest way to install extension and connector is use your distro's favorite package manager.

If there is no package in your distro you can install extension via Chrome web store and native connector using cmake.

For Firefox you should manually install extension from Mozilla Addons site. Please note that Firefox is supported since connector version 8.

Opera was supported since connector version 7 up to version 10.1. However extension was deactivated at Opera addons website without any technical explanation.

Arch Linux

Package is available in the Arch Linux User Repository (AUR): chrome-gnome-shell.

To install package type:

$ git clone
$ cd chrome-gnome-shell
$ makepkg -si

Debian Linux

Package is available in Stable: chrome-gnome-shell.

To install package type:

$ sudo apt-get install chrome-gnome-shell

Fedora Linux

Package is available in Fedora 26 and newer: chrome-gnome-shell.

To install it type:

# dnf install chrome-gnome-shell

With older versions use Copr region51/chrome-gnome-shell:

# dnf copr enable region51/chrome-gnome-shell
# dnf install chrome-gnome-shell

Gentoo Linux

Ebuild is available in main tree. Just type as root user:

# emerge -av gnome-extra/chrome-gnome-shell

Ubuntu Linux

Package is available in Universe repositories

To install package type:

$ sudo apt-get install chrome-gnome-shell


FreeBSD is supported since version 10 of browser extension.

Cmake installation

First of all make sure following dependencies are installed:

Then clone source repository or download latest release tarball. To make git clone type:

$ git clone

Web extension sources located in "extension" folder. Refer Google Chrome documentation for information about installation of unpacked extension.

All commands must be issued from the root of cloned repository.

  1. Create build folder and go to it:
    $ mkdir build
    $ cd build
  2. Run cmake to create makefiles:
  3. Install connector:
    $ sudo make install



  • You had uninstalled native connector package. Web extension still installed in browser and you can not uninstall it because it "installed by enterprise policy".


  • Your package manager did not uninstalled policy files. You should remove them manually:
    # rm /etc/opt/chrome/policies/managed/chrome-gnome-shell.json
    # rm /etc/chromium/policies/managed/chrome-gnome-shell.json
    If you had installed native connector via package manager you also should report this issue to package maintainer.


  • You are using Firefox and getting high CPU usage and crash when closing browser.


Projects/GnomeShellIntegration/Installation (last edited 2022-06-23 08:54:52 by YuriKonotopov)