Alphabetical App Grid GNOME Extension
![Donate](https://camo.githubusercontent.com/0283ea90498d8ea623c07906a5e07e9e6c2a5eaa6911d52033687c60cfa8d22f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f6e6174652d50617950616c2d677265656e2e737667)
- Alphabetically order GNOME's app grid and folders
- Get the extension from here
- This project is licensed under GPL 3.0
- Any donations are greatly appreciated :)
- 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 "AlphabeticalAppGrid@stuarthayhurst.shell-extension.zip" --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
-
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 .png
s 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)
- 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
- 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](https://raw.githubusercontent.com/stuarthayhurst/alphabetical-grid-extension/master/docs/enable-logging.png)
scripts/update-po.sh
and scripts/update-pot.sh
were derived from Fly-Pie, originally licensed under the MIT license
![Settings](https://raw.githubusercontent.com/stuarthayhurst/alphabetical-grid-extension/master/docs/settings.png)