UUP to ISO

Overview

Automated windows command script to process Microsoft Windows 11/10 Unified Update Platform files, allowing to build/convert them into a usable state (ISO / WIM).

You can get UUP files by performing upgrade from Windows 11/10 build to a later build (starting 15063, aka version 1703).

You can also obtain UUP canonical source using one of these projects:
UUP dump website
UUP Generation Project

How To Use

Administrator privileges are required to run the script.

Optional: temporary disable AV or protection program so it doesn't interfere with the process.

Make sure the files are not read-only or blocked.

Extract this pack to a folder with simple spaceless path to avoid troubles (example: C:\UUP).

Place the files in "UUPs" folder to be detected automatically, or drag and drop uup files directory on convert-UUP.cmd. Alternatively, you will be prompted to enter other UUP folder path.

If multiple Editions detected, you will be prompted first to select one edition, some editions, or create AIO.

To exit of the prompt or options menu just press "Enter".

Output Choice

1 - Create ISO with install.wim
4 - Create ISO with install.esd

convert UUP files to a regular ISO distribution that contains install.wim or install.esd file.

2 - Create install.wim
5 - Create install.esd

create install.wim/install.esd file only, which can be used with other ISO with the same version or for manual apply using dism, imagex, wimlib.

3 - UUP Edition info

Display info about detected editions (architecture, language, build version, build branch, editions name).

6 - Configuration Options

Change the state of configuration options.

Configuration Options

Control conversion behavior, output and automation.

You have three ways to change the state of these options, where 0 means the option is OFF (no), and 1 means the option is ON (yes):
- edit ConvertConfig.ini under [convert-UUP] and [Store_Apps] sections
- delete ConvertConfig.ini and edit convert-UUP.cmd script directly
- use menu choice 6 (this does not include all options)

AutoStart

Start the conversion process directly without prompts.

This require placing UUP files in UUPs folder, or starting convert-UUP.cmd from command prompt with path to UUP source folder, or drag and drop UUP source folder on convert-UUP.cmd.

Set this option to 1 to create ISO with install.wim
Set this option to 2 to create ISO with install.esd
Set this option to 3 to create install.wim only
Set this option to 4 to create install.esd only

AddUpdates

Update the ISO distribution or install.wim with detected updates after conversion.

Set this option to 1 to integrate updates into wim files
Set this option to 2 to add updates externally to ISO distribution

See Add Updates Option for more details.

StartVirtual

Start create_virtual_editions.cmd directly after conversion is completed.

See Virtual Editions for more details.

wim2esd

Convert install.wim to install.esd at the end.

This option is intended to be used with AddUpdates option.

This option will be auto enabled if you selected install.esd choice and AddUpdates is ON.

Warning: creating install.esd will consume high amount of CPU/RAM, and take considerable time to complete.

wim2swm

Split install.wim into multiple install.swm files.

This option will be auto disabled if install.wim size is below 4 GB.

If both wim2esd/wim2swm are ON, install.esd takes precedence over split install.swm.

SkipISO

If you are not interested to create ISO file currently, or want to create Multi-Architecture ISO (x86/x64) later with multi_arch_iso.cmd, or intend to manually use create_virtual_editions.cmd

SkipWinRE

Do not add winre.wim to install.wim/install.esd, if you are not interested to have recovery environment or want to reduce ISO size/conversion period.. etc.

note: adding winre.wim to install.esd will consume high amount of CPU/RAM.

LCUwinre

Force updating winre.wim with Cumulative Update even if SafeOS update detected.

This option is auto enabled for Windows 11 build 22000 and later, Set this option to 2 to disable.
This option is ignored and auto disabled for builds 26052 and later.

LCUmsuExpand

Expand Cumulative Update and install from loose files via update.mum, instead adding direct msu files.

This option is auto enabled for Windows 11 build 26052 and later, Set this option to 2 to disable.
This option is applicable only for Windows 11 build 22621 and later.

DisableUpdatingUpgrade

Disable updating process optimization by using editions upgrade (Home>Pro / ServerStandard>ServerDatacenter), and perform separate updating for each edition.

This option is auto enabled for Windows 11 build 26000 and later, Set this option to 2 to disable.

UpdtBootFiles

Update ISO boot files bootmgr/memtest/efisys.bin with new files from Cumulative Update.

