particle-os/particle-os-modules
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
particle-os-modules/modules/gnome-extensions
History
fiftydinar 2f711abb2a
docs: Change title to be clearer & to avoid gettext-domain & module-input terms 
Co-authored-by: xyny <60004820+xynydev@users.noreply.github.com>
2024-04-10 18:29:21 +02:00
..
gnome-extensions.sh fix: Revert icons installation 2024-04-09 14:21:06 +02:00
module.yml fix: Get rid of gettext-domain key, install key is already sufficient 2024-04-09 09:09:43 +02:00
README.md docs: Change title to be clearer & to avoid gettext-domain & module-input terms 2024-04-10 18:29:21 +02:00

README.md

gnome-extensions

The gnome-extensions module can be used to install Gnome extensions inside system directory.

This module is universally compatible with all distributions which ship Gnome, as it's not tied to specific distribution packaging format for installing extensions.

Almost all Gnome extensions are compatible for installation.
Only rare intervention that might be needed is for extensions which require some additional system dependencies, like Pano.

Thanks to https://extensions.gnome.org which provides releases of extensions as zips, it is very easy to maintain this module configuration.
The only maintenance is to bump the extension version when new Fedora/Gnome releases (around every 6 months).

What does this module do?

  • It parses the gettext-domain that you inputted, along with the extension version
  • It downloads the extension directly from https://extensions.gnome.org
  • Downloaded extension archive is then extracted to temporary directory
  • All of its extracted files are copied to the appropriate final directories
    (/usr/share/gnome-shell/extensions, /usr/share/glib-2.0/schemas, & /usr/share/locale)

Usage

To use this module, you need to input gettext-domain of the extension without @ symbol + the version of the extension in .v%VERSION% format in module recipe.
But for some extensions, .v%VERSION% is parsed as the version of package in incremental numbering, instead of extension version in https://extensions.gnome.org URL.
So to be sure that you got the correct module input, follow the steps below.

How to install extensions using the module:

  1. Go to https://extensions.gnome.org
  2. Search for the extension that you want to install and open its extension page
  3. Select the correct GNOME shell version & extension version from the dropdown
    • The command gnome-shell --version can be used to get the GNOME version of a running system.
  4. When the download dialog for the extension comes up, copy everything but the .shell-extension.zip suffix from the filename into the install: array in this module's configuration.