Alphabetical App Grid GNOME Extension

• Alphabetically order GNOME's app grid and folders
  • Supports GNOME 45+
• Get the extension from here
• This project is licensed under GPL 3.0
• Any donations are greatly appreciated :)

Older versions:

• Support for older versions of GNOME can be found in branches
• Find the name of the branch thgat supports the target version, and install from there
• Alternatively, you can just use an older release or tag to install from

Install the extension from releases:

• Run gnome-extensions install "[email protected]" --force
• Alternatively:
  • Extract the zip to ~/.local/share/gnome-shell/extensions/AlphabeticalAppGrid@stuarthayhurst/
  • Then run glib-compile-schemas ~/.local/share/gnome-shell/extensions/AlphabeticalAppGrid@stuarthayhurst/schemas/
• Log out and back in to restart GNOME
• Enable the extension: gnome-extensions enable AlphabeticalAppGrid@stuarthayhurst

Install the extension from source:

• Make sure the install dependencies are installed
• make build
• make install
• Log out and back in to restart GNOME
• Enable the extension: gnome-extensions enable AlphabeticalAppGrid@stuarthayhurst

Build system usage:

• Common targets: Regular build system targets to build, install and uninstall

  • make build: Creates extension zip
  • make check: Runs checks on built extension zip
  • make install: Installs the extension
  • make uninstall: Uninstalls the extension

• Development targets: These targets are aimed at developers and translators

  • make clean: Cleans the extension repository, including built files and translations
  • make translations: Updates translations
  • make compress: Losslessly compresses any .pngs in docs/
    • Allows passing COMPRESSLEVEL="-o[X]", where [X] is an integer between 0-7
    • Supports -j[X], where [X] is the number of threads to use
  • make release: Updates translations and icons, then creates and checks an extension zip
    • Calls make translations compress build check
    • Supports any variables / arguments supported by these targets
    • Also allows passing VERSION="[XX]", where [XX] is the version to update metadata.json to
    • Supports -j[X], where [X] is the number of threads to use
  • make package: Creates the extension zip from the project's current state (only useful for debugging)

Install dependencies:

• gettext
• gnome-shell (gnome-extensions command)

Build dependencies: (Only required if running make release)

• All install dependencies
• sed (make translations)
• optipng (make compress)

What happened to the show favourites option?

• Maintaining this feature was going to end up complicated and messy
• It was also out of scope, and this extension did the job better
• With this in mind, the feature was removed in release v16

Want to help?

• Help with the project is always appreciated, refer to docs/CONTRIBUTING.md to get started
• Documentation, code, translations and UI improvements are all welcome!

Bug reporting / debugging:

• If you were simply told "Error" while installing, reboot and see if there's still an issue
  • When installing an extension from GNOME's extension site, this is normal
• A log of what the extension is doing is very helpful for fixing issues
• The extension logs to the system logs when enabled, which can be accessed with journalctl /usr/bin/gnome-shell
• A live feed of GNOME's logs can be accessed with journalctl /usr/bin/gnome-shell -f -o cat
• To enable logging, the setting can be found under the Developer settings section of the extension's settings:

Credits:

• scripts/update-po.sh and scripts/update-pot.sh were derived from Fly-Pie, originally licensed under the MIT license

Screenshots: