Skip to content

Home

Jump to bottom
Arkadius edited this page Sep 23, 2025 · 7 revisions

Deep Clean Pro

Welcome to the Deep Clean Pro wiki! This comprehensive guide will help you understand, install, and use Deep Clean Pro effectively.

Deep Clean Pro Windows PowerShell Security

🚀 Overview

Deep Clean Pro is a security-hardened Windows optimization tool designed for developers, IT professionals, and power users. It provides automated system maintenance, performance optimization, and comprehensive cleanup capabilities with enterprise-grade security features.

⚡ Key Features

  • 🧹 Advanced System Cleanup: Remove temporary files, Windows Update cache, and unnecessary system data
  • ⚡ Performance Optimization: 70% faster execution with QuickMode technology
  • 🛡️ Security-Hardened: SHA256 hash verification and zero known vulnerabilities
  • 📊 Intelligent Analysis: Comprehensive system health reports with actionable insights
  • 🔧 Registry Optimization: Safe registry cleanup with automatic backup
  • 💾 Automatic Restore Points: System protection before every operation
  • ⚙️ Multiple Operation Modes: Full, Quick, Ultra, Conservative, and Silent modes
  • 📋 Enterprise Logging: Complete audit trail with security event tracking
  • 🧪 Comprehensive Testing: Pester v5 compatible test suite with unit and integration tests

📋 Table of Contents

Deep-Clean-Pro project structure

Deep-Clean-Pro/
│
├── 📁 .github/
│   ├── 📁 ISSUE_TEMPLATE/
│   │   └── 📄 bug_report.md
│   ├── 📁 tests/
│   │   └── 🧪 MyModule.Tests.ps1
│   └── 📁 workflows/
│       ├── ⚙️ ci.yml
│       └── ⚙️ psscriptanalyzer.yml
│
├── 📁 Documentation/
│   ├── 📄 CHANGELOG.md
│   ├── 📄 CODE_OF_CONDUCT.md
│   ├── 📄 CONTRIBUTING.md
│   ├── 📄 DEPLOYMENT_GUIDE.md
│   ├── 📄 RELEASE_NOTES.md
│   └── 📄 SETUP_INSTRUCTIONS.md
│
├── 📁 Scripts/
│   ├── 🔧 CheckMarkdownPSBlocks.ps1
│   ├── 🔧 CreateDesktopShortcuts.ps1
│   ├── ⭐ DeepCleanPro.ps1
│   ├── 🚀 DEPLOY.ps1
│   ├── ✅ VALIDATE.ps1
│   └── 🔧 Fix-WindowsPolicies.ps1
│
├── 📄 LICENSE
├── 📄 README.md
├── 🔒 SECURITY.md
└── 🚫 .gitignore

🎯 Quick Start

Prerequisites

Component Minimum Recommended
OS Windows 10 (1903+) Windows 11
PowerShell 5.1 7.3+
RAM 4 GB 8 GB+
Disk Space 2 GB 5 GB+
Permissions User Administrator

Basic Usage

# Clone the repository
git clone https://github.com/DiodacElectronics/Deep-Clean-Pro.git
cd Deep-Clean-Pro

# Deploy the tool
.\DEPLOY.ps1

# Run basic cleanup (QuickMode - 70% faster)
.\DeepCleanPro.ps1 -QuickMode

# Full system optimization
.\DeepCleanPro.ps1

# Generate system report
.\DeepCleanPro.ps1 -SystemReport

🛠️ Installation Guide

Method 1: Quick Install (Recommended) ⭐

# One-line installation
git clone https://github.com/DiodacElectronics/Deep-Clean-Pro.git && cd Deep-Clean-Pro && .\DEPLOY.ps1

Method 2: Manual Installation

# Step 1: Clone repository
git clone https://github.com/DiodacElectronics/Deep-Clean-Pro.git

# Step 2: Navigate to directory
cd Deep-Clean-Pro

# Step 3: Set execution policy
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# Step 4: Install required modules
Install-Module -Name PSReadLine -Force
Install-Module -Name PSWindowsUpdate -Force

# Step 5: Validate installation
.\Scripts\VALIDATE.ps1

# Step 6: Deploy
.\DEPLOY.ps1

Method 3: Environment Variables Configuration

Set these environment variables for custom deployment:

Variable Description Example
DEEPCLEANPRO_BASE_PATH Installation directory D:\Tools\DeepCleanPro
DEEPCLEANPRO_BACKUP_PATH Backup location E:\Backups\DCP
DCP_QUICK_MODE Enable QuickMode by default true
DCP_NO_REBOOT Disable reboot prompts true
DCP_CONSERVATIVE Use Conservative mode false

🎛️ Operation Modes

Deep Clean Pro offers multiple operation modes optimized for different scenarios:

Mode Duration Aggressiveness Use Case Command
🔥 Full Mode 30-45 min Maximum Monthly deep maintenance .\DeepCleanPro.ps1
⚡ Quick Mode 10-15 min High Weekly optimization .\DeepCleanPro.ps1 -QuickMode
🚀 Ultra Mode 5-10 min Medium Daily cleanup .\DeepCleanPro.ps1 -UltraMode
🛡️ Conservative 20-30 min Low Production servers .\DeepCleanPro.ps1 -ConservativeMode
🔇 Silent Mode Varies Configurable Automated tasks .\DeepCleanPro.ps1 -SilentMode

Mode Comparison Chart

Performance Impact:  [████████████████████] Full Mode (100%)
                    [██████████████    ] Quick Mode (70%)
                    [████████████      ] Ultra Mode (60%)
                    [████████          ] Conservative (40%)

Speed:              [████████████████████] Ultra Mode
                    [██████████████    ] Quick Mode
                    [████████          ] Conservative
                    [████              ] Full Mode

🎨 Features Overview

🧹 Cleanup Operations

System Cleanup

  • ✅ Windows Update cache cleanup
  • ✅ Temporary files removal (system & user)
  • ✅ Prefetch optimization
  • ✅ Windows.old folder cleanup
  • ✅ WinSxS folder compression
  • ✅ System log rotation

Browser Cleanup

  • ✅ Chrome cache and history
  • ✅ Firefox data cleanup
  • ✅ Edge optimization
  • ✅ Opera and Brave support

Application Cleanup

  • ✅ Microsoft Office cache
  • ✅ Adobe Creative Suite temp files
  • ✅ Visual Studio cache
  • ✅ Package manager caches (npm, pip, maven)

⚡ Performance Optimization

Service Management

  • 🔧 Disable unnecessary services
  • 🔧 Optimize startup services
  • 🔧 Configure delayed start
  • 🔧 Service dependency analysis

System Tuning

  • ⚙️ Visual effects optimization
  • ⚙️ Power plan configuration
  • ⚙️ Virtual memory optimization
  • ⚙️ Network adapter tuning

🛡️ Security Features

Version 2.1.2 Enhancements

  • 🔐 SHA256 Hash Verification: All downloads verified before execution
  • 👤 Administrator Validation: Built-in privilege checking
  • 🔒 Secure Execution Policy: Process-scoped policy with restoration
  • 🚫 No Remote Code Execution: Eliminated irm | iex patterns
  • 💾 Automatic Restore Points: System protection before operations
  • 📝 Security Audit Logging: Complete operation history

📊 Command Reference

Basic Syntax

.\DeepCleanPro.ps1 [OPTIONS] [PARAMETERS]

Available Parameters

Parameter Type Description Default Example
-QuickMode Switch 70% faster execution $false .\DeepCleanPro.ps1 -QuickMode
-UltraMode Switch Fastest execution mode $false .\DeepCleanPro.ps1 -UltraMode
-ConservativeMode Switch Safe mode for servers $false .\DeepCleanPro.ps1 -ConservativeMode
-FixPolicies Switch Run policy helper (backup/verify) $false .\DeepCleanPro.ps1 -FixPolicies
-SilentMode Switch No user interaction $false .\DeepCleanPro.ps1 -SilentMode
-SkipUpdates Switch Skip Windows Updates $false .\DeepCleanPro.ps1 -SkipUpdates
-NoReboot Switch Suppress reboot prompt $false .\DeepCleanPro.ps1 -NoReboot
-LogPath String Custom log location Auto .\DeepCleanPro.ps1 -LogPath "E:\Logs"
-BackupPath String Custom backup location Auto .\DeepCleanPro.ps1 -BackupPath "D:\Backups"
-WhatIf Switch Preview mode $false .\DeepCleanPro.ps1 -WhatIf
-Verbose Switch Detailed output $false .\DeepCleanPro.ps1 -Verbose

Usage Examples

# Daily maintenance (Ultra fast)
.\DeepCleanPro.ps1 -UltraMode -NoReboot

# Prepare Windows policies (optional)
.\DeepCleanPro.ps1 -FixPolicies

# Weekly optimization (Quick mode)
.\DeepCleanPro.ps1 -QuickMode -SkipUpdates

# Monthly deep clean (Full mode)
.\DeepCleanPro.ps1 -Verbose -LogPath "C:\Logs\DeepClean"

# Server maintenance (Conservative)
.\DeepCleanPro.ps1 -ConservativeMode -BackupPath "E:\ServerBackups"

# Automated task (Silent)
.\DeepCleanPro.ps1 -SilentMode -QuickMode -NoReboot

# Test run (Preview only)
.\DeepCleanPro.ps1 -WhatIf -Verbose

📈 Performance Benchmarks

System Performance Improvements

Metric Before After Improvement
Boot Time 45s 28s 38% faster
Available RAM 4.2 GB 6.8 GB 62% more
Disk Space 42 GB 55 GB 13 GB freed
Service Count 182 124 58 disabled
Startup Programs 23 11 52% reduced

Operation Benchmarks

System Type Mode Duration Space Freed Services Optimized
Dev Workstation (i7-12700K, 32GB) Full 42 min 13.2 GB 59
Dev Workstation (i7-12700K, 32GB) Quick 12 min 11.8 GB 59
Dev Workstation (i7-12700K, 32GB) Ultra 6 min 8.4 GB 52
Office PC (i5-10400, 16GB) Full 38 min 9.7 GB 48
Office PC (i5-10400, 16GB) Quick 11 min 8.2 GB 45
Server (Xeon E5, 64GB) Conservative 25 min 5.2 GB 31

🔒 Security Features

Security Implementation (v2.1.2)

# Verify script integrity
.\Scripts\VALIDATE.ps1

# Check security status
Get-DeepCleanProSecurity

# View security logs
Get-Content "C:\DeepCleanPro\Logs\Security.log" -Tail 50

# Create manual restore point
Checkpoint-Computer -Description "Before Deep Clean Pro v2.1.2"

Policy Helper (Optional)

# Prepare Windows policies safely (creates backup and verifies)
.\DeepCleanPro.ps1 -FixPolicies

# Or run directly
.\Scripts\Fix-WindowsPolicies.ps1 -BackupPath "$env:TEMP\PolicyBackup.json" -NoPause

# Restore policies later
.\Scripts\Fix-WindowsPolicies.ps1 -RestoreBackup -BackupPath "C:\Path\PolicyBackup.json"

Security Best Practices

  1. Always run validation before major operations
  2. Keep gists private if using online shortcuts
  3. Regular updates - Check for security patches
  4. Monitor logs - Review security events weekly
  5. Test first - Use -WhatIf for preview

🐛 Troubleshooting

Common Issues & Solutions

❌ Script execution disabled

# Solution
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

❌ Access denied errors

# Solution: Run as Administrator
Start-Process powershell -Verb RunAs
cd "C:\DeepCleanPro"
.\DeepCleanPro.ps1

❌ Module installation failures

# Solution
Install-Module -Name PSWindowsUpdate -Force -AllowClobber
Install-Module -Name PSReadLine -Force -AllowClobber

