nixpkgs/pkgs/desktops/gnome/extensions
piegames b642ac7b70
gnome: Package all the GNOME extensions
An automatic way to do this that scales up and requires little manual intervention is really needed. It works by scraping extensions.gnome.org with a python script, that writes all relevant information into the `extensions.json`. Every attribute of besaid file can be built into a package using `buildShellExtension`.

Extensions are grouped by GNOME Shell version for practical reasons. Only extensions for GNOME 40 and 3.38 were added, as we don't support legacy GNOME versions.
The extensions are exposed as an attrset, `pkgs.gnome40Extensions` and `pkgs.gnome38Extensions` respectively. The package name of each extensions is generated automatically from its UUID.

The attribute `pkgs.gnomeExtensions` contains the officially packaged and supported extensions set. It contains all the automatically packaged extensions for the current GNOME Shell version, which are overwritten by manually packaged ones where needed. Unlike gnomeXYExtensions, the names are not UUIDs, but automatically generated human-friendly names. Naming collisions – which are tracked in collisions.json – need to be manually resolved in the `extensionRenames` attrset.
2021-05-21 23:10:12 +02:00
..
appindicator gnomeExtensions.appindicator: 36 -> 37 2021-05-09 01:32:36 +02:00
arcmenu gnomeExtensions.arcmenu: 5 -> 10 2021-05-09 01:39:07 +02:00
caffeine gnomeExtensions.caffeine: 37 -> 38 2021-05-14 09:26:01 +02:00
chrome-gnome-shell
clipboard-indicator gnomeExtensions.clipboard-indicator: 37 -> 38 2021-05-16 00:43:18 +02:00
clock-override
dash-to-dock
dash-to-panel
disable-unredirect
draw-on-your-screen
drop-down-terminal
dynamic-panel-transparency gnomeExtensions.dynamic-panel-transparency: 35 -> unstable-2021-03-04 2021-05-17 06:16:01 +02:00
EasyScreenCast
emoji-selector
freon
fuzzy-app-search gnomeExtensions.fuzzy-app-search: 4 -> 4.0.1 2021-05-19 17:12:53 +02:00
gsconnect
hot-edge
icon-hider
impatience
material-shell
mpris-indicator-button
night-theme-switcher
no-title-bar
noannoyance
paperwm
pidgin-im-integration
remove-dropdown-arrows
sound-output-device-chooser gnomeExtensions.sound-output-device-chooser: 35 -> 38 2021-05-15 01:58:25 +02:00
system-monitor gnomeExtensions.system-monitor: unstable-2021-04-08 -> unstable-2021-05-04 2021-05-15 16:10:29 +02:00
taskwhisperer
tilingnome
timepp
topicons-plus
unite
window-corner-preview
window-is-ready-remover
workspace-matrix
buildGnomeExtension.nix gnome: Package all the GNOME extensions 2021-05-21 23:10:12 +02:00
collisions.json gnome: Package all the GNOME extensions 2021-05-21 23:10:12 +02:00
default.nix gnome: Package all the GNOME extensions 2021-05-21 23:10:12 +02:00
extensionRenames.nix gnome: Package all the GNOME extensions 2021-05-21 23:10:12 +02:00
extensions.json gnome: Package all the GNOME extensions 2021-05-21 23:10:12 +02:00
manuallyPackaged.nix gnome: Package all the GNOME extensions 2021-05-21 23:10:12 +02:00
README.md gnome: Package all the GNOME extensions 2021-05-21 23:10:12 +02:00
update-extensions.py gnome: Package all the GNOME extensions 2021-05-21 23:10:12 +02:00

GNOME Shell extensions

All extensions are packaged automatically. They can be found in the pkgs.gnomeXYExtensions for XY being a GNOME version. The package names are the extensions UUID, which can be a bit unwieldy to use. pkgs.gnomeExtensions is a set of manually curated extensions that match the current gnome.gnome-shell versions. Their name is human-friendly, compared to the other extensions sets. Some of its extensions are manually packaged.

Automatically packaged extensions

The actual packages are created by buildGnomeExtensions.nix, provided the correct arguments are fed into it. The important extension data is stored in extensions.json, one line/item per extension. That file is generated by running update-extensions.py. Furthermore, the automatic generated names are dumped in collisions.json for manual inspection. extensionRenames.nix contains provides new names for all extensions that collide.

Extensions updates

For everyday updates,

  1. Run update-extensions.py.
  2. Update extensionRenames.nix according to the comment at the top.

For GNOME updates,

  1. Add a new gnomeXYExtensions set
  2. Remove old ones for GNOME versions we dont want to support any more
  3. Update supported_versions in ./update-extensions.py and re-run it
  4. Change gnomeExtensions to the new version
  5. Update ./extensionsRenames.nix accordingly

Manually packaged extensions

Manually packaged extensions overwrite some of the automatically packaged ones in pkgs.gnomeExtensions. They are listed in manuallyPackaged.nix, every extension has its own sub-folder.