354 lines
12 KiB
Markdown
354 lines
12 KiB
Markdown
# Kawa's Bloat Remover - Complete Index
|
|
|
|
Complete toolkit for removing manufacturer bloatware from Windows PCs.
|
|
|
|
**Repository:** https://git.azuze.fr/kawa/Kawa-s-Bloat-Remover
|
|
|
|
---
|
|
|
|
## 📚 Documentation Map
|
|
|
|
### For First-Time Users
|
|
Start here:
|
|
1. **[QUICKSTART.md](QUICKSTART.md)** - Copy-paste commands and go (5 min read)
|
|
2. **[REMOTE_QUICK_COMMANDS.md](REMOTE_QUICK_COMMANDS.md)** - All commands in one file (1 min reference)
|
|
|
|
### For Detailed Information
|
|
1. **[README.md](README.md)** - Complete technical documentation (comprehensive)
|
|
2. **[REMOTE_EXECUTION.md](REMOTE_EXECUTION.md)** - How to run from internet (detailed guide)
|
|
3. **[BLOATWARE_LIST.md](BLOATWARE_LIST.md)** - What gets removed (96 items listed)
|
|
|
|
### For Administrators & Deployment
|
|
1. **[MANIFEST.md](MANIFEST.md)** - Script inventory and specifications
|
|
2. **[REMOTE_EXECUTION.md](REMOTE_EXECUTION.md)** - Deployment to multiple PCs
|
|
|
|
### Reference Documents
|
|
- **[INDEX.md](INDEX.md)** - This file (navigation guide)
|
|
|
|
---
|
|
|
|
## 🚀 Quick Start - 30 Seconds
|
|
|
|
### Run Right Now (From Internet, No Download)
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; Invoke-Expression(Invoke-WebRequest -Uri 'https://git.azuze.fr/kawa/Kawa-s-Bloat-Remover/raw/main/Remove-AllBloat.ps1' -UseBasicParsing).Content"
|
|
```
|
|
|
|
**That's it!** Opens PowerShell → Copy command → Paste → Press Enter → Done
|
|
|
|
---
|
|
|
|
## 📋 All Available Scripts
|
|
|
|
### Core Removal Scripts (Run These)
|
|
|
|
| Script | Purpose | Type |
|
|
|--------|---------|------|
|
|
| [Remove-AllBloat.ps1](Remove-AllBloat.ps1) | Remove ALL bloatware (HP, Lenovo, ASUS, Dell) | ⭐ Recommended |
|
|
| [Remove-HPBloat.ps1](Remove-HPBloat.ps1) | HP only | Manufacturer-Specific |
|
|
| [Remove-LenovoBloat.ps1](Remove-LenovoBloat.ps1) | Lenovo only | Manufacturer-Specific |
|
|
| [Remove-ASUSBloat.ps1](Remove-ASUSBloat.ps1) | ASUS only | Manufacturer-Specific |
|
|
| [Remove-DellBloat.ps1](Remove-DellBloat.ps1) | Dell only | Manufacturer-Specific |
|
|
|
|
### Diagnostic Scripts (Use Before/After)
|
|
|
|
| Script | Purpose | Type |
|
|
|--------|---------|------|
|
|
| [Scan-Bloatware.ps1](Scan-Bloatware.ps1) | Preview what will be removed | Diagnostic |
|
|
| [Verify-Removal.ps1](Verify-Removal.ps1) | Confirm bloatware is gone | Verification |
|
|
|
|
### Deployment & Automation Scripts
|
|
|
|
| Script | Purpose | Type |
|
|
|--------|---------|------|
|
|
| [Deploy-ScheduledTask.ps1](Deploy-ScheduledTask.ps1) | Schedule auto-cleanup | Deployment |
|
|
| [Deploy-ToRemote.ps1](Deploy-ToRemote.ps1) | Push to multiple PCs | Deployment |
|
|
| [Remote-Launch.ps1](Remote-Launch.ps1) | Launch from internet with parameters | Launcher |
|
|
| [Run-AllBloat.bat](Run-AllBloat.bat) | Silent batch wrapper | Wrapper |
|
|
| [Launch-Remote.bat](Launch-Remote.bat) | Remote batch wrapper | Wrapper |
|
|
|
|
---
|
|
|
|
## 🎯 Choose Your Path
|
|
|
|
### Path 1: "Just Do It" (Simplest)
|
|
**Time:** 5 minutes
|
|
**Reading:** Just copy-paste
|
|
|
|
1. Read: [REMOTE_QUICK_COMMANDS.md](REMOTE_QUICK_COMMANDS.md) (1 min)
|
|
2. Copy first command (Remove-AllBloat)
|
|
3. Run in PowerShell (Admin)
|
|
4. Done!
|
|
|
|
### Path 2: "Be Careful" (Recommended)
|
|
**Time:** 15 minutes
|
|
**Reading:** Quick Start guide + Scan before removal
|
|
|
|
1. Read: [QUICKSTART.md](QUICKSTART.md) (5 min)
|
|
2. Run: Scan-Bloatware to see what exists (5 min)
|
|
3. Run: Remove-AllBloat (5 min)
|
|
4. Run: Verify-Removal to confirm (5 min)
|
|
|
|
### Path 3: "Understand Everything" (Thorough)
|
|
**Time:** 1 hour
|
|
**Reading:** All documentation + detailed exploration
|
|
|
|
1. Read: [README.md](README.md) - Full technical guide (20 min)
|
|
2. Read: [BLOATWARE_LIST.md](BLOATWARE_LIST.md) - What's being removed (10 min)
|
|
3. Read: [REMOTE_EXECUTION.md](REMOTE_EXECUTION.md) - How remote works (15 min)
|
|
4. Execute with understanding (15 min)
|
|
|
|
### Path 4: "Manage Multiple PCs" (IT/Admin)
|
|
**Time:** 30 minutes
|
|
**Reading:** Deployment guides
|
|
|
|
1. Read: [MANIFEST.md](MANIFEST.md) - Overview (10 min)
|
|
2. Read: [REMOTE_EXECUTION.md](REMOTE_EXECUTION.md) - Deployment section (15 min)
|
|
3. Deploy using chosen method (5 min)
|
|
|
|
---
|
|
|
|
## 🌐 Remote Execution (Internet-Based)
|
|
|
|
### Why Remote Execution?
|
|
- ✅ No download needed
|
|
- ✅ No file storage
|
|
- ✅ Always latest version
|
|
- ✅ Easy to share
|
|
- ✅ Nothing to install
|
|
|
|
### How to Access
|
|
Use the raw Git URLs:
|
|
```
|
|
https://git.azuze.fr/kawa/Kawa-s-Bloat-Remover/raw/main/{script-name}
|
|
```
|
|
|
|
### Example URLs
|
|
- Remove All: `https://git.azuze.fr/kawa/Kawa-s-Bloat-Remover/raw/main/Remove-AllBloat.ps1`
|
|
- Remove HP: `https://git.azuze.fr/kawa/Kawa-s-Bloat-Remover/raw/main/Remove-HPBloat.ps1`
|
|
- Scan: `https://git.azuze.fr/kawa/Kawa-s-Bloat-Remover/raw/main/Scan-Bloatware.ps1`
|
|
|
|
See [REMOTE_EXECUTION.md](REMOTE_EXECUTION.md) for all URLs and detailed instructions.
|
|
|
|
---
|
|
|
|
## 📊 What Gets Removed
|
|
|
|
### Summary
|
|
- **62 Applications** (bloatware programs)
|
|
- **20 Windows Services** (background processes)
|
|
- **14 Installation Directories** (program folders)
|
|
- **Total: 96 items**
|
|
|
|
### By Manufacturer
|
|
- **HP:** 22 items (Support Assistant, drivers, utilities)
|
|
- **Lenovo:** 24 items (Vantage, Power Management, OneKey)
|
|
- **ASUS:** 25 items (Live Update, WebStorage, GameVisual)
|
|
- **Dell:** 25 items (SupportAssist, Optimizer, Command Update)
|
|
|
|
### See Details
|
|
Read: [BLOATWARE_LIST.md](BLOATWARE_LIST.md) for complete itemized list
|
|
|
|
---
|
|
|
|
## ✅ Recommended Workflow
|
|
|
|
### Best Practice: 3-Step Process
|
|
|
|
**Step 1: Scan (See What Will Happen)**
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; Invoke-Expression(Invoke-WebRequest -Uri 'https://git.azuze.fr/kawa/Kawa-s-Bloat-Remover/raw/main/Scan-Bloatware.ps1' -UseBasicParsing).Content"
|
|
```
|
|
|
|
**Step 2: Remove (Execute Removal)**
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; Invoke-Expression(Invoke-WebRequest -Uri 'https://git.azuze.fr/kawa/Kawa-s-Bloat-Remover/raw/main/Remove-AllBloat.ps1' -UseBasicParsing).Content"
|
|
```
|
|
|
|
**Step 3: Verify (Confirm Success)**
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; Invoke-Expression(Invoke-WebRequest -Uri 'https://git.azuze.fr/kawa/Kawa-s-Bloat-Remover/raw/main/Verify-Removal.ps1' -UseBasicParsing).Content"
|
|
```
|
|
|
|
---
|
|
|
|
## 🔒 Safety
|
|
|
|
### What's Safe
|
|
✅ Removes only manufacturer bloatware
|
|
✅ Doesn't touch Windows system files
|
|
✅ Doesn't delete user data
|
|
✅ Doesn't disable critical drivers
|
|
✅ Scripts are version-controlled in Git
|
|
|
|
### Verification
|
|
- Use [Scan-Bloatware.ps1](Scan-Bloatware.ps1) to see what will be removed
|
|
- Use [Verify-Removal.ps1](Verify-Removal.ps1) to confirm success
|
|
- All changes are logged in Git history
|
|
|
|
---
|
|
|
|
## 🎯 Use Cases
|
|
|
|
### "I want to clean my personal PC"
|
|
→ Read [QUICKSTART.md](QUICKSTART.md)
|
|
→ Run [Remove-AllBloat.ps1](Remove-AllBloat.ps1) remotely
|
|
|
|
### "I want to remove HP bloatware only"
|
|
→ Use [REMOTE_QUICK_COMMANDS.md](REMOTE_QUICK_COMMANDS.md)
|
|
→ Copy HP-only command
|
|
|
|
### "I want to understand what will be removed"
|
|
→ Read [BLOATWARE_LIST.md](BLOATWARE_LIST.md)
|
|
→ Run [Scan-Bloatware.ps1](Scan-Bloatware.ps1)
|
|
|
|
### "I'm an IT admin managing multiple PCs"
|
|
→ Read [REMOTE_EXECUTION.md](REMOTE_EXECUTION.md) (Deployment section)
|
|
→ Use [Deploy-ToRemote.ps1](Deploy-ToRemote.ps1) or Group Policy
|
|
|
|
### "I want it to run automatically"
|
|
→ Use [Deploy-ScheduledTask.ps1](Deploy-ScheduledTask.ps1)
|
|
|
|
### "I don't have admin rights"
|
|
→ Scripts will auto-elevate, or ask your admin for elevation
|
|
|
|
---
|
|
|
|
## 📚 Documentation Quick Links
|
|
|
|
| Document | Purpose | Length | Audience |
|
|
|----------|---------|--------|----------|
|
|
| [QUICKSTART.md](QUICKSTART.md) | Fast start guide | 5 min | All users |
|
|
| [REMOTE_QUICK_COMMANDS.md](REMOTE_QUICK_COMMANDS.md) | Command reference | 1 min | Busy users |
|
|
| [README.md](README.md) | Full technical docs | 20 min | Detailed readers |
|
|
| [REMOTE_EXECUTION.md](REMOTE_EXECUTION.md) | Remote setup guide | 15 min | Internet users |
|
|
| [BLOATWARE_LIST.md](BLOATWARE_LIST.md) | Complete item list | 10 min | Auditors |
|
|
| [MANIFEST.md](MANIFEST.md) | Script inventory | 10 min | Administrators |
|
|
| [INDEX.md](INDEX.md) | Navigation (this file) | 5 min | All users |
|
|
|
|
---
|
|
|
|
## 🔧 Execution Methods
|
|
|
|
### Method 1: Remote (From Internet) ⭐
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; Invoke-Expression(Invoke-WebRequest -Uri 'URL' -UseBasicParsing).Content"
|
|
```
|
|
**Best for:** First-time users, single PC, always up-to-date
|
|
|
|
### Method 2: Local File
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -File "Remove-AllBloat.ps1"
|
|
```
|
|
**Best for:** Offline systems, repeated use, no internet
|
|
|
|
### Method 3: Batch Wrapper
|
|
```cmd
|
|
Run-AllBloat.bat
|
|
```
|
|
**Best for:** Non-technical users, automated deployment
|
|
|
|
### Method 4: Task Scheduler
|
|
Scheduled execution
|
|
**Best for:** Periodic cleanup, automatic updates
|
|
|
|
### Method 5: Group Policy
|
|
Centralized deployment
|
|
**Best for:** Enterprise environments
|
|
|
|
---
|
|
|
|
## ❓ FAQ
|
|
|
|
**Q: Do I need to download anything?**
|
|
A: No! Use remote execution. See [REMOTE_QUICK_COMMANDS.md](REMOTE_QUICK_COMMANDS.md)
|
|
|
|
**Q: What if I don't have internet?**
|
|
A: Download the files first. All scripts work offline.
|
|
|
|
**Q: Is it safe?**
|
|
A: Yes! Only removes bloatware, not system files. See [BLOATWARE_LIST.md](BLOATWARE_LIST.md) for what's removed.
|
|
|
|
**Q: Will it break my system?**
|
|
A: No. These are optional bloatware apps, not required for Windows.
|
|
|
|
**Q: Can I undo it?**
|
|
A: Yes, reinstall from manufacturer websites if needed.
|
|
|
|
**Q: What if something goes wrong?**
|
|
A: Reboot and use System Restore, or reinstall the removed applications.
|
|
|
|
**Q: How much disk space do I free up?**
|
|
A: 3-6 GB per system, depending on what was installed.
|
|
|
|
---
|
|
|
|
## 🔗 Repository Links
|
|
|
|
| Link | Description |
|
|
|------|-------------|
|
|
| [Repository Home](https://git.azuze.fr/kawa/Kawa-s-Bloat-Remover) | Main project page |
|
|
| [Issues](https://git.azuze.fr/kawa/Kawa-s-Bloat-Remover/issues) | Report bugs |
|
|
| [Commits](https://git.azuze.fr/kawa/Kawa-s-Bloat-Remover/commits) | View changes |
|
|
| [Branches](https://git.azuze.fr/kawa/Kawa-s-Bloat-Remover/branches) | Version branches |
|
|
|
|
---
|
|
|
|
## 📞 Support Resources
|
|
|
|
1. **Documentation:** Read relevant .md file (see above)
|
|
2. **Scripts:** Check inline comments in .ps1 files
|
|
3. **Troubleshooting:** See QUICKSTART.md or README.md sections
|
|
4. **Repository:** https://git.azuze.fr/kawa/Kawa-s-Bloat-Remover
|
|
|
|
---
|
|
|
|
## 📈 Project Stats
|
|
|
|
- **Total Scripts:** 14 (5 removal, 2 diagnostic, 7 deployment/wrapper)
|
|
- **Total Documentation:** 7 files
|
|
- **Lines of Code:** ~2,500
|
|
- **Bloatware Items:** 96 (62 apps, 20 services, 14 directories)
|
|
- **Manufacturers:** 4 (HP, Lenovo, ASUS, Dell)
|
|
- **Repository:** Public
|
|
- **License:** Open Source
|
|
- **Language:** PowerShell
|
|
|
|
---
|
|
|
|
## 🚀 Getting Started
|
|
|
|
### First Time User? Start Here:
|
|
1. Open this file
|
|
2. Read "Quick Start - 30 Seconds" section
|
|
3. Copy the command
|
|
4. Open PowerShell as Admin
|
|
5. Paste and run
|
|
6. Done!
|
|
|
|
### Want More Details?
|
|
- [QUICKSTART.md](QUICKSTART.md) - Expanded quick start
|
|
- [README.md](README.md) - Complete documentation
|
|
|
|
### Want to Deploy to Many PCs?
|
|
- [REMOTE_EXECUTION.md](REMOTE_EXECUTION.md) - Deployment guide
|
|
|
|
### Want to Know What's Removed?
|
|
- [BLOATWARE_LIST.md](BLOATWARE_LIST.md) - Complete inventory
|
|
|
|
---
|
|
|
|
## 📅 Version Information
|
|
|
|
- **Toolkit Version:** 1.0
|
|
- **Created:** 2026-07-21
|
|
- **Last Updated:** 2026-07-21
|
|
- **Maintenance:** Actively maintained
|
|
- **Support:** Community
|
|
|
|
---
|
|
|
|
**Start with:** [QUICKSTART.md](QUICKSTART.md) or [REMOTE_QUICK_COMMANDS.md](REMOTE_QUICK_COMMANDS.md)
|
|
|
|
**Repository:** https://git.azuze.fr/kawa/Kawa-s-Bloat-Remover
|