Skip to content

teiman/debloat

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DEBLOAT - Windows Process Manager

A lightweight web-based tool for inspecting, monitoring, and managing Windows processes. It runs a local FastAPI server and serves a dashboard in your browser.

DEBLOAT screenshot

Features

Process listing

Enumerates every running process and displays its PID, parent PID, name, executable path, command line, and username. Processes that psutil cannot read are filled in via a PowerShell CIM fallback.

Friendly display names

Common processes are shown with meaningful labels instead of raw executable names:

  • svchost.exe → service or group name (e.g. "Dhcp (svchost.exe)")
  • chrome.exe, msedge.exe, Code.exe, msedgewebview2.exe → subprocess type (e.g. "renderer (chrome.exe)")
  • crosvm.exe → subcommand (e.g. "device-block (crosvm.exe)")

Process categorization

Each process is classified as required, necessary, auxiliary, user, bad, or other based on the entries in known_processes.json.

Process termination

Kill any process by PID directly from the dashboard.

Real-time history monitor

A background thread polls every 3 seconds and records up to 1000 events:

  • launched : a new process appeared
  • closed : a process disappeared
  • high_cpu : a process crossed the 80% CPU threshold

Requirements

  • Python 3.9+
  • fastapi
  • uvicorn
  • psutil

Installation

pip install fastapi uvicorn psutil

Usage

python server.py

Then open http://127.0.0.1:8080 in your browser.

Files

File Description
server.py Main application (API + monitor)
index.html Web dashboard front-end
known_processes.json Process classification database

API Endpoints

Method Path Description
GET / Web dashboard
GET /api/processes List all running processes (JSON)
DELETE /api/processes/{pid} Terminate a process by PID
GET /api/history Recent process events (JSON)

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors