MCPcopy Index your code
hub / github.com/NORMAL-EX/LetRecovery

github.com/NORMAL-EX/LetRecovery @2026.6.28

Chat with this repo
repository ↗ · DeepWiki ↗ · release 2026.6.28 ↗ · + Follow
2,144 symbols 5,201 edges 217 files 1,124 documented · 52% updated 1d ago2026.6.28 · 2026-06-28★ 1,044
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

LetRecovery

A Free and Open-Source Windows System Reinstallation Tool

English | 简体中文

License Rust Platform

image


💡 LetRecovery is free and open-source, forever. Please get it only from the official channels listed below — beware of third-party paid resellers.

✨ Features

🖥️ System Installation

  • Multi-format images - WIM / ESD / SWM / GHO / ISO (including Windows XP / 2003 i386 text-mode setup), auto mount & parse, multi-edition selection
  • Desktop & WinPE - One-click deploy from desktop; when reinstalling the current system drive it auto-writes boot and reboots into WinPE to finish
  • BitLocker-encrypted system reinstall - Automatically unlocks/decrypts the BitLocker-encrypted system drive before deployment
  • Unattended install - Built-in generated or custom unattend.xml, and auto-detects answer files embedded in the source image / install media to default the checkbox accordingly
  • Boot mode - UEFI / Legacy auto-detected, manually selectable

💾 System Backup

  • Full / incremental backup - Back up the system partition to WIM / ESD / SWM / GHO
  • Custom name & description

🌐 Online Download

  • System images / common software - Fetched online, accelerated by multi-threaded Aria2

🔧 Advanced Options

  • Format partition, boot repair (UEFI / Legacy)
  • Driver export (DISM API) / import, storage-controller driver injection
  • Registry injection, remove preinstalled UWP apps, OOBE bypass, disable Update / Defender and other tweaks
  • WiFi profile migration

🛠️ Toolbox

  • BitLocker management - unlock / decrypt / suspend·resume protection / view recovery key
  • Password reset - clear account password online (current system) or offline (other systems)
  • Image verify / file hash verify - check image integrity before deployment
  • Quick partition / partition clone / batch format
  • Losslessly expand C: drive - losslessly expand the current system C: drive: auto-downloads WinPE if missing, installs PE boot, then reboots into WinPE to resize
  • Driver backup & restore, import storage drivers
  • Remove APPX apps, NVIDIA driver uninstall, time sync, view GHO password, SpaceSniffer disk analysis, one-click boot repair

🚀 Quick Start

System Requirements

  • Windows 10/11 (64-bit)
  • Administrator privileges
  • At least 4GB available memory
  • UEFI or Legacy BIOS boot support

Usage

  1. Download - Get the latest version from Releases
  2. Run as Administrator - Right-click the program and select "Run as administrator"
  3. Select Image - Choose local or online image in "System Install" page
  4. Select Target Partition - Choose the target partition for system installation
  5. Start Installation - Click the "Start Install" button

⚠️ Warning: System installation will format the target partition. Please backup important data first!


📁 Project Structure

LetRecovery/
├── 正常系统端/          # Windows Desktop Environment Version
│   ├── src/
│   │   ├── app.rs       # Main application
│   │   ├── core/        # Core modules
│   │   │   ├── bcdedit.rs   # BCD boot editing
│   │   │   ├── disk.rs      # Disk partition management
│   │   │   ├── dism.rs      # DISM image operations
│   │   │   ├── ghost.rs     # GHO image restoration
│   │   │   └── registry.rs  # Registry operations
│   │   ├── download/    # Download management
│   │   │   ├── aria2.rs     # Aria2 download engine
│   │   │   └── manager.rs   # Download manager
│   │   ├── ui/          # User interface
│   │   └── utils/       # Utility functions
│   └── Cargo.toml
├── PE端/               # WinPE Environment Version
│   ├── src/
│   │   ├── app.rs
│   │   ├── core/
│   │   ├── ui/
│   │   └── utils/
│   └── Cargo.toml
└── LICENSE

🛠️ Tech Stack

Technology Purpose
Rust Primary programming language
egui/eframe Cross-platform GUI framework
tokio Async runtime
windows-rs Windows API bindings
aria2 High-speed download engine
DISM System image deployment
Ghost GHO image restoration

🏗️ Building from Source

Prerequisites

  • Rust 1.75 or higher
  • Visual Studio Build Tools (Windows)

Build Steps

# Clone the repository
git clone https://github.com/NORMAL-EX/LetRecovery.git
cd LetRecovery

# Build Normal System Version
cd 正常系统端
cargo build --release

# Build PE Version
cd ../PE端
cargo build --release

📄 License

This project is licensed under the PolyForm Noncommercial License 1.0.0.

  • ✅ Personal learning, research, and non-commercial use allowed
  • ✅ Modification and distribution allowed (with copyright notice)
  • ❌ Commercial use prohibited

🙏 Acknowledgments

  • System images and PE download services provided by Cloud-PE
  • Thanks to 电脑病毒爱好者 for providing WinPE

👤 Author

NORMAL-EX (also known as dddffgg)


🔗 Links


If you find this project helpful, please give it a ⭐ Star!

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Function 964
Method 894
Class 215
Enum 49
Interface 22

Languages

Rust83%
TypeScript17%

Modules by API surface

正常系统端/src/core/hardware_info.rs91 symbols
正常系统端/src/core/bitlocker.rs69 symbols
lr-core/src/fveapi.rs52 symbols
正常系统端/src/ui/advanced_options.rs45 symbols
正常系统端/src/core/quick_partition.rs44 symbols
lr-core/src/wimlib.rs44 symbols
lr-core/src/driver.rs44 symbols
正常系统端/src/app.rs42 symbols
正常系统端/src/core/image_verify.rs37 symbols
PE端/src/core/system_utils.rs36 symbols
正常系统端/src/core/dism_cmd.rs34 symbols
正常系统端/src/core/disk.rs34 symbols

For agents

$ claude mcp add LetRecovery \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page