Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
76 changes: 76 additions & 0 deletions docs/desktop/gnome/gnome-extensions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
---
title: GNOME Shell Extensions
author: Joseph Brinkman
tested with: 9.4
tags:
- desktop
- gnome
---

## Introduction

From the [GNOME website](https://extensions.gnome.org/about/){:target="_blank"}:

"GNOME Shell provides core user interface functions for GNOME, like switching to windows and launching applications. User interface elements provided by GNOME Shell include the Panel at the top of the screen, the Activities Overview, and Message Tray at the bottom of the screen."

GNOME Shell extensions are small pieces of code written by third party developers that modify the way GNOME works. (If you are familiar with Chrome Extensions or Firefox Addons, GNOME Shell extensions are similar to them.) You can find and install GNOME Shell extensions using this website.

Since extensions are created outside of the normal GNOME design and development process, they are supported by their authors, rather than by the GNOME community. Some features first implemented as extensions might find their way into future versions of GNOME."

## Assumptions

* A Rocky Linux Workstation or Server with GUI installation that uses GNOME.

## Install GNOME extensions

GNOME Extensions is available from the "appstream" repository, requiring no additional repository configuration. Install with:

```bash
sudo dnf install gnome-extensions
```

Installation includes all needed dependencies.

## Install Browser Integration

Gnome Extensions has a software library available through their website gnome.extensions.org where you can install extensions right off their website. To achieve this a connection needs to be facilitated between your browser and gnome-extensions.

```bash
sudo dnf install chrome-gnome-shell
```

[installation guide](https://gnome.pages.gitlab.gnome.org/gnome-browser-integration/pages/installation-guide.html){target="_blank"}

## Determining Gnome Shell Version

The browser extension used to faciliate extensions installations from extensions.gnome.org should automatically detect the version of GNOME shell your system is currently running.

If you wish to perform a local install you will need to download the extension with the correct GNOME shell version.

```bash
gnome-shell --version
```

## Installing an Extension

For this example we will install the popular dash to dock extension.

1. Go to [dash to dock extension webpage](https://extensions.gnome.org/extension/307/dash-to-dock/){target="_blank"}
2. Toggle extension from "off" to "on"
![Toggle extension](images/gnome_extensions_images/gnome-shell-extensions-toggle-btn.webp)
3. When prompted to install the extension, click "yes"

## Managing Installed Extensions

GNOME extensions can not only be installed on gnome.extensions.org but also managed.

To manage your GNOME extensions, first go to https://extensions.gnome.org/local/

![Manage GNOME extensions](images/gnome_extensions_images/gnome-shell-installed-extensions.webp)

On this page you will find a list of installed extensions. You can toggle each of these on or off. You can also configure the shell settings by using the toggle button on either of the two available menu options "Disable all extensions" "Disable version validation".


## Conclusion

GNOME Extensions is a good tool for adding additional functionality and customizing your GNOME desktop environment.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.