This option will also update new UEFI CA 2023 boot files if detected. See KB5053484 for more details.

note: the two default files bootmgr.efi/bootmgfw.efi will be updated if this option is OFF.

ForceDism

Use the official method with dism.exe for creating boot.wim, which require Windows 11/10 Host OS or ADK.

RefESD

Keep converted reference ESD files for future operations instead converting them each time.

if UUP source is Express, Reference ESDs and Edition ESDs will be copied to new folder "CanonicalUUP", practically, this convert/backup Express UUP source to Canonical.
if UUP source is Canonical, Reference ESDs will be copied to the same UUP source folder, and original CAB files will be moved to subdirectory "Original".

SkipLCUmsu

Skip creating Cumulative Update MSU for builds 21382 to 25330 (LCU will be added using legacy cab+psf extraction).

SkipEdge

Skip adding Microsoft Edge Chromium
Set option to 1 : Do not add Edge.wim for Windows 11 build 26052 and later
Set option to 1 : Do not integrate Edge with Cumulative Update for Windows 10
Set option to 2 : Skip Edge with Cumulative Update for Windows 10 via alternative workaround (may not work)

This option works only with option AddUpdates=1 (Integrate).

AutoExit

Exit the conversion process (script) on completion without prompt.

useful option for multi batch conversions, best used with AutoStart option.

AddDrivers

Add drivers to install.wim and boot.wim / winre.wim
this is basic feature support, and should be used only with tested working compatible drivers.

* How To Use:
- enable the option
- place the drivers you want to add inside the proper subfolder:
ALL: drivers will be added to all wim files OS: drivers will be added to install.wim only WinPE: drivers will be added to boot.wim / winre.wim only

* Optionally, you can specify different source folder path for drivers, using option Drv_Source
the folder must contain subfolder for each drivers target, as explained above.

* The option will only works alongside integrating Updates or Apps.

* The option will not check or verify drivers, it simply point DISM towards the drivers folders.

* The option is ment for simple and boot critical drivers (chipsets, disk controllers, LAN/WiFi..), to allow easier installation, not for large drivers, or drivers that may break setup.

#############################################################

Below options apply only for Windows 11 build 22563 and later
SkipApps

Do not add Store Apps.

AppsLevel

Control added Apps for Client editions (except Team).

Set to 0 to add all referenced Apps
Set to 1 to add Store, Security Health, App Installer
Set to 2 to add level 1 apps + Photos, Camera, Notepad, Paint
Set to 3 to add level 2 apps + Terminal, Widgets, Mail / Outlook, Clipchamp
Set to 4 to add level 3 apps + Media apps (Music, Video, Codecs, Phone Link) / not for N editions

StubAppsFull

Control preference for Apps which are available as stubs.

Set to 0 to install as stub app
Set to 1 to install as full app

CustomList

Enable using CustomAppsList.txt or CustomAppsList2.txt to pick and choose the added Apps.
If enabled, this option takes precedence over AppsLevel option.

How to use:
You can either use CustomAppsList.txt directly, or copy/rename it to CustomAppsList2.txt
Edit the choosen file, and remove # prefix in front the Apps you wish to add, and save the file.

Extra Bonus (not an option)

The script supports adding LanguageExperiencePack (LXP) along with other Apps.

How to do:
Download required LanguageExperiencePack files from UUP dump or store.rg-adguard.net
Place the files into UUPs folder (or the alternative UUP files source folder) before starting the conversion process.

Add Updates Option

Info

Starting Windows 10 version 1709, Servicing Stack Update and Latest Cumulative Update are handled and distributed with UUP source. In addition to some small dynamic updates used in upgrades.

According to that, UUP Dump will offer multiple builds for the same Windows 11/10 version. Each one will represent refreshed Feature Update or new Cumulative Update.

However, those updates are only used and applied by Windows Update, they not actual part of the UUP source itself and will not be included in the converted ISO/WIM by default.

AddUpdates option provide built-in ability to directly integrate these updates, resulting a refreshed ISO/WIM, or to add them externally.

Integrate updates mode only works with install.wim (ISO or Single), and require Windows 11/10 Host OS or Windows 11/10 ADK.

External updates mode only works with builds 17763 and later, and the updates will be installed during setup (clean install or upgrade).

