Skip to content

Commit

Permalink
Added GNOME Shell Extensions Desktop article. (#2141)
Browse files Browse the repository at this point in the history
  • Loading branch information
j0eybrinkman authored Jun 28, 2024
1 parent f17105c commit 4a0011a
Show file tree
Hide file tree
Showing 3 changed files with 76 additions and 0 deletions.
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.
Binary file not shown.
Binary file not shown.

0 comments on commit 4a0011a

Please sign in to comment.