# 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