Cleanup option control image cleanup for integration mode, and will delta-compress superseded components.

ResetBase option works only with Cleanup option, and will further remove superseded components.

NetFx3 option is to enable .NET 3.5 feature for both modes.

External updates mode is ment as backup procedure in case Windows 11/10 ADK is not installed, or the user want to have converted ISO faster. It is recommended to use the normal integration mode if possible.

If UUP source is build 17063 or later and multiple editions are selected, in order to reduce integration mode time, Pro/ProN editions will be created as upgrades from the already updated Home/HomeN editions, if possible.

Similarly, for Windows Server 2022, Datacenter editions will be created as upgrades from the already updated Standard editions, if possible.

Integrate updates mode may not work correctly on Windows 7 Host OS, specially with recent Windows 11/10 builds. External updates mode is recommended to use in that case.

Integrate updates mode for ARM64 UUP images only works on Windows 11/10/8.1 Host OS.

Integrate updates mode for Windows 11 build 22567 and later require at least Windows 10 v1607 Host OS (build 14399).

How To

Make sure UUP source contain updates (Windows10.0-KB* / Windows11.0-KB* files)

Set configuraation option AddUpdates to 1 or 2

If you set to 1 and Windows 11/10 ADK is not installed, it will be reverted to 2 (if build is supported), or turned OFF

Note

Warning:

Cleanup

StartComponentCleanup

SilentCleanup

Warning:

ResetBase

Virtual Editions

Info

Starting Windows 10 build 17063, regular editions have been unified into two base editions: Home & Pro (with their variants Home N & Pro N)

Home China edition is still separate

According to that, UUP will deliver installation files for the above editions only

The following editions now exist as "virtual upgrade editions" with base editions:

Home -> Home Single Language Pro -> Enterprise, Education, Pro Education, Pro for Workstations, Cloud (builds 21364+), Enterprise multi-session, IoT Enterprise (builds 18277+), IoT Enterprise Subscription (builds 25982+) Pro N -> Enterprise N, Education N, Pro Education N, Pro N for Workstations, Cloud N (builds 21364+) Enterprise LTSC -> IoT Enterprise LTSC (builds 19041+), IoT Enterprise LTSC Subscription (builds 25193+)

Therefore, the extra script is to help create these additional editions from UUP source.

How To

Supported source distribution:
- Folder (containing the extracted ISO) placed next to the script. (auto detected)
- DVD Drive, i.e. mounted iso/real dvd drive/usb drive. (auto detected)
- Direct ISO file. (you will prompted to specify one)

Optional: if you do not intend to keep base converted ISO, set convert-UUP option SkipISO to 1.

Use convert-UUP.cmd to create the source distribution.

Run create_virtual_editions.cmd and choose the desired option from choices.

Options

1 - Create all editions
create all possible target virtual editions.

2 - Create one edition
create one of the target virtual editions.

3 - Create randomly selected editions
create some of the target virtual editions.

Config Options

Control process behavior, output and automation.

You have two ways to change the state of these options, where 0 means the option is OFF (no), and 1 means the option is ON (yes):
- edit ConvertConfig.ini under [create_virtual_editions] section
- delete ConvertConfig.ini and edit create_virtual_editions.cmd script directly

UseDism

Choose the creation method:

Value 0 : Registry manipulation
hacky way, work with install.wim or install.esd, support any host OS (Vista+).

Value 1 : Dism.exe tool
official way, work with install.wim, require NT 10.0 host OS or Windows 8.1 with Windows ADK.

Value 2 : Force Dism.exe tool
Same as value 1, but work on Windows 7/8 with Windows ADK.

If chosen value is 1 or 2 and host OS is NT 6.x without Windows ADK installed, it will be auto reverted to value 0
If chosen value is 1 or 2 and source file is install.esd, it will be auto reverted to value 0

AutoStart

Start the creation process directly without prompts.
This require the source distribution to be ready (folder or drive).
Only the editions specified in AutoEditions will be created, if no edition specified (empty), it will create all possible target editions.

AutoEditions

Specify editions to auto create with AutoStart option, separate the editions with a comma ,

Leave this option empty to create all possible target editions.

