LDL Windows ToolBox

A cohesive, menu-driven Windows utility for system cleanup, repair, network reset, performance tuning, security management, diagnostics, recovery, and reporting.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

The LDL Windows ToolBox is a Python-first Windows utility that combines administrative privilege elevation, system cleanup, repair flows, network reset, BitLocker management, browser AI cleanup, SSD TRIM, low-latency configuration, recovery tools, diagnostics, and reporting into a single cohesive menu-driven interface.

The project follows a modular file-per-feature architecture running with zero external dependencies (Python standard library + built-in Windows commands + ANSI escape codes):

• LDLWinToolBox.bat — thin Batch launcher invoking uv run -- python ldlwintoolbox.py
• ldlwintoolbox.py — entry point with admin detection, UAC relaunch, and colored main menu dispatch
• toolbox_base.py — shared infrastructure (Logger, Color, cprint, Spinner, CommandResult, run/command/prompt helpers)
• features/ — one file per feature (23 menu items), each importing only from toolbox_base
• config/exclusions.json — runtime-managed exclusion list for cleanup operations (created on first use)
• logs/ — timestamped structured session logs with session header, section markers, command exit codes
• scripts/check.ps1 — unified ruff lint + format check runner
• LDLWinToolBox.spec — PyInstaller spec for EXE packaging
• .github/workflows/ci.yml — CI workflow (ruff on push/PR)
• .github/workflows/release.yml — Release workflow (PyInstaller build on version tag)

When launched without administrator privileges, the tool automatically enters read-only mode, hiding destructive features (1–11) and providing a "[R] Restart as Administrator" shortcut while allowing safe inspection of system information, diagnostics, and logs. When launched as admin, all 23 menu items are available and long-running or destructive operations display warnings, require explicit (Y/N) confirmation, and offer optional system restore points.

(back to top)

Built With

• 
• 
• 

(back to top)

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

• Windows 10 or Windows 11
• Administrator rights (optional — the tool supports read-only mode without elevation; destructive features auto-request UAC if needed)
• uv (recommended) — the launcher falls back to python if uv is not available
• Python 3.11 or later

Installation

1. Clone the repo

   git clone https://github.com/LoveDoLove/LDLWinToolBox.git

2. Double-click LDLWinToolBox.bat to launch the interactive menu, or run:

   uv run -- python ldlwintoolbox.py

(back to top)

Usage

Upon launching, the interactive menu provides numbered options organized into logical groups. When running without administrator privileges, the tool enters read-only mode — admin features (1–11) are hidden and a "[R] Restart as Administrator" shortcut is provided.

System Cleanup (1–3)

• [1] Advanced System Cleanup: Deeply cleans temporary system/user data, Prefetch, SoftwareDistribution downloads; selective target sub-menu with exclusion list integration; calculates space freed (MB).
• [2] Windows Component Store Cleanup (WinSxS): Removes superseded Windows Update install files using DISM.
• [3] Clear Event Viewer Logs: Flushes all Windows event logs via wevtutil.

System Repair & Update (4–5)

• [4] System Integrity Repair (SFC + DISM): Scans and repairs corrupt OS files with SFC /scannow and DISM /RestoreHealth.
• [5] Update All Installed Apps: Silently updates all winget-installed applications.

Network (6)

• [6] Complete Network Reset: Resets Winsock, TCP/IP stack, and DNS cache; requires restart.

Performance (7–8)

• [7] Manual SSD TRIM: Triggers manual SSD re-trim with defrag /L /V on a user-selected volume.
• [8] Low Latency Mode (ViVeTool): Auto-detects CPU architecture (Intel/AMD x64 or Snapdragon ARM64), downloads ViVeTool, and manages Windows feature flags (IDs 58989092, 60716524, 61391826) with a query/enable/disable sub-menu.

Security & Privacy (9–10)

• [9] Disable BitLocker (Plan): Shows status for all drives, validates selection, then starts manage-bde -off after DISABLE confirmation.
• [10] Kill Browser AI: Executes a remote PowerShell cleanup script to disable on-device browser AI features after KILL confirmation.

Recovery (11)

• [11] Recovery & Safe Mode Tools: Sub-menu for boot configuration (bcdedit), Safe Mode (minimal / networking / command prompt), WinRE status & enable/disable, and restore normal boot.

Diagnostics (12–19)

• [12] System Information: OS edition/build, CPU name/logical cores, RAM usage, system drive usage, uptime via ctypes + winreg.
• [13] Windows Update Status: wuauserv service state, Auto Update registry config, last install/search dates, runs UsoClient scan.
• [14] Defender Status & Quick Scan: Get-MpComputerStatus fields, optional MpCmdRun signature update, optional Start-MpQuickScan.
• [15] Service Health Check: Status of 20 critical Windows services (wuauserv, BITS, EventLog, Dhcp, etc.).
• [16] Disk Health & SMART Summary: Get-PhysicalDisk with StorageReliabilityCounter (wear, temperature, errors), volume summary, SMART counters.
• [17] Driver Inventory: Parses driverquery /FO CSV with type/date summary.
• [18] Network Snapshot: Captures ipconfig /all, route print, netsh interface, netstat -ano to file and log; optional diff with previous snapshot.
• [19] Export Logs & Report: Generates a plain-text session report (features run, commands, warnings) and archives all logs to ZIP under exports/.

Tools (20–22)

• [20] View Log History: Lists recent toolbox logs and opens the selected file with a paged console viewer.
• [21] Check for Updates: Queries the GitHub Releases API, compares with local version (v1.0.7), optionally opens browser for download.
• [22] Cleanup Exclusion List: Manages a JSON-based exclusion list (config/exclusions.json); paths matching exclusions are skipped during cleanup.

Each run writes a structured log under logs/ with a session header, environment summary, section markers, user cancellations, command start/end markers, and exit codes. Long-running or destructive operations display warnings and require explicit (Y/N) confirmation. Optional system restore points can be created before destructive features.

(back to top)

Roadmap

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Top contributors:

License

Distributed under the Apache License 2.0. See LICENSE for more information.

(back to top)

Contact

LoveDoLove - Telegram Channel - Discord

Project Link: https://github.com/LoveDoLove/LDLWinToolBox

(back to top)

Acknowledgments

• Best-README-Template
• ViVeTool by thebookisclosed
• Windows UAC / ShellExecuteW
• Winget Tool
• Python
• uv

(back to top)