kevin/gnome-app-grid-manager
1
0
Fork 0
mirror of https://github.com/prurigro/gnome-app-grid-manager.git synced 2025-12-07 00:02:30 -05:00
Code Issues Projects Releases Packages Wiki Activity
Organize your Gnome overview applications by category
102 commits 1 branch 9 tags 371 KiB
Find a file
Exact
Kevin MacMartin 7283094e84 Add additional functions to the color package that allows colors without a reset, add an "inverted" color, and invert the "select a new category" heading so it's more clear which mode you're in
2025-10-09 00:24:18 -04:00
application Improve the regex that determines whether an application should be shown by allowing multiple entries in NotShowIn and adding OnlyShowIn when it lacks Gnome 2025-08-19 15:39:19 -04:00
category Add an option to rename category folders, and make variable names a bit more clear 2025-08-19 15:11:45 -04:00
cli Rather than query the terminal for interactivity every time a message or color is used, do it once at runtime and store it in a variable 2025-08-08 12:15:10 -04:00
color Add additional functions to the color package that allows colors without a reset, add an "inverted" color, and invert the "select a new category" heading so it's more clear which mode you're in 2025-10-09 00:24:18 -04:00
env Use a separate package for environment variables, and create fallbacks for them ones that are used 2025-08-06 11:08:37 -04:00
gnome Remove empty return definition for the gnome RestoreDefault function 2025-08-19 15:27:44 -04:00
screenshots Add a screenshot of the app grid after applying category folders 2025-08-19 16:34:50 -04:00
ui Use bubbletea in the ui MessageWait function to listen for enter or escape to keep input consistent 2025-08-19 17:04:39 -04:00
.gitignore Rename the project to something that makes what it does a bit more clear 2025-08-10 17:51:30 -04:00
go.mod Use github instead of forgejo so others can contribute 2025-08-10 18:48:18 -04:00
go.sum Don't apply color to text with color.Add or clear the screen and wait for the enter key in ui.Message when the terminal isn't interactive 2025-08-07 16:23:48 -04:00
LICENSE Add a license and readme 2025-08-06 01:20:41 -04:00
main.go Add additional functions to the color package that allows colors without a reset, add an "inverted" color, and invert the "select a new category" heading so it's more clear which mode you're in 2025-10-09 00:24:18 -04:00
README.md Add a screenshot of the app grid after applying category folders 2025-08-19 16:34:50 -04:00

README.md

Gnome Application Grid Manager

Organize your Gnome overview applications by category

Screenshot of the Gnome App Grid after applying category folders

Menu Options

  • Manage application categories: Interactively move applications between category folders (includes a default Uncategorized list)
  • Create new category folder: Creates a new category folder with no applications inside
  • Delete existing category folder: Deletes a category folder and moves its applications to Uncategorized
  • Rename existing category folder: Allows an existing category folder to be given a new name
  • Apply category folders in Gnome: Applies the configured category folders and applications in the Gnome overview application grid
  • Restore default layout in Gnome: Removes category folders from the Gnome overview application grid and resets the layout
  • Clean and sort data files: Removes applications that aren't installed and visible from each .category file in the data directory, and sorts them alphabetically

CLI Options

  • -a|--apply: Apply category folders in Gnome
  • -r|--restore: Restore default layout in Gnome
  • -c|--clean: Clean and sort .category files
  • -h|--help: Show the help text

Getting Started

Build

  1. Clone or download and extract the latest release for gnome-app-grid-manager
  2. Enter the directory and run go build
  3. The binary should now be available in the same directory

Install

Local

  1. The package for Go should be installed
  2. The GOPATH variable should be configured to point somewhere your user can read and write (eg: export GOPATH="$HOME/.local/share/go")
  3. $GOPATH/bin should be added to $PATH (eg: export PATH="$GOPATH/bin:$PATH")
  4. Run go install github.com/prurigro/gnome-app-grid-manager@latest

Packaged

Filesystem

This program creates the directory $XDG_DATA_HOME/gnome-shell/categories and places .category files inside.

Each .category file represents a category folder, and contains a list of .desktop files that get included inside.

The $XDG_DATA_HOME directory and directories in $XDG_DATA_DIRS are searched for unique .desktop files that aren't configured to be hidden (NoDisplay=true, Hidden=true or NotShowIn=gnome).

CREDITS

Written by Kevin MacMartin:

LICENSE

Released under the MIT license.