Skip to content

dodog/orphycleaner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OrphyCleaner GUI

Overview

64x64

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. Feel free to modify it for your Linux distribution.

Do you find OrphyCleaner useful? Buy me a coffee ☕

🚀 Features

  • Simple GUI built with Tkinter (no terminal commands required for usage).
  • 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 shows summary count.
  • Option to mark orphaneds folder as important (KEEP)
  • Includes default ignored folders like cache, trash, and other system-related directories.
  • Customizable alias mappings for special folder names.
  • Lightweight and fast — no unnecessary dependencies.
  • Runs on Manjaro and other Arch-based distributions.

🛠️ Installation

From Github

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

From AUR (Recommended for Manjaro/Arch)

yay -S orphycleaner

Warning

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

📋 Requirements for the Python version

Python version:

  • Python: 3.9+
  • Tkinter (GUI library)

Installation of Tkinter

Depending on your Linux distribution, install tkinter with:

Manjaro/Arch Linux bash sudo pacman -S tk

Screenshots

orphycleaner-v1 1 0_screnshot

orphycleaner

Help

For help visit wiki OrphyCleaner – Help & Documentation

Customization

Update the ignored_folders array in the script to exclude additional folders.

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

About

Cleans configuration file leftovers after uninstalling applications in the user's home folder.

Topics

Resources

License

Stars

Watchers

Forks

Languages