particle-os-modules/modules/gnome-extensions
2024-04-09 13:58:53 +02:00
..
gnome-extensions.sh feat: Copy icons if they exist & add better checks for gschema 2024-04-09 13:58:53 +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: "Almost all" extensions compatibility is true now. 2024-04-08 22:19:52 +02:00

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 end-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.
You can see gettext-domain of the extension by looking at the extension repo inside metadata.json
or by simply downloading the zip file from https://extensions.gnome.org & than looking at the download URL part after /extension-data/ & before .v%VERSION%.

You must assure that version of the extension is compatible with current Gnome version that your image is using.
You can easily see this information when downloading extension from https://extensions.gnome.org