Skip to content

README.md

Latest commit

 

History

History
140 lines (101 loc) · 5.02 KB

README.md

File metadata and controls

140 lines (101 loc) · 5.02 KB
Raw

BlackBull PC Cleaner

Version 2.1.0 is a safer Windows 10/11 maintenance console. It replaces the old all-in-one batch implementation with a small batch launcher and a structured PowerShell core.

What changed in 2.0

  • Recoverable cleanup: accessible temporary files are moved into timestamped backups instead of being deleted.
  • Undo Center: restores file cleanups, registry settings, service start modes, power plans, and program updates from their recorded original state.
  • Safer updater:
    • only installs a strictly newer semantic version;
    • downloads to a staging file;
    • verifies the BlackBull marker, file size, PowerShell syntax, and matching version;
    • backs up the running core before atomically replacing it;
    • never prevents the cleaner from opening when the network is unavailable.
  • Daily logs and clear success, warning, and failure messages.
  • Administrative elevation is requested only by tools that need it.
  • Risky or permanent operations require explicit confirmation.
  • The previous remote in-memory Spotify patch installer was removed. The cleaner no longer executes unverified third-party scripts.
  • A clearer color-coded menu with grouped toolkits.

Tools

Maintenance and recovery

  • System health dashboard
  • Cleanup preview showing file counts and estimated space
  • Recoverable user and Windows temp cleanup
  • Recoverable NVIDIA, AMD, and Windows graphics-cache cleanup
  • Undo Center with the 20 newest backups
  • Backup integrity verification
  • Automatic retention cleanup for old, already-restored backups
  • Disk Cleanup and Windows Storage settings
  • Permanent Recycle Bin cleanup with a warning

Windows repair and diagnostics

  • System File Checker (sfc /scannow)
  • DISM component-store repair
  • Online system-drive scan (chkdsk /scan)
  • Windows Memory Diagnostic
  • Reliability Monitor
  • System Restore point creation
  • Windows component-store analysis
  • Seven-day critical/error event summary
  • Device and driver problem detection
  • Recent Windows update history

Network toolkit

  • Flush DNS
  • Display full adapter configuration
  • Connectivity and DNS tests
  • Winsock and TCP/IP reset
  • Active TCP connection viewer

Analysis and reports

  • Read-only drive and common-cleanup-location storage analyzer
  • Timestamped system inventory reports
  • Hardware, Windows, BIOS, disk, startup, hotfix, and problem-device details
  • Cleaner backup integrity verification

Performance and utilities

  • Reversible balanced gaming preset
  • App updates through winget
  • Startup Apps settings
  • Battery report generation
  • Microsoft Malware Removal Tool
  • Clipboard cleanup

The gaming preset records the actual registry keys, service modes/states, and active power plan before changing them. It uses manual service mode rather than permanently disabling Windows services.

Requirements

  • Windows 10 or Windows 11
  • Windows PowerShell 5.1 or newer
  • Administrator rights for repair, service, system-temp, and network-reset operations
  • winget is optional and is detected before use
  • Internet access is optional and is used only for update checks and app updates

Usage

Keep these two files together:

  • CleanPC.bat
  • CleanPC.ps1

Double-click CleanPC.bat. The launcher uses a process-scoped execution-policy bypass; it does not change the computer's PowerShell policy.

Runtime data is stored beside the program:

CleanerData/
|-- Backups/
|-- Logs/
|-- Reports/
|-- settings.json
`-- battery-report.html

CleanerData is ignored by Git.

Undo behavior

Every supported change gets a timestamped manifest before it runs. Open Undo Center and select a backup, or choose the newest available backup.

If Undo Center does not work, follow the dedicated step-by-step manual recovery guide. It explains how to restore quarantined files, registry settings, services, power plans, and a previous cleaner version.

Some Windows actions cannot be reliably reversed by any cleaner. The program labels these clearly and asks for confirmation:

  • emptying the Recycle Bin;
  • SFC, DISM, CHKDSK, and Windows repair activity;
  • application upgrades performed by winget;
  • network reset;
  • external Windows utilities.

Temporary-file cleanup is recoverable, but locked/in-use files are skipped and recorded in the log.

Updating

The update check reads:

  • latest_version.txt
  • CleanPC.ps1

from the configured GitHub main branch. Publish both files together and ensure the embedded version in CleanPC.ps1 exactly matches latest_version.txt. The stable CleanPC.bat launcher does not need to self-modify.

Automatic checks can be disabled under Updates & Settings. A failed or offline check is non-fatal.

Security notes

  • Review the configured GitHub URLs before redistributing a fork.
  • Backups may contain files or settings that were private to the user; protect the CleanerData directory accordingly.
  • A restore point is still recommended before extensive Windows repair.
  • No downloaded script is executed unless it passes the updater's structural and syntax checks.

License

MIT. See LICENSE.