Supported editions values:
Enterprise, Education, ProfessionalEducation, ProfessionalWorkstation, CloudEdition, ServerRdsh, IoTEnterprise, IoTEnterpriseK
EnterpriseN, EducationN, ProfessionalEducationN, ProfessionalWorkstationN, CloudEditionN
CoreSingleLanguage
IoTEnterpriseS, IoTEnterpriseSK

Examples:
vAutoEditions=Enterprise vAutoEditions=Enterprise,ProfessionalWorkstation,Education vAutoEditions=

DeleteSource

Do not keep the source editions (example: create Enterprise and delete Pro).

Preserve

Preserve and keep source distribution folder intact, the operation will be done on copied folder instead.
If source distribution is ISO file, this option has no affect.

wim2esd

Convert install.wim to install.esd at the end.

Warning: creating install.esd will consume high amount of CPU/RAM, and might take considerable time to complete.

SkipISO

Do not create final ISO file at the end.

Note:

If create_virtual_editions.cmd is started from convert-UUP.cmd, options AutoStart & wim2esd & SkipISO will be inherited from convert-UUP section, regardless their current state under create_virtual_editions section

meaning, the script will auto-create virtual editions if convert-UUP's AutoStart=1
and install.wim will be converted to install.esd if convert-UUP's wim2esd=1, otherwise skip conversion if convert-UUP's wim2esd=0

Multi-Architecture ISO (x86/x64)

How To

Optional: if you do not intend to keep single architecture ISOs, edit convert-UUP.cmd and set SkipISO=1

Use convert-UUP.cmd to create two ISO distributions, one for x64 and another for x86, you may select the desired editions to include in each one

Run multi_arch_iso.cmd and choose the desired option from menu

Options

1 - Create ISO with 1 combined install.wim/install.esd
create a custom ISO structure.
with 1 install.wim/install.esd for all x64/x86 images, and slighlty modified bootx64.wim/bootx86.wim to allow coexistence.

2 - Create ISO with 2 separate install.wim/install.esd (Win 10)
create the same ISO structure as Media Creation Tool.
with 2 separate x64/x86 folders and install.wim/install.esd for each architecture.

Notes

To preserve source single-architecture distributions folders, edit multi_arch_iso.cmd and set Preserve=1

If the installation file is install.esd, be aware that option 1 will require high amount of CPU/RAM to unify install.esd files

multi_arch_iso.cmd can be used also to create multi-architecture ISO from any similar Windows x64/x86 ISO distributions, starting Windows 7 SP1
however, option 2 only works with Windows 11/10 setup files.

Debug Mode

Intended to help into detecting errors in the script or the conversion process and create a full log of the operation.

To enable debug mode, follow these steps:

set the desired configuration options in ConvertConfig.ini (specially AutoStart).

edit convert-UUP.cmd and change set _Debug=0 to set _Debug=1 and save the changes.

to start the process: put the UUP files in UUPs folder, then run the script as administrator.

another way to start the process: drag and drop the UUP files source directory on convert-UUP.cmd

wait until the process finish and cmd window is closed.

Note: create_virtual_editions.cmd will inherit debug mode if StartVirtual option is active.

Extra Notes

If the conversion or updating process failed and you got "access denied" errors, run Remove_Failure_MountDir_TempDir.cmd as administrator to remove temporary mount directory and extraction leftovers.

If the upgrade is done via Express UUP (multiple expanded folders in the download directory), you need to perform the UUP > ISO operation before starting the upgrade process (before first restart).
to do so, when WU prompt you to restart, start convert-UUP.cmd and paste the path to download directory, example:
- C:\Windows\SoftwareDistribution\Download\07172dda91861218ecc095600216d792
Alternatively, if you are testing in VM machine or have multi boot systems, you can choose to Shut down/Restart the system without upgrading.
on Desktop, press Alt+F4 and choose an option without Update

Credits

whatever127 - UUP dump
Eric Biggers - wimlib
Igor Pavlov - 7-zip
Melinda Bellemore - SxSExpand
BetaWorld - PSFExtractor
Jeff Kluge - Managed DismApi Wrapper
erwan.l - offlinereg
cdob - create aio efisys.bin
Special thanks to: @rgadguard, @Enthousiast, @Windows_Addict, @s1ave77, @Ratiborus58, @NecrosoftCore, @DiamondMonday, @WzorNET
cabarc, cdimage, imagex and bcdedit are intellectual property of Microsoft Corporation.

Author: abbodi1406