OrphyCleaner GUI

Overview

OrphyCleaner is a lightweight GUI tool for Arch-based Linux that scans your home directory for orphaned or unused application folders and helps you decide whether to keep or remove them.

❓ Why I created this app

After a long time, I ended up with a bunch of folders in my home directory from installed apps. Some I had just tried out, some I had already uninstalled, and some I still use.
And there was no way to tell whether an app was still installed or not, because some folders aren’t named after the app. So I created this app, which scans the home directory and finds folders that no longer have a corresponding app.

🚀 Features

• Scans common config locations: ~/.config, ~/.local/share, and other hidden folders under your home.
• Matches folders against installed packages (pacman), Flatpak apps, .desktop applications, AppImages, and executables in your PATH.
• Categorizes folders as Installed, Maybe Installed, or Orphaned and folder count.
• Option to mark orphaned folders as important (Keep / Unkeep).
• Search/filter box to quickly narrow down folders within a category.
• Package/AUR/Flatpak description lookup for any folder, so you can see what a match actually is before deciding.
• Includes default ignored folders like cache, trash, and other system-related directories.
• Customizable alias mappings for special folder names.
• Lightweight and fast with native GTK4/libadwaita GUI
• Runs on Manjaro and other Arch-based distributions.

🛠️ Installation

From AUR (Recommended for Manjaro/Arch)

yay -S orphycleaner

From Github

git clone https://github.com/dodog/orphycleaner.git
cd orphycleaner
python3 orphycleaner.py

Warning

This script cannot guarantee that orphaned folders are truly unused. Please backup and verify before deleting to avoid losing important data.

📋 Requirements

Python version:

• Python: 3.9+
• PyGObject, GTK4, and libadwaita (GUI libraries)

Installation of GTK4 / libadwaita

Depending on your Linux distribution, install the dependencies with:

Manjaro/Arch Linux sudo pacman -S python-gobject gtk4 libadwaita

Screenshots

New GTK4 version:

Help

For help visit wiki OrphyCleaner – Help & Documentation

Customization

Update the IGNORED_FOLDERS list in the script to exclude additional folders.

Add folder-to-app name aliases in the ALIAS_MAP section.

❤️ Support

Do you find OrphyCleaner useful? You can buy me a coffee ☕