https://eltonaguiar.github.io/BOOTFIXPREMIUM_GITHUB/
Version: 7.2.0 (STABLE)
Last Updated: January 11, 2026
Status: β
Production Ready - All Critical Fixes Applied
MiracleBoot is a comprehensive Windows system recovery and boot repair solution designed for IT professionals, system administrators, and advanced users. It works in multiple environmentsβfrom emergency recovery consoles to fully booted Windows systemsβproviding powerful diagnostic, repair, and backup tools when you need them most.
Sample interface of our sister project very similar:
β
π― What MiracleBoot Does
MiracleBoot solves critical Windows boot and system recovery problems:
- β
Boot Failures - Repair corrupted BCD (Boot Configuration Data), missing boot files, UEFI/BIOS issues
- β
WinRE Detection - Automatically detects and fixes when default boot entry points to Windows Recovery Environment instead of actual Windows installation
- β
Driver Problems - Detect and inject missing storage drivers (NVMe, RAID, Intel VMD) causing 0x7B BSOD
- β
Installation Failures - Diagnose why Windows Setup failed with detailed log analysis
- β
System Diagnostics - Analyze boot logs, event logs, BSOD stop codes, and hardware compatibility
- β
Offline Repairs - Perform registry edits, driver injection, and system analysis from WinPE/WinRE
- β
CMD-Only Repairs - Pure CMD-based emergency fixes that work without PowerShell dependencies
- β
Educational Content - Learn about recovery tools, backup strategies, and unofficial repair methods
π Quick Start
Download from GitHub
Option 1: Clone Repository (Recommended)
git clone https://github.com/eltonaguiar/BOOTFIXPREMIUM_GITHUB.git
cd BOOTFIXPREMIUM_GITHUB
.\RunMiracleBoot.cmd
Option 2: Download ZIP
- Visit: https://github.com/eltonaguiar/BOOTFIXPREMIUM_GITHUB
- Click βCodeβ β βDownload ZIPβ
- Extract and run
RunMiracleBoot.cmd
Option 3: Quick PowerShell Download
$url = 'https://github.com/eltonaguiar/BOOTFIXPREMIUM_GITHUB/archive/refs/heads/main.zip'
$output = '$env:TEMP\MiracleBoot.zip'
Invoke-WebRequest -Uri $url -OutFile $output
Expand-Archive -Path $output -DestinationPath '$env:TEMP\MiracleBoot' -Force
cd '$env:TEMP\MiracleBoot\BOOTFIXPREMIUM_GITHUB-main'
.\RunMiracleBoot.cmd
For Windows 10/11 Users (GUI Mode):
- Download the repository as ZIP or clone
- Extract to a convenient location (e.g.,
C:\MiracleBoot)
- Right-click
MiracleBoot.ps1 β Run with PowerShell (as Administrator)
- If execution policy error appears, run:
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
.\MiracleBoot.ps1
For Recovery Environment (TUI Mode):
- Copy the entire folder to a USB drive or accessible drive from WinRE/WinPE
- Boot into Windows Recovery Environment (Advanced Startup β Troubleshoot β Command Prompt)
- Or press Shift+F10 during Windows Setup
- Navigate to the folder (e.g.,
D:\MiracleBoot)
- Run:
RunMiracleBoot.cmd
- If batch file fails, manually run:
powershell -ExecutionPolicy Bypass -File MiracleBoot.ps1
Quick Command for Windows RE (Shift+F10) - Download from GitHub
Complete Command Sequence:
REM Step 1: Enable Internet
wpeinit
netsh interface set interface "Ethernet" admin=enable
netsh interface set interface "Local Area Connection" admin=enable
netsh interface ip set address name="Ethernet" source=dhcp
netsh interface ip set dns name="Ethernet" static 8.8.8.8
ipconfig /renew
ping -n 2 github.com
REM Step 2: Download and Run Emergency Fix V4
curl -L -o "%TEMP%\EMERGENCY_BOOT_REPAIR_V4.cmd" "https://raw.githubusercontent.com/eltonaguiar/BOOTFIXPREMIUM_GITHUB/main/EMERGENCY_BOOT_REPAIR_V4.cmd" && "%TEMP%\EMERGENCY_BOOT_REPAIR_V4.cmd"
Or use the all-in-one script:
REM Download QUICK_INTERNET_AND_FIX.cmd to USB, then run:
D:\QUICK_INTERNET_AND_FIX.cmd
π₯οΈ Supported Environments
MiracleBoot adapts to your environment with two interfaces:
1. π» Graphical User Interface (GUI) - Windows 10/11 Full OS
Best for: Desktop users, visual learners, comprehensive diagnostics
Requirements:
- Windows 10/11 with desktop environment
- .NET Framework 4.5+ (for WPF)
- Administrator privileges
Features:
- 8-tab interface with visual BCD editor
- Boot menu simulator (WYSIWYG preview)
- Driver diagnostics with export capabilities
- One-click repair operations with test mode
- Repair Wizard (intelligent repair sequence)
- Emergency fixes (V1-V4) with individual buttons
- CMD-only repair option (no PowerShell required)
- System diagnostics & log analysis
- Log management (clear all logs or logs over 48 hours)
- Recommended tools guide with backup wizard
Launch: Double-click MiracleBoot.ps1 or run from PowerShell with admin rights
2. β¨οΈ Text User Interface (TUI) - WinPE/WinRE/Shift+F10
Best for: Recovery environments, Shift+F10 command prompts, minimal installations
Requirements:
- Windows Recovery Environment (WinRE)
- Windows Preinstallation Environment (WinPE)
- Command Prompt in recovery mode (Shift+F10 at Windows Setup)
- PowerShell 5.0+ (available in modern WinRE/WinPE)
Features:
- MS-DOS style menu for keyboard navigation
- Volume listing & driver scanning
- BCD viewing & editing
- Offline driver injection
- Recommended tools guide
- Utility launcher (Notepad, Registry Editor, etc.)
Launch: From recovery command prompt, run RunMiracleBoot.cmd or directly powershell -ExecutionPolicy Bypass -File MiracleBoot.ps1
π§ Environment Compatibility Matrix
| Environment |
GUI Available |
TUI Available |
PowerShell Required |
Internet Access |
Typical Use Case |
| Windows 10/11 Full OS |
β
Yes |
β
Yes |
β
Yes (built-in) |
β
Usually |
Pre-boot diagnostics, BCD management |
| WinRE (Recovery) |
β No* |
β
Yes |
β
Yes |
β οΈ Maybe** |
Boot repair, driver injection, offline diagnostics |
| WinPE (Bootable USB) |
β No* |
β
Yes |
β
Yes |
β οΈ Maybe** |
System rescue, clean installs, driver loading |
| Shift+F10 (Setup) |
β No |
β
Yes |
β
Yes |
β Usually not |
Emergency repairs during failed installation |
| Safe Mode |
β
Yes |
β
Yes |
β
Yes |
β
Usually |
Diagnose boot loops, malware recovery |
* WPF GUI requires desktop environment; WinRE/WinPE typically lack this. TUI mode activates automatically.
** Network drivers may need manual enablement. See Network Connectivity section below.
π‘οΈ Key Features
1οΈβ£ BCD Management & Boot Repair
- Comprehensive BCD Parsing - View all boot entries with ALL properties
- Visual Boot Menu Simulator - Preview how boot menu will appear
- Duplicate Entry Detection - Auto-detect and rename duplicate boot entries
- Multi-EFI Partition Sync - Sync BCD across all EFI partitions (multi-disk setups)
- Automated Boot Diagnosis - One-click comprehensive boot issue detection
- WinRE Detection & Auto-Fix - Automatically detects when default entry points to Windows Recovery Environment and fixes it
- Backup Before Modify - Automatic timestamped BCD backups before changes
Common Tasks:
- Rebuild BCD from Windows installation (
bcdboot)
- Fix boot files (
bootrec /fixboot, /fixmbr)
- Scan for Windows installations (
bootrec /scanos)
- Set default boot entry and timeout
2οΈβ£ Emergency Boot Repairs
Emergency Fix V1 (Standard Repair)
- Comprehensive boot repair using standard Windows tools
- Rebuilds BCD, fixes boot files, scans for installations
- Standalone CMD file - no dependencies required
Emergency Fix V2 (Alternative Implementation)
- Alternative implementation with different coding approach
- Uses goto-based flow control
- Standalone CMD file
Emergency Fix V3 (Minimal Last Resort)
- Minimal implementation using only basic commands
- No complex nested structures
- Last resort when other fixes fail
Emergency Fix V4 (Intelligent Minimal Repair) β RECOMMENDED
- Intelligent diagnostics - checks issues first
- Only fixes whatβs actually broken (fastest)
- Progress percentage display (0-100%)
- Shows exact commands being executed
- Skips unnecessary commands based on diagnostics
Comprehensive Boot Repair (CMD-Only)
- All-in-one standalone repair tool
- Runs all emergency fixes sequentially (V4 β V1 β V2 β V3)
- Validates boot readiness after each repair
- Stops when boot is fixed
- No PowerShell required - pure CMD commands
Repair Wizard
- Guided repair sequence: V4 (Intelligent) β Brute Force β V1 β V2 β V3
- Checks boot readiness after each step
- Stops if boot is fixed
- Offers to continue if a fix fails
- Automatically fixes WinRE default entry issues
3οΈβ£ Driver Diagnostics & Management
- Missing Driver Detection - Identify devices with driver errors (Code 28, 1, 3)
- Hardware ID Forensics - Match missing drivers to INF files (Intel VMD, NVMe, RAID)
- Driver Export - Export in-use drivers to file for offline installation
- Driver Extraction - Extract actual driver files from DriverStore
- DISM Offline OS Injection - Inject drivers to offline Windows (C:) using DISM
- DISM WIM Injection - Inject drivers to boot.wim and install.wim recovery images
- Batch Driver Injection - Multi-target injection with progress tracking and rollback
- Snappy Driver Installer Integration - Auto-detect and download missing drivers
- Driver Compatibility Validation - Pre-injection verification and checkpoints
- Live Driver Loading - Load harvested drivers in WinPE/WinRE
Supported Driver Types:
- Intel VMD (Volume Management Device)
- Intel RST (Rapid Storage Technology)
- NVMe storage controllers
- AMD RAID
- USB 3.x controllers
- Network adapters (NIC)
- Chipset drivers
Driver Injection Environments:
- β
Offline Windows OS (from WinPE/WinRE)
- β
WIM boot images (boot.wim for PE, install.wim for setup)
- β
Recovery environments (WinRE)
- β
Windows installation media
Critical Fixes:
- INACCESSIBLE_BOOT_DEVICE (storage driver missing)
- No network in recovery (NIC drivers)
- NVMe drive not detected (requires chipset driver pre-injection)
4οΈβ£ Advanced Diagnostics
- Boot Log Analysis - Parse
ntbtlog.txt for driver load failures
- Event Log Analysis - Scan
System.evtx for BSOD, shutdown events
- BSOD Stop Code Explanations - Human-readable causes for blue screens
- Setup Log Analysis - Parse Panther logs to diagnose installation failures
- Filter Driver Forensics - Detect problematic third-party storage filters (Acronis, Symantec)
- Hardware Support Info - Get manufacturer support URLs for drivers
- System Restore Detection - Check for available restore points (offline/online)
- WinRE Health Check - Validate Windows Recovery Environment configuration
- Offline OS Information - Extract version/edition/build from offline registry
- Registry Override Scripts - Generate EditionID override scripts for ISO compatibility
- One-Click Registry Fixes - Apply all compatibility overrides with backups
6οΈβ£ Log Management
- Clear All Logs - Delete all log files from all log directories
- Clear Old Logs - Delete log files older than 48 hours
- Log Directories:
LOGS_MIRACLEBOOT (main logs)
LOGS (analysis logs)
TEST_LOGS (test logs)
LOG_ANALYSIS (log analysis results)
- WINRE_NETWORK_INIT.cmd - Quick network initialization for WinRE/Shift+F10
- QUICK_INTERNET_AND_FIX.cmd - All-in-one script to enable internet and download/run emergency fix from GitHub
- Automatic Network Detection - Detects and enables network adapters
- DNS Configuration - Sets DNS to 8.8.8.8 (Cloudflare) for reliable connectivity
8οΈβ£ Experimental Features
β οΈ Use with caution - advanced/hacky methods
- Repair Install Forcing (Online) - Force in-place upgrade from inside Windows
- Repair Install Forcing (Offline) - Trick Setup into repairing offline OS from WinPE
- Cloud Repair Integration - Instructions for Windows 11 hidden cloud repair feature
9οΈβ£ Educational Content
- Recommended Tools Guide - Curated list of free/paid recovery tools
- Backup Strategy Wizard - Interactive 3-2-1 backup planning
- Unofficial Repair Tips - Community-sourced workarounds from MDL forums
- Command Explanations - Learn what each command does and why
- Boot Fixer Instructions - Comprehensive guide for running in Windows Repair environment
π¦ Whatβs Included
Core Files:
Root Directory:
MiracleBoot.ps1 - Main launcher (auto-detects environment)
RunMiracleBoot.cmd - Batch launcher for recovery environments
HELPER SCRIPTS Directory:
WinRepairCore.ps1 - Function library (2000+ lines of diagnostic/repair logic)
WinRepairGUI.ps1 - Graphical interface (for Full OS)
WinRepairGUI.xaml - WPF UI definition file
WinRepairTUI.ps1 - Text interface (for WinRE/WinPE)
DefensiveBootCore.ps1 - Advanced boot repair engine (Brute Force, One-Click Repair)
Emergency Repair Scripts (Standalone CMD - No PowerShell Required):
EMERGENCY_BOOT_REPAIR.cmd - Emergency Fix V1 (Standard Repair)
EMERGENCY_BOOT_REPAIR_V2.cmd - Emergency Fix V2 (Alternative Implementation)
EMERGENCY_BOOT_REPAIR_V3.cmd - Emergency Fix V3 (Minimal Last Resort)
EMERGENCY_BOOT_REPAIR_V4.cmd - Emergency Fix V4 (Intelligent Minimal Repair) β
EMERGENCY_BOOT_REPAIR_WRAPPER.cmd - Runs all fixes sequentially with automatic failover
COMPREHENSIVE_BOOT_REPAIR.cmd - All-in-one CMD-only repair (runs all fixes until boot is restored)
Network & Quick Access Scripts:
WINRE_NETWORK_INIT.cmd - Enable internet in Windows RE
QUICK_INTERNET_AND_FIX.cmd - Enable internet + download/run emergency fix from GitHub
Folder Structure:
MiracleBoot/
βββ MiracleBoot.ps1 # Main entry point
βββ RunMiracleBoot.cmd # Batch launcher
βββ EMERGENCY_BOOT_REPAIR*.cmd # Emergency fix scripts
βββ COMPREHENSIVE_BOOT_REPAIR.cmd
βββ QUICK_INTERNET_AND_FIX.cmd
βββ WINRE_NETWORK_INIT.cmd
βββ SHIFT_F10.cmd
βββ README.md # Main documentation
βββ README_SHAREABLE_GITHUB_VERSION.md # Commercial version
βββ HELPER SCRIPTS/ # Core modules and utilities
β βββ WinRepairCore.ps1 # Core function library
β βββ WinRepairGUI.ps1 # GUI interface
β βββ WinRepairGUI.xaml # WPF UI definition
β βββ WinRepairTUI.ps1 # Text interface
β βββ DefensiveBootCore.ps1 # Advanced boot repair
β βββ [Other helper scripts...]
βββ DOCUMENTATION/ # All documentation files
βββ DOCS/ # Additional documentation
βββ TEST/ # Test scripts
βββ DEBUG/ # Debug and diagnostic scripts
βββ VALIDATION/ # Validation and QA scripts
βββ ARCHIVE/ # Archived files
βββ LOGS_MIRACLEBOOT/ # Main log directory
βββ LOGS/ # Analysis logs
βββ TEST_LOGS/ # Test logs
βββ LOG_ANALYSIS/ # Log analysis results
Documentation:
README.md - This file (main user guide)
README_SHAREABLE_GITHUB_VERSION.md - Commercial distribution version (no GitHub links)
DOCUMENTATION/ - Comprehensive documentation, guides, and reports
DOCS/ - Additional documentation and implementation summaries
π Network Connectivity in Recovery Environments
Default Network Status:
| Environment |
Network Adapters |
Internet Access |
Browser Available |
| Full OS |
β
Enabled |
β
Yes |
β
Yes (Edge/Chrome) |
| WinRE |
β οΈ Usually disabled |
β No |
β No |
| WinPE |
β οΈ Depends on build |
β οΈ Maybe |
β οΈ Custom only |
| Shift+F10 |
β Disabled |
β No |
β No |
Enabling Network in Recovery:
Option 1: Use WINRE_NETWORK_INIT.cmd
WINRE_NETWORK_INIT.cmd
Option 2: Manual Network Adapter Enablement
wpeinit
netsh interface set interface "Ethernet" admin=enable
netsh interface ip set address name="Ethernet" source=dhcp
netsh interface ip set dns name="Ethernet" static 8.8.8.8
ipconfig /renew
Option 3: PowerShell Network Configuration
Get-NetAdapter | Where-Object {$_.Status -eq 'Disabled'} | Enable-NetAdapter
β οΈ Safety Features
MiracleBoot includes multiple safety mechanisms:
- β
Test Mode - Preview commands before execution (Boot Fixer tab)
- β
Automatic Backups - BCD backed up before modifications
- β
BitLocker Warnings - Alerts before operations that may lock encrypted drives
- β
Confirmation Dialogs - Required for all destructive operations
- β
Registry Backups - Created before registry overrides
- β
Operation Logging - All actions logged for audit trail
- β
WinRE Detection - Automatically detects and fixes when default entry points to WinRE instead of Windows installation
- β
Boot Readiness Checks - Comprehensive validation after each repair
π System Requirements
Minimum:
- Windows 10 1809+ or Windows 11
- PowerShell 5.0+ (for GUI/TUI modes)
- 2GB RAM
- Administrator privileges
Recommended:
- Windows 11 22H2+
- PowerShell 7.x
- 4GB+ RAM
- SSD for faster diagnostics
For WinRE/WinPE:
- Modern WinRE (Windows 10 1809+)
- PowerShell support in WinPE (included in modern builds)
- Note: Emergency fixes (V1-V4) work without PowerShell - pure CMD only
π Version History
v7.2.0 (Current - January 11, 2026)
- β
Added CMD-only repair option (no PowerShell required)
- β
WinRE detection and auto-fix functionality
- β
Log management (clear all logs or logs over 48 hours)
- β
Quick GitHub download commands for Windows RE
- β
Network initialization scripts (WINRE_NETWORK_INIT.cmd, QUICK_INTERNET_AND_FIX.cmd)
- β
Repair Wizard with intelligent repair sequence
- β
Individual emergency fix buttons (V1-V4)
- β
Enhanced boot readiness checks (detects WinRE entries)
- β
Comprehensive Boot Fixer Instructions
- β
Recommended Tools feature
- β
Backup Strategy Wizard
- β
Environment detection display
- β
Enhanced TUI with tools menu
v7.1.1
- Initial GitHub release
- Comprehensive BCD management
- Driver forensics & diagnostics
- Setup log analysis
π§ Roadmap (v7.3+)
Coming Soon:
- π Network connectivity auto-detection & enablement
- π Text-based browser for ChatGPT/help access
- β οΈ Enhanced safety warnings before destructive operations
- π Windows installation failure reason checker
- π§ Additional CMD-only repair options
π€ Contributing
Contributions welcome! Areas for improvement:
- Network connectivity automation
- Browser integration for WinPE
- Multi-language support
- Additional driver database
- Cloud repair feature integration
π License
This project is provided as-is for educational and recovery purposes. Always create backups before using system repair tools.
π Support & Resources
- GitHub Issues: Report bugs or request features
- Unofficial Repair Tips: See βDiagnostics & Logsβ tab β βUnofficial Repair Tipsβ
- Community Forums: Win-Raid, MDL Forum (for advanced discussions)
- Email: zerounderscore@gmail.com
Made with β€οΈ for Windows recovery professionals
βWhen Windows wonβt boot, MiracleBoot will.β