woeusb man page

woeusb — Bootable Windows installation/PE USB storage creator

Synopsis

woeusb [OPTIONS] --device|--partition source_media target_media

Description

woeusb is an command-line utility that enables you to create your own bootable Windows installation USB storage device from an existing Windows Installation DVD or its ISO image.

It mainly extracts all files from source_media to target_media , then installs GNU GRUB bootloader and a small configuration into it to support chainloading Windows BOOTMGR.

It also supports UEFI bootstrap scheme, however in this case Windows UEFI bootloader is used instead.

Currently woeusb only support FAT32 filesystem, thus the generated filesystem has a 4GiB single file size limit.  NTFS may be supported in the future.

Command-Line Options

Installation Mode

--device / -d

Drop target_media ´s partition table, recreate a new PC/Legacy/MBR partition table, create a FAT32 partition spanning (almost) the full disk, then setup bootable Windows on it.

WARNING: ALL PREVIOUS DATA ON TARGET MEDIA WILL BE DROPPED!

COMPATIBILITY: This mode is previously named --format , which will be obselute in future release.

--partition / -p

Mount target_media ´s file system, extracts all files from source_media , then make it bootable.

WARNING: ALL FILES EXISTING ON DISK WITH THE SAME FILENAME IN SOURCE MEDIA WILL BE OVERWRITTEN!

NOTE: UEFI bootability is available only when removable booting spec. is matched.

COMPATIBILITY: This mode is previously named --install , which will be obselute in future release.

Miscellaneous

--verbose / -v

Be more verbose

--debug / -d

Enable script debugging

--no-color

Disable color message

--label / -l

Label for the newly created file system in --device installation mode.

Note that the label is not verified for validity and may be illegal for the filesystem

Examples

We love examples!

Completely DESTROY all previous data on a USB storage device, recreate the partition table and the target partition, copy the Windows files, and make it bootable

# woeusb --device win7_amd64.iso /dev/sdX
# woeusb --device /dev/sr0 /dev/sdX

Copy Windows files to an existing FAT partition of a USB storage device and make it bootable

# woeusb --partition win7_amd64.iso /dev/sdX1
# woeusb --partition /dev/sr0 /dev/sdX1

Exit Status

0 when success, 1 (and non-zero if there's any) when failure

Bugs

Refer our issue tracker
for any known issues

See Also

woeusbgui(1)

Authors

Colin GILLE / congelli501 <colingille@hotmail.com>
林博仁 <Buo.Ren.Lin@gmail.com>

Referenced By

woeusbgui(1).

2.2.2 WoeUSB User Manual