Computer Cleaner Project Structure

computer_cleaner/ ├── main.py # Entry point ├── requirements.txt # Dependencies ├── setup.sh # Setup script (Linux/macOS) ├── setup.bat # Setup script (Windows) ├── run.bat # Run script (Windows) ├── src/ │ ├── init.py │ ├── app.py # Main application class │ ├── gui/ │ │ ├── init.py │ │ ├── login_screen.py # Login screen component │ │ ├── main_screen.py # Main interface screen │ │ └── process_view.py # Process details view │ ├── system/ │ │ ├── init.py │ │ ├── scanner.py # System scanning functionality │ │ └── process_manager.py # Process management │ └── utils/ │ ├── init.py │ └── categorizer.py # Application categorization └── README.md

Computer Cleaner

A desktop application to help users manage and close running applications and processes to free up system resources without permanently deleting or uninstalling any software.

Features

• Clean, white interface with simple hierarchical navigation
• Login screen for access control
• Scan & Clean functionality to identify running applications
• Categorization of applications (Browsers, Communication Apps, Media Players, etc.)
• Detailed process view for individual applications
• Granular process/tab management (close single tabs without closing the entire browser)
• Full application shutdown (close all processes for an application)
• All actions close processes without uninstalling applications

Prerequisites

Before running the application, you need to install the required dependencies:

On Ubuntu/Debian:

sudo apt-get update
sudo apt-get install python3-pip python3-tk
pip3 install -r requirements.txt

On Fedora/RHEL:

sudo dnf install python3-pip tkinter
pip3 install -r requirements.txt

On CentOS/RHEL:

sudo yum install python3-pip tkinter
pip3 install -r requirements.txt

On macOS:

Python 3 with tkinter should be included with the standard Python installer from python.org.

pip3 install -r requirements.txt

Windows:

1. Install Python 3 from the official website (https://www.python.org/downloads/windows/) if not already installed
2. Ensure that Python and pip are added to your system PATH during installation
3. Install the required packages:

   pip install -r requirements.txt

   Or simply run the provided setup.bat script:

   setup.bat

Setup

Linux/macOS:

1. Install the prerequisites as described above
2. Alternatively, run the setup script (requires sudo privileges):

   ./setup.sh

Windows:

1. Install Python 3 if not already installed
2. Install required packages:

   pip install -r requirements.txt

3. Note: On Windows, tkinter is typically included with Python installations

Running the Application

Linux/macOS:

python3 main.py

Windows:

python main.py

Or simply run the provided run.bat script:

run.bat

Technology Stack

• Python 3.x
• Tkinter (for GUI)
• psutil (for system process management)

Important Notes

• The application only closes running processes, it does not uninstall or delete any software
• Users can reopen closed applications normally after using Computer Cleaner
• The application requires appropriate permissions to access and manage system processes
• On Windows, you may need to run the application as Administrator to manage certain system processes