❌ Desktop shortcuts not working

# Solution: Re-create shortcuts
.\Scripts\CreateDesktopShortcuts.ps1

❌ Pester test failures

# Solution: Ensure Pester v5+ is installed
Install-Module -Name Pester -Force -SkipPublisherCheck

# Run tests with verbose output for debugging
Invoke-Pester -Path .\.github\tests -Output Detailed -Verbose

# Check specific test file
Invoke-Pester -Path .\.github\tests\MyModule.Tests.ps1 -Output Detailed

Diagnostic Commands

# Full system validation
.\Scripts\VALIDATE.ps1 -Verbose

❓ Frequently Asked Questions

General Questions

Q: Is Deep Clean Pro safe to use?

A: Yes! Version 2.1.2 has zero known security vulnerabilities and creates automatic restore points before any system changes.

Q: How often should I run Deep Clean Pro?

A: We recommend: Ultra mode (daily), Quick mode (weekly), Full mode (monthly)

Q: What's the difference between modes?

A: Each mode balances thoroughness vs. speed. Ultra is fastest (5-10 min), Quick is balanced (10-15 min), Full is most thorough (30-45 min)

Q: Can I use it on servers?

A: Yes! Use ConservativeMode for production servers to ensure minimal impact

Technical Questions

Q: What Windows versions are supported?

A: Windows 10 (1903+), Windows 11, Windows Server 2019/2022

Q: Does it work with PowerShell 7?

A: Yes! PowerShell 7.3+ is recommended for best performance

Q: Can I automate Deep Clean Pro?

A: Yes! Use scheduled tasks with -SilentMode parameter

Security Questions

Q: Are the desktop shortcuts secure?

A: Yes! Version 2.1.2 includes SHA256 verification for all shortcuts

Q: Should I update my gist URLs?

A: Yes, if using online shortcuts, update to v2.1.2 immediately for security fixes

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

How to Contribute

  1. Fork the repository
  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

Development Setup

# Fork and clone
git clone https://github.com/YOUR_USERNAME/Deep-Clean-Pro.git
cd Deep-Clean-Pro

# Create branch
git checkout -b feature/your-feature

# Test your changes
.\Scripts\VALIDATE.ps1
.\DeepCleanPro.ps1 -WhatIf

# Run Pester tests (from repo root)
# Tests are compatible with Pester v5+
Invoke-Pester -Path .\.github\tests -Output Detailed

# Run specific test suites
Invoke-Pester -Path .\.github\tests\MyModule.Tests.ps1 -Tag 'Unit'
Invoke-Pester -Path .\.github\tests\FixWindowsPolicies.Tests.ps1 -Tag 'Unit'

# Submit PR when ready

📞 Support

For technical support, feature requests, or bug reports:

  1. 📖 Check the Wiki for documentation
  2. 🔍 Search existing issues for similar problems
  3. 💬 Join Discussions for community help
  4. 🐛 Create a new issue with detailed information
  5. 📧 Email: info@isystem.app

Useful Links

📜 Licenses

© 2025 Diodac Electronics. iSystem Development is a brand of Diodac Electronics.
Deep-Clean-Pro — © 2025 Diodac Electronics / iSystem Development
Licensed under the MIT License — see the LICENSE file for details.

“Windows” and “Microsoft” are trademarks of Microsoft Corporation
Project Deep Clean Pro is independent, no affiliation implied
All other trademarks are the property of their respective owners

🏆 Acknowledgments

  • PowerShell Community for excellent modules and guidance
  • Microsoft for PowerShell and Windows APIs
  • All contributors and beta testers
  • Security researchers for responsible disclosure
  • The open-source community for inspiration and support

Deep Clean Pro v2.1.2 | Security-Hardened | Enterprise-Ready

Made with ❤️ by @DiodacElectronics

Views Stars Forks Issues

Last Updated: September 2025 | Version: 2.1.2 | Maintainer: @DiodacElectronics

Clone this wiki locally