explaingit

aveyo/mediacreationtool.bat

10,210BatchfileAudience · generalComplexity · 2/5Setup · easy

TLDR

A Windows batch script that extends Microsoft's Media Creation Tool to support flexible Windows 10/11 downloads, edition upgrades for LTSC systems, TPM bypass for Windows 11, and automated ISO or USB creation.

Mindmap

mindmap
  root((repo))
    What it does
      Auto upgrade Windows
      Create bootable USB
      Create ISO image
      Bypass TPM checks
    Preset Modes
      Auto Upgrade
      Auto ISO
      Auto USB
      Manual Select
    Special Features
      Edition mismatch fix
      Registry patching
      Filename config
      Local account support
    Audience
      Windows home users
      IT admins
      LTSC device owners
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Upgrade a Windows LTSC or embedded edition machine to a newer Windows version while keeping your files and apps.

USE CASE 2

Create a bootable USB drive or ISO file for Windows 10 or 11 installation with a single automated step.

USE CASE 3

Install Windows 11 on hardware that fails Microsoft's TPM or CPU compatibility checks.

USE CASE 4

Automate a Windows upgrade that preserves personal files without manually selecting an edition.

Tech stack

BatchfileWindows Registry

Getting it running

Difficulty · easy Time to first run · 5min

In plain English

MediaCreationTool.bat is a Windows batch script that wraps Microsoft's official Media Creation Tool to make downloading and deploying Windows 10 and 11 much more flexible. The standard Media Creation Tool from Microsoft is limited in which editions it can target and how automated the process can be. This script sits on top of it and adds options that are normally not accessible. The script offers five preset modes when you run it. Auto Upgrade downloads the right Windows media for your current system and launches the installer in a way that keeps your files and applications. Auto ISO creates an installer image file on your hard drive. Auto USB writes the installer to a USB drive. Select lets you manually choose the Windows edition, language, and processor architecture. The fifth mode runs the official tool without any modifications for users who only need the standard behavior. What makes this tool notable is how it handles edition mismatches. When you are upgrading a machine running an unusual Windows edition, such as an LTSC or embedded version, the standard installer often refuses to preserve files and apps because the editions do not match. This script adjusts the Windows registry to tell the installer that a compatible edition is present, which allows the upgrade to proceed while keeping your data. You can even rename the script file itself to include the target edition, version number, or language, and the script reads those values from its own filename. For Windows 11 specifically, the script patches the installer media to skip hardware requirement checks, which Microsoft added for TPM, CPU compatibility, and related criteria. It also configures the installer to allow local accounts on Windows 11 Home, which the standard setup tries to prevent. The project grew steadily from 2018 through 2021, adding support for each new Windows version as it released.

Copy-paste prompts

Prompt 1
Using mediacreationtool.bat, walk me through upgrading a Windows 10 LTSC machine to Windows 11 while keeping all my files and installed apps.
Prompt 2
How do I use mediacreationtool.bat to create a Windows 11 ISO on a PC that doesn't meet TPM 2.0 requirements?
Prompt 3
How do I create a bootable USB drive for Windows 10 installation using mediacreationtool.bat in Auto USB mode?
Prompt 4
Can I rename mediacreationtool.bat to target a specific Windows edition and language? Walk me through the naming convention it reads from the filename.
Prompt 5
What registry changes does mediacreationtool.bat make to allow edition-mismatch upgrades, and are they safe to reverse afterward?
Open on GitHub → Explain another repo

← aveyo on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.