GNOME App Folder Organizer

A simple tool for automatically organizing GNOME applications into categorized folders.

Description

This script automatically organizes applications in the GNOME application menu into logical folders based on their categories. It uses a YAML configuration file to define the mapping of application categories to folders.

Features

• Automatic organization of applications into categorized folders
• Customizable configuration via a YAML file
• Easy installation and usage
• Support for custom category-to-folder mappings

Installation

Prerequisites

• GNOME desktop environment
• yq for parsing YAML files

Installing the Script

1. Download the script:

git clone https://codeberg.org/Tealk/gnome-app-folder-organizer.git
cd gnome-app-folder-organizer
chmod +x configure_gnome_folders.sh

Usage

Basic Usage

Simply run the script to apply the default folder configuration:

./organize-folders.sh

Custom Configuration File

You can specify a custom configuration file:

./organize-folders.sh /path/to/my/config.yaml

Customizing Configuration

The default configuration file is created at config.yaml. You can edit this file to customize the folders and categories:

# Configuration file for GNOME application folders
# Format: folder_name: [category1, category2, ...]

# Standard categories and their mapping to GNOME folders
folders:
  Office:
    - Office
  Development:
    - Development
  Games:
    - Game
  Graphics:
    - Graphics
  Internet:
    - Network
  Multimedia:
    - AudioVideo
  Utilities:
    - Utility
  System:
    - System
    - Settings

You can add, remove, or change the associated categories for folders. After editing the configuration file, run the script again to apply the changes.

License

This project is licensed under the AGPL-3.0 License - see the LICENSE file for details. The AGPL license requires that all modifications to the code must be made publicly available if you distribute or serve a modified version of the program over a network.