Skip to content

"GNOME PurgeX: A powerful tool to streamline your GNOME desktop by removing unnecessary apps and bloat."

License

Notifications You must be signed in to change notification settings

intrepidDev101/Gnome-PurgeX

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 

Repository files navigation

Gnome-PurgeX

GNOME PurgeX is a command-line tool designed to streamline and optimize your GNOME desktop environment by removing pre-installed GNOME applications that may be unnecessary for your workflow. With an interactive, sci-fi-inspired interface and multi-package manager support, GNOME PurgeX provides an efficient and powerful debloating experience.


Table of Contents


Features

  • Multi-package manager support: Automatically detects and works with apt, pacman, dnf, zypper, and yum.
  • Interactive selection: Allows users to choose which GNOME packages to remove via an intuitive checklist interface powered by whiptail.
  • Dependency-aware: Only displays packages currently installed on your system.
  • Logging: Logs all removal actions and any errors encountered during execution.
  • Progress tracking: Displays real-time feedback for each package removal action.
  • Sci-fi inspired interface: Sleek colors and a futuristic name to make system maintenance feel high-tech.

Supported Package Managers

  • apt (Debian/Ubuntu)
  • pacman (Arch Linux)
  • dnf (Fedora)
  • zypper (openSUSE)
  • yum (RHEL/CentOS)

Prerequisites

  • Bash: This script is compatible with Bash and should run on any Linux distribution using GNOME.
  • whiptail: This utility is required for the interactive checklist interface. Install it with:
    • sudo apt install whiptail (Debian/Ubuntu)
    • sudo pacman -S libnewt (Arch)
    • sudo dnf install newt (Fedora)
    • sudo zypper install newt (openSUSE)

Installation

1.Download or clone the GNOME PurgeX script:

git clone https://github.com/intrepidDev101/Gnome-PurgeX.git
cd GNOME-PurgeX

2.Make the script executable:

chmod +x gpurgex.sh

Usage

To run GNOME PurgeX, simply execute the script with sudo privileges:

sudo ./gpurgex.sh

Upon execution, GNOME PurgeX will:

  • Identify the package manager on your system.
  • Present a checklist of GNOME applications available for removal.
  • Allow you to select which applications you want to uninstall.
  • Log all removal actions to /tmp/gnome_debloat.log.

Optional Arguments

Currently, GNOME PurgeX runs interactively. Future versions may include command-line flags for additional customization.


Uninstallable Packages

GNOME PurgeX can target the following pre-installed GNOME applications:

  • epiphany (Web browser)
  • gnome-software (Software center)
  • gnome-tour (Introduction tour)
  • gnome-text-editor (Text editor)
  • gnome-system-monitor (System monitor)
  • snapshot (Snapshot tool)
  • totem (Video player)
  • gnome-music (Music player)
  • gnome-calculator (Calculator)
  • gnome-calendar (Calendar)
  • gnome-maps (Maps)
  • gnome-weather (Weather)
  • gnome-contacts (Contacts)
  • gnome-characters (Characters tool)
  • gnome-clocks (Clocks)
  • gnome-user-docs (User documentation)
  • yelp (GNOME help browser)
  • gnome-logs (Gnome Log Viewer)
  • gnome-connections (Gnome Remote Desktop Viewer)
  • gnome-font-viewer (Gnome Font Installer)
  • vim (Text Editor)
  • simple-scan (Document Scanner)
  • Flatpak (Package Manager)
  • malcontent (Flatpak Dependency)
  • htop (Resouce Monitor)

Example Usage

Here’s a step-by-step example of GNOME PurgeX in action:

Run the script:

sudo ./gpurgex.sh

1.The script will detect your package manager and display the packages available for removal.

2.Select the packages you want to remove from the checklist interface.

3.Confirm the selection, and GNOME PurgeX will remove the selected packages.

4.A summary will be displayed, and detailed logs will be saved to /tmp/gnome_debloat.log.


Contributing

Contributions are welcome! Feel free to submit issues and pull requests to improve GNOME PurgeX. Here’s how to get started:

1.Fork the repository. 2.Create a new branch for your feature or bug fix:

git checkout -b feature-name

3.Make your changes and commit them. 4.Push to your fork and submit a pull request.


License

This project is licensed under the MIT License. See the LICENSE file for more information.

About

"GNOME PurgeX: A powerful tool to streamline your GNOME desktop by removing unnecessary apps and bloat."

Topics

Resources

License

Stars

Watchers

Forks

Languages