kelexine/tiny11-automated

# Tiny11 Automated Builder [](https://github.com/kelexine/tiny11-automated/actions/workflows/build-tiny11.yml) [](https://github.com/kelexine/tiny11-automated/actions/workflows/build-tiny11-core.yml) [](https://github.com/kelexine/tiny11-automated/actions/workflows/build-nano11.yml) [](https://sourceforge.net/projects/tiny-11-releases/files/latest/download) [](LICENSE) [](CODE_OF_CONDUCT.md) ## 📊 Project Stats ## 🆕 What's New (January 2026) **Windows 11 25H2 Optimizations:** - ✨ **AI/Recall Removal**: Complete removal of Copilot, Recall, and AI Fabric (~220 MB saved) - 🛡️ **Enhanced Telemetry Blocking**: Stronger privacy protection with additional registry tweaks - 🎮 **VRAM Gaming Optimization**: Improved graphics performance through DirectX registry optimizations - ⚡ **Build-Specific Service Removal**: 4 services (Standard), 13 services (Core), 14 services (Nano) - 🚫 **Windows Update Binary Removal**: Core/Nano builds now remove WU binaries (~300 MB saved) **Total Additional Savings:** - Standard: ~120 MB - Core: ~320 MB - Nano: ~320 MB ## 📋 Overview Tiny11 Automated Builder provides **production-ready PowerShell scripts** to create minimized Windows 11 ISO images by: ✨ **Removing bloatware** (40+ unnecessary apps) 🔒 **Disabling telemetry** (complete privacy protection) ⚡ **Optimizing performance** (faster boot, less resource usage) 🤖 **Full CI/CD automation** (GitHub Actions workflows) 🛠️ **System requirement bypass** (TPM, CPU, RAM checks removed) **Three variants** available: **Standard** (daily use), **Core** (ultra-minimal), **Nano** (VM testing) ### 🙏 Attribution This project is based on the original [tiny11 builder by ntdevlabs](https://github.com/ntdevlabs/tiny11builder). The headless versions were created by **kelexine** to enable automated CI/CD builds while preserving all original functionality. ### 🌐 Landing Pages - **Tiny11 Info**: [https://kelexine.is-a.dev/tiny11](https://kelexine.is-a.dev/tiny11) - Detailed information about standard Tiny11 builds - **Nano11 Info**: [https://kelexine.is-a.dev/nano11](https://kelexine.is-a.dev/nano11) - Detailed information about Nano11 extreme minimal builds ### ⚖️ Legal Notice ## 🚀 Quick Start ### Option 1: Automated Build (GitHub Actions) - Recommended Perfect for beginners and automated deployments: 1. **Fork** this repository 2. Go to **Actions** tab 3. Choose your workflow: - `Build Tiny11` → Standard trimmed Windows 11 - `Build Tiny11 Core` → Ultra-minimal variant - `Build Nano11` → EXTREME minimal (VM only) 4. Click **"Run workflow"** and configure: - Windows ISO URL - Edition (Home/Pro/Education) - Optional parameters 5. **Download** ISO from Artifacts or [SourceForge](https://sourceforge.net/projects/tiny-11-releases/) **Build time**: 30-80 minutes depending on variant ### Option 2: Manual Build (PowerShell) For advanced users and local builds: # 1. Download or mount Windows 11 ISO # 2. Note the drive letter (e.g., E:) # 3. Run PowerShell as Administrator # 4. Set execution policy Set-ExecutionPolicy Bypass -Scope Process # 5. Choose your variant: # Standard Tiny11 (Recommended for daily use) .\scripts\tiny11maker-headless.ps1 -ISO E -INDEX 1 # Tiny11 Core (Ultra-minimal, VM/testing only) .\scripts\tiny11coremaker-headless.ps1 -ISO E -INDEX 6 # Nano11 (EXTREME minimal, VM testing ONLY) .\scripts\nano11builder-headless.ps1 -ISO E -INDEX 1 # With .NET 3.5 (Core variant only) .\scripts\tiny11coremaker-headless.ps1 -ISO E -INDEX 1 -ENABLE_DOTNET35 **System Requirements**: Windows 10/11, PowerShell 5.1+, 30GB+ free space, Admin rights ## ⚠️ Choose Your Variant

Feature	🟢 Standard	🟡 Core	🔴 Nano
Use Case	Daily use (with caution)	Testing, disposable VMs	VM testing ONLY
ISO Size	~3.5-5.5GB	~3-3.5GB	~2.5GB
Bloatware Removal	✅ 40+ apps	✅ 40+ apps	✅ 50+ apps
Telemetry Disabled	✅ Complete	✅ Complete	✅ Complete
WinSxS Component Store	✅ Full	❌ Minimized	❌ Minimized
Windows Recovery	✅ Intact	❌ Removed	❌ Removed
Windows Defender	✅ Included	❌ Disabled	❌ Removed
Serviceability	✅ Can add features/updates	❌ Cannot service	❌ Cannot service
Printing Support	✅ Yes	✅ Yes	❌ No
Basic Apps (Notepad, Paint)	✅ Included	✅ Included	❌ Removed
Build Time	45-80 min	30-45 min	<40 min

### 💡 Which Should You Choose? - **🟢 Standard**: Best for most users. Balanced bloat removal with system stability - **🟡 Core**: Perfect for development VMs, testing environments, disposable systems - **🔴 Nano**: Absolute minimal testing only. Expect broken features. VM use ONLY. ## 📁 Repository Structure tiny11-automated/ ├── .github/ │ ├── workflows/ # GitHub Actions CI/CD │ │ ├── build-tiny11.yml │ │ ├── build-tiny11-core.yml │ │ └── build-nano11.yml │ ├── ISSUE_TEMPLATE/ # Issue templates │ └── PULL_REQUEST_TEMPLATE.md ├── scripts/ │ ├── tiny11maker-BASE.ps1 # Original interactive (ntdevlabs) │ ├── tiny11maker-headless.ps1 # ✨ Automated Standard │ ├── tiny11Coremaker-BASE.ps1 # Original Core interactive │ ├── tiny11coremaker-headless.ps1 # ✨ Automated Core │ ├── nano11builder-BASE.ps1 # Original Nano interactive │ └── nano11builder-headless.ps1 # ✨ Automated Nano ├── autounattend.xml # OOBE bypass (Standard/Core) ├── autounattend-nano.xml # OOBE bypass (Nano) ├── CONTRIBUTING.md # Contributor guidelines ├── CODE_OF_CONDUCT.md # Community standards ├── SECURITY.md # Security policy ├── ROADMAP.md # Project roadmap ├── README.md # This file └── LICENSE # MIT License ## 🔧 Script Parameters ### Standard & Core Variants .\tiny11maker-headless.ps1 -ISO # Drive letter of mounted ISO (e.g., "E") -INDEX # Image index (1=Home, 4=Education, 6=Pro, 7=Pro N) [-SCRATCH ] # Optional: Scratch disk (default: script directory) [-SkipCleanup] # Optional: Keep temp files for debugging ### Core-Only Parameter .\tiny11coremaker-headless.ps1 [-ENABLE_DOTNET35] # Enable .NET Framework 3.5 support ### Nano Variant .\nano11builder-headless.ps1 -ISO # Drive letter of mounted ISO -INDEX # Image index [-SCRATCH ] # Optional: Scratch disk [-SkipCleanup] # Optional: Keep temp files ### Examples # Basic build - Windows 11 Home Standard .\scripts\tiny11maker-headless.ps1 -ISO E -INDEX 1 # Professional Edition Core with .NET 3.5 .\scripts\tiny11coremaker-headless.ps1 -ISO E -INDEX 6 -ENABLE_DOTNET35 # Custom scratch drive (useful for limited C:\ space) .\scripts\tiny11maker-headless.ps1 -ISO E -INDEX 1 -SCRATCH D # Debug mode (keeps temporary files) .\scripts\tiny11maker-headless.ps1 -ISO E -INDEX 1 -SkipCleanup ## 📦 What Gets Removed? ### 🗑️ Bloatware Apps (40-50+ removed)

Click to expand full list

**Productivity & Entertainment:** - Microsoft Teams - OneDrive - Microsoft Edge - Xbox Game Bar & Gaming Services - Clipchamp Video Editor - Paint 3D - 3D Viewer - Mixed Reality Portal **Information & News:** - Weather - News - Maps - Bing Search **Communication:** - Skype - Cortana - People App - Your Phone (Phone Link) - Outlook for Windows (new) **AI Features (Windows 11 25H2+):** - Windows Copilot (AI Assistant) - Windows Recall (AI Snapshots) - AI Fabric Service - CoreAI Components **Office & Productivity:** - Office Hub - Power Automate - Solitaire Collection - Sticky Notes - To Do **Utilities:** - Get Help - Get Started (Tips) - Feedback Hub - Quick Assist - DevHome **Media:** - Media Player - Sound Recorder - Photos - Camera (Nano only) **Additional (Nano only):** - Notepad - Paint - Windows Terminal

### 🔧 System Components Removed - Internet Explorer (legacy package) - Windows Media Player (legacy) - WordPad - Math Input Panel - Steps Recorder - LA57 CPU compatibility layer - Language features (OCR, Speech, Handwriting) - Windows Defender (Core/Nano only) - Printer drivers (Nano only) - Scanner/MFD drivers (Nano only) ### ⚙️ Registry Optimizations Applied

Click to expand optimizations

**System Requirements:** - TPM 2.0 requirement bypass - Secure Boot requirement bypass - CPU compatibility check bypass - RAM requirement bypass (allows <4GB) **Privacy & Telemetry:** - All telemetry endpoints disabled - Enhanced diagnostic data blocking - Activity history disabled - Location services disabled - Advertising ID disabled - Device name excluded from telemetry - Feedback notifications disabled **AI & Privacy (NEW - Windows 11 25H2):** - Windows AI data analysis completely disabled - Copilot AI assistant fully removed - Recall snapshot feature blocked - AI Fabric service disabled **User Experience:** **Performance (NEW):** - VRAM allocation optimized for gaming - Non-essential services disabled (4-13 depending on variant) - Diagnostic services removed - Telemetry services disabled **Update & Cloud:** - Windows Update disabled (can be manually enabled in Standard) - Windows Update binaries removed (Core/Nano - NON-SERVICEABLE) - OneDrive backup prompts disabled - Teams auto-install blocked - New Outlook installation blocked

## 💾 System Requirements ### For Building ISOs | Requirement | Minimum | Recommended | |------------|---------|-------------| | **Operating System** | Windows 10 | Windows 11 | | **PowerShell** | 5.1 | 7.0+ | | **RAM** | 8GB | 16GB+ | | **Free Disk Space** | 20GB | 40GB+ | | **Processor** | Dual-core | Quad-core+ | | **Permissions** | Administrator | Administrator | | **Network** | For oscdimg.exe download | Stable connection | **Additional Requirements:** - Windows ADK (optional, oscdimg.exe auto-downloaded if missing) - Valid Windows 11 ISO file - Antivirus temporarily disabled (optional, may interfere) ### For Running Built ISOs **✅ System requirements are bypassed!** Tiny11 can run on: - **CPU**: Any x64/ARM64 processor (Pentium, Core 2 Duo, etc.) - **RAM**: 1GB minimum (2GB+ recommended) - **Storage**: 10GB minimum (20GB+ recommended) - **TPM**: Not required (completely bypassed) - **Secure Boot**: Not required (bypassed) - **UEFI/BIOS**: Both supported **✨ Perfect for:** - Old laptops (2010+) - Low-spec hardware - Virtual machines - Testing environments - Educational purposes ## 🏗️ GitHub Actions Workflows ### Automated Builds via CI/CD #### 1. Build Tiny11 (Standard) **File**: `.github/workflows/build-tiny11.yml` **Inputs:** windows_iso_url: # Windows 11 ISO download URL required: true image_index: # Windows edition type: choice options: [1, 4, 6, 7] # Home, Education, Pro, Pro N skip_cleanup: # Debug mode (keep artifacts) type: boolean default: false #### 2. Build Tiny11 Core (Ultra-Minimal) **File**: `.github/workflows/build-tiny11-core.yml` **Inputs:** windows_iso_url: # Same as Standard image_index: # Same as Standard skip_cleanup: # Same as Standard enable_dotnet35: # 🆕 Enable .NET Framework 3.5 type: boolean default: false #### 3. Build Nano11 (EXTREME Minimal) **File**: `.github/workflows/build-nano11.yml` **Inputs:** windows_version: # Version string (24H2, 25H2, etc.) required: true windows_iso_url: # Same as above image_index: # Same as above language: # Language name (English, etc.) default: "English" skip_cleanup: # Same as above ### Workflow Features ✨ **Automated download** - Fetches ISO automatically 🔐 **Checksum verification** - Validates ISO integrity 📢 **Discord notifications** - Real-time build status 📦 **Artifact upload** - ISO + checksums available 🚀 **SourceForge deployment** - Automatic release distribution 📊 **Build statistics** - Performance metrics tracked ## 📊 Build Performance | Variant | Download Time | Build Time | Total Time | Output Size | |---------|--------------|------------|------------|-------------| | **Standard** | 5-15 min | 45-80 min | **50-95 min** | ~4-5GB | | **Core** | 5-15 min | 30-45 min | **35-60 min** | ~3-4GB | | **Nano** | 5-15 min | <40 min | **~45-55 min** | ~2-2.9GB | *Build times measured on GitHub Actions standard runners (2-core, 7GB RAM)* **Factors affecting build time:** - ISO download speed - Number of apps to remove (more apps = longer compression) - WinSxS optimization (Core/Nano) - Runner performance - Concurrent builds ## 🐛 Troubleshooting ### Common Issues & Solutions

"Script must run as Administrator"

**Problem**: PowerShell not running with elevated privileges **Solutions:** 1. Right-click PowerShell → "Run as Administrator" 2. Let script auto-elevate (it will restart automatically) 3. In VS Code: Run as admin before opening

"Insufficient disk space"

**Problem**: Not enough free space on C:\ drive **Solutions:** 1. Free up at least 30GB on C:\ 2. Use `-SCRATCH` parameter to specify different drive: .\tiny11maker-headless.ps1 -ISO E -INDEX 1 -SCRATCH D 3. Clean Windows temp files: `cleanmgr` 4. Check disk space: `Get-PSDrive C`

"ISO creation fails" / "oscdimg.exe error"

**Problem**: Missing oscdimg.exe or corrupted installation **Solutions:** 1. Install Windows ADK: - Download: https://learn.microsoft.com/en-us/windows-hardware/get-started/adk-install - Install "Deployment Tools" only 2. Let script download oscdimg.exe automatically (requires internet) 3. Verify antivirus isn't blocking the script 4. Check file permissions on script directory

"Build failures in GitHub Actions"

**Problem**: Workflow fails during automated build **Solutions:** 1. Check workflow logs for specific error 2. Enable `skip_cleanup: true` to preserve artifacts 3. Verify ISO URL is accessible and correct 4. Check if SourceForge credentials are configured (for upload) 5. Ensure GitHub Actions has sufficient runner space **Common causes:** - Invalid ISO URL (404 error) - Network timeout during download - Insufficient runner disk space - SourceForge API rate limiting

