diff --git a/docs/desktop/gnome/gnome-extensions.md b/docs/desktop/gnome/gnome-extensions.md new file mode 100644 index 0000000000..06f1eaed45 --- /dev/null +++ b/docs/desktop/gnome/gnome-extensions.md @@ -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. \ No newline at end of file diff --git a/docs/desktop/gnome/images/gnome_extensions_images/gnome-shell-extensions-toggle-btn.webp b/docs/desktop/gnome/images/gnome_extensions_images/gnome-shell-extensions-toggle-btn.webp new file mode 100644 index 0000000000..23c808d4b8 Binary files /dev/null and b/docs/desktop/gnome/images/gnome_extensions_images/gnome-shell-extensions-toggle-btn.webp differ diff --git a/docs/desktop/gnome/images/gnome_extensions_images/gnome-shell-installed-extensions.webp b/docs/desktop/gnome/images/gnome_extensions_images/gnome-shell-installed-extensions.webp new file mode 100644 index 0000000000..c0a127a7f8 Binary files /dev/null and b/docs/desktop/gnome/images/gnome_extensions_images/gnome-shell-installed-extensions.webp differ