GNOME Shell browser integration Installation Guide

chrome-gnome-shell and gnome-browser-connector

Please note that chrome-gnome-shell package is now renamed to gnome-browser-connector.

The latest version of chrome-gnome-shell is 10 and the first version of gnome-browser-connector is 42.0

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 the browser's web store and native connector using cmake.

For Chrome-based browsers install the extension using then Chrome Web Store.

For Firefox you should manually install extension from Mozilla Add-ons 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): gnome-browser-connector.

To install package type:

$ pacman -Sy gnome-browser-connector

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 36 and newer: gnome-browser-connector.

To install it type:

# dnf install gnome-browser-connector

Gentoo Linux

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

# emerge -av gnome-extra/gnome-browser-connector

Ubuntu Linux

Package is available in Ubuntu 23.04 and newer: gnome-browser-connector

To install package type:

$ sudo apt-get install gnome-browser-connector

With older versions use: chrome-gnome-shell

To install package type:

$ sudo apt-get install chrome-gnome-shell


FreeBSD is supported since version 10 of browser extension.

Meson 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 

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

  1. Run meson to build the project into 'builddir' directory
    $ meson --prefix=/usr builddir
  2. Install the files into /usr (administrative privileges required)
    # meson install -C builddir



  • 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 getting information message about missing "v6" api.


  • You need to update gnome-browser-connector to at least version 42.0

Projects/GnomeShellIntegration/Installation (last edited 2024-02-25 07:00:47 by YuriKonotopov)