win-iso-creator

Installer and deployer for WoeUSB — a tool to create bootable Windows USB sticks from ISO images on Linux.

Features

• Automated dependency checking and installation
• Clone, patch, and deploy WoeUSB from source
• Local installation or remote deployment via SSH
• Configurable install prefix
• Full build lifecycle: prepare → build → install → validate → clean

Requirements

• Debian/Ubuntu-based Linux (uses apt-get)
• Git, Bash >= 4.3
• Runtime dependencies: coreutils, util-linux, grep, gawk, findutils, grub-pc-bin, parted, wget, dosfstools, ntfs-3g, wimtools

Usage

# Install locally (default prefix: /usr/local)
bash -x build.sh --prepare --build --install --validate --clean

# Install to custom prefix
bash -x build.sh --prepare --build --install --prefix=/opt/woeusb --validate --prefix=/opt/woeusb --clean

# Deploy to remote server
bash -x build.sh --prepare --build --install --remote=user@server --validate --remote=user@server --clean

Stages

Stage	Description
--prepare	Check and install system dependencies
--build	Clone latest WoeUSB release and patch version string
--install	Deploy binary, man page, and assets
--validate	Verify installation is correct
--clean	Remove build directory

Options

Option	Description
--prefix=PATH	Install prefix (default: /usr/local)
--remote=USER@HOST	Deploy to remote server via SSH
--help	Show usage

Using WoeUSB

After installation, create a bootable USB with:

sudo woeusb --device /path/to/windows.iso /dev/sdX

Where /dev/sdX is the USB device (all data will be erased).

Tests

bats test/build.bats

License

Build scripts: MIT. WoeUSB itself is GPL-3.0-or-later.