"ISO boots but shows errors"

**Problem**: Generated ISO boots but has missing features **Solutions:** 1. Verify you used the correct variant: - Standard: Most features intact - Core: Some features unavailable - Nano: Many features broken (expected) 2. Check if you need .NET 3.5 (Core only): -ENABLE_DOTNET35 3. For printing issues: Don't use Nano variant 4. For Windows Defender: Use Standard variant 5. Rebuild with Standard variant if Core/Nano too aggressive

"Checksums don't match"

**Problem**: Downloaded ISO checksum verification fails **Solutions:** 1. Re-download ISO from official source 2. Verify download completed fully (check file size) 3. Scan for disk errors: `chkdsk /f` 4. Try different download mirror 5. Compare with official checksums from Microsoft **Verify checksum:** Get-FileHash -Path "tiny11.iso" -Algorithm SHA256

## 🔐 Security Considerations ### ⚠️ Important Security Information **Before using Tiny11:** 1. **Modified Windows Images** → May have security implications - No official Microsoft support - Potential compatibility issues - Use at your own risk 2. **Windows Defender Removed** (Core/Nano) - Install third-party antivirus (Avast, Kaspersky, etc.) - Keep antivirus updated - Consider using Standard variant for better security 3. **Updates Disabled by Default** - Manually enable if needed: `services.msc` → Windows Update - No automatic security patches - Monitor security advisories manually 4. **Privacy vs. Functionality Trade-off** - Telemetry disabled → Better privacy - Some features may not work without telemetry - Cloud features limited/disabled 5. **Production Use NOT Recommended** - Use for testing/development only - Not suitable for business-critical systems - Consider official Windows for production ### 🔒 Security Best Practices ✅ **Download from official sources only** - SourceForge: https://sourceforge.net/projects/tiny-11-releases/ - GitHub: https://github.com/kelexine/tiny11-automated ✅ **Verify checksums before installation** Get-FileHash -Path "tiny11.iso" -Algorithm SHA256 # Compare with official checksum ✅ **Test in VM before bare-metal installation** - Use VirtualBox, Hyper-V, or VMware - Verify functionality meets your needs - Check for compatibility issues ✅ **Backup important data before installing** - Full system backup recommended - Document current configuration - Have recovery media ready ✅ **Use valid Windows license** - Tiny11 is NOT a Windows activator - Legal Windows license required - Respect Microsoft's terms of service ### 🚨 Vulnerability Reporting Found a security issue? **DO NOT create a public GitHub issue!** 📧 **Email**: frankiekelechi@gmail.com 🔒 **Subject**: `[SECURITY] Tiny11 Vulnerability Report` 📋 **See**: [SECURITY.md](SECURITY.md) for full disclosure policy ## 📖 Documentation ### 📚 Available Documentation - **[README.md](README.md)** - This file (overview & quick start) - **[CONTRIBUTING.md](CONTRIBUTING.md)** - How to contribute - **[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)** - Community guidelines - **[SECURITY.md](SECURITY.md)** - Security policy & reporting - **[LICENSE](LICENSE)** - MIT License terms - **[SOURCEFORGE_README.md](SOURCEFORGE_README.md)** - SourceForge-specific info ### 🎓 Tutorials & Guides - **Windows Edition Index Numbers**: - `1` = Windows 11 Home - `4` = Windows 11 Education - `6` = Windows 11 Pro - `7` = Windows 11 Pro N (without media features) - **Finding Edition Index**: # Mount ISO first, then: dism /Get-WimInfo /WimFile:E:\sources\install.wim - **Manual OOBE Bypass**: Edit `autounattend.xml` for custom configurations ### Ways to Contribute - 🐛 [Report bugs](https://github.com/kelexine/tiny11-automated/issues/new?template=bug_report.yml) - ✨ [Request features](https://github.com/kelexine/tiny11-automated/issues/new?template=feature_request.yml) - 📝 Improve documentation - 🧪 Test new builds - 💻 Submit pull requests - 🌍 Translate documentation - ⭐ Star the repository ### Contribution Guidelines ### 🧪 Scraper Unit Testing For Python automation components (such as `scripts/microsoft_direct_downloader.py`), a robust unit and integration test suite is located in the `tests/` directory. To run the test suite in an isolated environment: # 1. Set up a local virtual environment python3 -m venv .venv source .venv/bin/activate # 2. Install dependencies & test requirements pip install -r requirements.txt pytest pytest-asyncio # 3. Execute the test suite pytest tests/test_microsoft_downloader.py This test suite uses complete mock coverage of Playwright page locators and user-agent rotations to validate scraper behavior without performing live requests. ### Contributor Recognition - Release notes - CONTRIBUTORS.md file - Project README - Special Discord role (if applicable) ### Connect With Us ### Get Help 1. **Read the docs** - Check README and wiki first 2. **Search issues** - Someone may have asked before 3. **Ask in Discord** - Fastest real-time help 4. **Create discussion** - For general questions 5. **File issue** - For confirmed bugs only ## 📝 License ### Licensing Information - **Tiny11 Automated** (headless scripts, CI/CD): MIT License © 2025 kelexine - **Original tiny11builder** (BASE scripts): MIT License © ntdevlabs - **Individual files**: See copyright notices in each file ### MIT License Summary ✅ **Permitted**: - Commercial use - Modification - Distribution - Private use ❌ **Limitations**: - No warranty - No liability 📋 **Conditions**: - License and copyright notice must be included - Proper attribution required **Full license**: [LICENSE](LICENSE) ## ⚖️ Disclaimer ### Legal Disclaimer **This tool is provided "as is" without warranty of any kind, express or implied.** The authors (kelexine, ntdevlabs) are **NOT responsible** for: ❌ System damage from using modified Windows images ❌ Data loss or corruption ❌ Violation of Microsoft's terms of service ❌ Legal issues from improper use ❌ Compatibility problems ❌ Security vulnerabilities ❌ Performance issues ### Your Responsibilities ✅ **You must** have a valid Windows license ✅ **You must** understand the risks ✅ **You must** backup your data ✅ **You must** comply with applicable laws ✅ **You must** use responsibly and ethically **Use at your own risk.** See [LICENSE](LICENSE) and [SECURITY.md](SECURITY.md) for details. ## 🔗 Important Links ### Official Resources - **📦 GitHub Repository**: https://github.com/kelexine/tiny11-automated - **📥 SourceForge Downloads**: https://sourceforge.net/projects/tiny-11-releases/files/ - **🐛 Issue Tracker**: https://github.com/kelexine/tiny11-automated/issues - **📋 Releases**: https://github.com/kelexine/tiny11-automated/releases (notes only) - **💬 Discussions**: https://github.com/kelexine/tiny11-automated/discussions ### Related Projects - **🔧 Original tiny11builder**: https://github.com/ntdevlabs/tiny11builder - **🪟 Microsoft Windows 11**: https://www.microsoft.com/software-download/windows11 - **🛠️ Windows ADK**: https://learn.microsoft.com/windows-hardware/get-started/adk-install ### Author - **👨‍💻 kelexine**: [GitHub](https://github.com/kelexine) | [Telegram](https://t,me/kelexine2) - **✉️ Email**: [Email Me](frankiekelechi@gmail.com) - **💖 Sponsor**: [GitHub Sponsors](https://github.com/sponsors/kelexine) or [Buy Me a Coffee](https://buymeacoffee.com/kelexine) ## 🙏 Acknowledgments ### Special Thanks - **ntdevlabs** - Creator of original tiny11builder - **Microsoft** - Windows 11 operating system - **Community contributors** - Bug reports, feature requests, and PRs - **2,000+ users worldwide** - Your feedback drives improvement

标签：Libemu