Main • Installation • Translations • RoadMap • ReleaseNotes |
GNOME Shell integration for Chrome Installation Guide
Contents
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.
For Opera you should manually install extension from Opera Addons site. Please note that Opera is supported since connector version 7.
Arch Linux
Package is available in the official repositories: chrome-gnome-shell.
To install package type:
$ sudo pacman -S chrome-gnome-shell
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
FreeBSD is supported since version 10 of browser extension.
Cmake installation
First of all make sure following dependencies are installed:
- Build time
- Runtime
Then clone source repository or download latest release tarball. To make git clone type:
$ git clone git://git.gnome.org/chrome-gnome-shell
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.
- Create build folder and go to it:
$ mkdir build $ cd build
- Run cmake to create makefiles:
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DBUILD_EXTENSION=OFF ../
- Install connector:
$ sudo make install
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 using Firefox and getting high CPU usage and crash when closing browser.
Resolution:
It is a Firefox bug 1349874. You may vote for this bug to get it fixed faster.