GNOME Shell browser integration Installation Guide
Contents
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
FreeBSD is supported since version 10 of browser extension.
Meson installation
First of all make sure following dependencies are installed:
- Build time
- Python 3.8+ (also runtime dependency)
- Meson
- Runtime
- DBus
Then clone source repository or download latest release tarball. To make git clone type:
$ git clone https://gitlab.gnome.org/nE0sIghT/gnome-browser-connector.git
All commands must be issued from the root of cloned repository.
- Run meson to build the project into 'builddir' directory
$ meson --prefix=/usr builddir
- Install the files into /usr (administrative privileges required)
# meson install -C builddir
Troubleshooting
Problem:
- You had uninstalled native connector package. Web extension still installed in browser and you can not uninstall it because it "installed by enterprise policy".
Resolution:
- 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.
Problem:
- You are getting information message about missing "v6" api.
Resolution:
- You need to update gnome-browser-connector to at least version 42.0