uup-dump/converter
9
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Multiplatform UUP converter
58 Commits 1 Branch 0 Tags 106 KiB
Shell 100%
9f41b75efc
Go to file
Ian Gallagher 9f41b75efc
Add aria2 package to prerequisites and homebrew example 
* This resolves issue #38
* This ensures that the aria2 homebrew package is installed, which
  provides the `aria2c` command used to download files.
* This only changes instructions in the readme file, there are no actual
  code changes in this commit/PR.
2023-03-24 17:32:39 +13:00
convert_ve_plugin v0.6.5 2021-10-10 03:53:49 +03:00
convert.sh Fix $keepSymlinks 2023-02-13 18:24:10 +03:00
LICENSE Initial commit 2018-12-23 22:26:44 +01:00
readme.md Add aria2 package to prerequisites and homebrew example 2023-03-24 17:32:39 +13:00

readme.md

UUP converter

Description

A basic UUP converter aimed at Linux and macOS users who don't have access to any Windows machine, but want or need to create an ISO image for latest Windows Insider version downloaded from UUP dump.

For obvious reasons this script will never support integration of Cumulative Updates to created images.

Usage

./convert.sh [compression] [uups_directory] [create_virtual_editions]
compression options:
  • wim - standard wim compression (/Compress:max in DISM) (default)
  • esd - solid esd compression (/Compress:recovery in DISM)
create_virtual_editions options:
  • 0 - do not create virtual editions (default)
  • 1 - create virtual edtitions

Usage examples

  • ./convert.sh - starts the conversion using files from UUPs directory and creates an ISO image with install.wim

  • ./convert.sh esd - starts the conversion using files from UUPs directory and creates an ISO image with install.esd

  • ./convert.sh wim MyUUP - starts the conversion using files from MyUUP directory and creates an ISO image with install.wim

  • ./convert.sh wim MyUUP 1 - starts the conversion using files from MyUUP directory, creates virtual editions and creates an ISO image with install.wim

Virtual editions

Since version 0.5.0 this script supports creation of virtual editions. To run creation of all virtial editions simply use create_virtual_editions switch in command line. If you want to customize which editions will be created when this switch is set, please use VIRTUAL_EDITIONS_LIST in configuration file.

Virtual editions creation can be only done when convert_ve_plugin is present in the same directory as converter.

Thanks to abbodi1406 for providing informations which helped with creating this option.

Configuration file

Configuration of advanced script options can be modified using the file convert_config_linux (on Linux) or convert_config_macos (on macOS).

Configuration options
VIRTUAL_EDITIONS_LIST='space delimited editions sequence'
Configuration options explanation
  • VIRTUAL_EDITIONS_LIST - configures which editions will be created when create_virtual_editions is enabled.

Requirements

This script uses the following commands to do its work:

  • aria2c - to download the required files
  • cabextract - to extract cabs
  • wimlib-imagex - to export files from metadata ESD
  • chntpw - to modify registry of first index of boot.wim
  • genisoimage or mkisofs - to create ISO image
Linux

If you use Debian or Ubuntu based distribution you can quickly install these using the following command:

sudo apt install cabextract wimtools chntpw genisoimage

If you use Arch Linux you can also install these using the following command:

sudo pacman -S cabextract wimlib chntpw cdrtools

If you use Fedora you can also install these using the following command:

sudo dnf install cabextract wimlib-utils chntpw genisoimage

If you use any other distribution, then you will need to check its repository for packages needed to run this script.

macOS

macOS requires Homebrew to install the prerequisite software. After Homebrew was installed, you can install the requirements using:

brew tap sidneys/homebrew
brew install aria2 cabextract wimlib cdrtools sidneys/homebrew/chntpw