Skip to content

stuarthayhurst/alphabetical-grid-extension

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

alphabetical-grid-extension

Alphabetical App Grid GNOME Extension

Donate

  • 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:

Enable logging

Credits:

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

Screenshots:

Extension Settings