diff --git a/README.md b/README.md index 4615c18..380b128 100644 --- a/README.md +++ b/README.md @@ -1,80 +1,53 @@ +
- - - -
-
+# J1-MSP-Toolkit -
-

🔧 J1 MSP Toolkit

-

Windows 10/11 Provisioning & Debloat Utility for MSP Technicians

-

One-click Windows provisioning — debloat, harden, and tune for production use

-

- Features • - Quick Start • - What It Does • - Remote Execution -

-
+A PowerShell-based Windows 10/11 provisioning and debloating toolkit for MSP technicians — one-click setup, bloatware removal, service hardening, and power tuning. ---- +[![GitHub](https://img.shields.io/badge/github-OneByJorah%2FJ1--MSP--Toolkit-FFB300?style=for-the-badge&labelColor=0d0d0c)](https://github.com/OneByJorah/J1-MSP-Toolkit) +[![License](https://img.shields.io/badge/license-MIT-FFB300?style=for-the-badge&labelColor=0d0d0c)](LICENSE) +[![Language](https://img.shields.io/badge/PowerShell-FFB300?style=for-the-badge&labelColor=0d0d0c)](https://learn.microsoft.com/en-us/powershell/) +[![Built by](https://img.shields.io/badge/built%20by-JorahOne%20LLC-FFB300?style=for-the-badge&labelColor=0d0d0c)](https://github.com/OneByJorah) -## ✨ Features + -- **One-Click Provisioning** — Single PowerShell script for full Windows setup -- **AppX Bloatware Removal** — Removes pre-installed Windows Store apps and Xbox bloatware -- **Service Hardening** — Ensures essential services (Print Spooler) are enabled and automatic -- **Power Tuning** — Applies high performance or balanced power scheme -- **Restart-Friendly** — No background service installation required; run from any PowerShell prompt -- **Remote Execution** — Deploy via URL download — perfect for remote technician scenarios +--- -## 🚀 Quick Start +## Why This Exists -```powershell -# Run from an elevated PowerShell prompt -Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -.\install.ps1 -``` +MSPs deploy and re-deploy Windows machines constantly. Each one needs bloatware stripped, services hardened, and power settings tuned — a repetitive, error-prone manual process. The J1-MSP-Toolkit automates it: one PowerShell script that debloats, hardens critical services, configures power schemes, and prepares Windows for production use. -## 🔧 What It Does +## Key Features -| Step | Action | -|------|--------| -| 1 | Downloads MSP-Ultra-Debloat.ps1 utility | -| 2 | Removes AppX packages (system bloatware) | -| 3 | Removes Xbox-related applications and services | -| 4 | Ensures Print Spooler service is enabled and running | -| 5 | Sets power scheme to High Performance or Balanced | -| 6 | System is ready for production deployment | +| Feature | Why It Matters | +|---|---| +| One-click setup | Single PowerShell script for full deployment | +| Bloatware removal | Strips pre-installed Windows Store apps and Xbox bloatware | +| Service hardening | Ensures critical services (Print Spooler, etc.) are set correctly | +| Power tuning | Configures high-performance or balanced power schemes | +| Remote execution ready | Run via URL — no manual file copy needed | -## 🌐 Remote Execution +## Quick Start -For remote technician scenarios, download and execute directly: +Run in an elevated PowerShell prompt (as Administrator): ```powershell -# One-liner for MSP technician use -iex ((New-Object System.Net.WebClient).DownloadString( - 'https://raw.githubusercontent.com/OneByJorah/J1-MSP-Toolkit/main/install.ps1' -)) +Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process +.\install.ps1 ``` -## 📁 Project Structure +## Documentation -``` -J1-MSP-Toolkit/ -├── install.ps1 # Main installation script -├── debloat/ # Debloat utility scripts -└── README.md -``` +| Doc | Description | +|---|---| +| [Usage Guide](docs/usage.md) | Running the toolkit and available options | +| [Customization](docs/customization.md) | Tailoring the debloat and hardening lists | -## 📄 License +--- -MIT © Jhonattan L. Jimenez +## License ---- +MIT © JorahOne, LLC — see [LICENSE](LICENSE) -
-

⚡ Fast Windows provisioning for MSPs

-

@OneByJorah

-
+Part of the JorahOne infrastructure ecosystem.