WindowsBuildFromISO
Extract the windows major and minor build numbers from an ISO file, and automatically sort the iso files.
Features
- Parse multiple ISO files from a directory.
- Detect the Windows build number and OS language.
- Sort and rename the ISO files in folders by OS major and minor builds.
Examples
-
Automatically sort and rename the isos from a directory by major and minor build numbers.
./WindowsBuildFromISO.py --iso-dir ./isos/ --archive-dir ./archive/
-
Only get the major and minor build numbers of an ISO.
./WindowsBuildFromISO.py --iso ./isos/Win10_21H1_x64_English.iso
Usage
$ ./WindowsBuildFromISO.py -h
usage: WindowsBuildFromISO.py [-h] (-i ISO | -d ISO_DIR) [-a ARCHIVE_DIR] [-v]
Extract Windows Build number from ISO files. v1.1
optional arguments:
-h, --help show this help message and exit
-i ISO, --iso ISO Path to iso file.
-d ISO_DIR, --iso-dir ISO_DIR
Directory containing multiple ISOs to parse.
-a ARCHIVE_DIR, --archive-dir ARCHIVE_DIR
Archive dir. (default: False)
-v, --verbose Verbose mode. (default: False)
How it works
In order to extract the Windows version from an ISO, we first need to mount the ISO file and open its content. In the ISO, there is a ./sources/
folder containing a Windows imaging (WIM) image
in ./sources/boot.wim
. When we uncompress this archive, we get a lot of files, but one file at the root of the archive stands out: '[1].xml'
.
boot$ ls -lha
total 52K
drwxrwxr-x 5 podalirius podalirius 4,0K janv. 18 00:17 .
drwxrwxr-x 4 podalirius podalirius 4,0K janv. 18 00:17 ..
drwx------ 8 podalirius podalirius 4,0K mars 19 2019 1
-rw-rw-r-- 1 podalirius podalirius 3,9K janv. 18 00:16 '[1].xml'
drwx------ 8 podalirius podalirius 4,0K mars 19 2019 2
drwx------ 2 podalirius podalirius 32K janv. 18 00:16 '[DELETED]'
This file is a XML file containing information about the images contained inside the ./sources/boot.wim
file. It contains all the information we need to know which major or minor build this ISO file is. Here is an extract of the '[1].xml'
file:
<WIM>
<TOTALBYTES>530731284TOTALBYTES>
<IMAGE INDEX="1">
...
<WINDOWS>
<ARCH>9ARCH>
<PRODUCTNAME>Microsoft� Windows� Operating SystemPRODUCTNAME>
<EDITIONID>WindowsPEEDITIONID>
<INSTALLATIONTYPE>WindowsPEINSTALLATIONTYPE>
<PRODUCTTYPE>WinNTPRODUCTTYPE>
<PRODUCTSUITE>PRODUCTSUITE>
<LANGUAGES>
<LANGUAGE>en-USLANGUAGE>
<DEFAULT>en-USDEFAULT>
LANGUAGES>
<VERSION>
<MAJOR>10MAJOR>
<MINOR>0MINOR>
<BUILD>18362BUILD>
<SPBUILD>418SPBUILD>
<SPLEVEL>0SPLEVEL>
<BRANCH>19h1_releaseBRANCH>
VERSION>
<SYSTEMROOT>WINDOWSSYSTEMROOT>
WINDOWS>
<NAME>Microsoft Windows PE (x64)NAME>
<DESCRIPTION>Microsoft Windows PE (x64)DESCRIPTION>
<FLAGS>9FLAGS>
IMAGE>
...
WIM>
Contributing
Pull requests are welcome. Feel free to open an issue if you want to add other features.