7rst1/woeusb

A Microsoft Windows® USB installation media preparer for GNU+Linux

WoeUSB

https://github.com/WoeUSB/WoeUSB

A Microsoft Windows® USB installation media preparer for GNU+Linux

Features

• Support Legacy PC/UEFI booting
• Support FAT32 and NTFS filesystems
• Support using physical installation disc or disk image as source

Supported Windows® installation images

• Windows Vista and later
• Any language or edition variants
• Windows PE

NOTE: Non official installation media may be supported, but not guaranteed

Dependencies

The following are the dependencies that WoeUSB requires, in one way or another. Refer the wiki for distro-specific information.

Required

WoeUSB will not be able to function without these software installed in their proper locations:

• GNU Bash
  For interpreting and executing the program logic
  Requires >= 4.3
• The GNU Core Utilities(Coreutils)
  For common Unix utilities necessary for basic operations
• util-linux
  For low-level utilities interacting with storage devices, etc
• GNU Grep and Gawk
  For parsing necessary information out from a command output
• The GNU Find Utilities
  For enumerating files required for operation
• GNU GRUB
  For installing the bootstrap code used in a Legacy PC boot
  We specifically requires modules of the i386-pc architecture, for Debian-based distributions these are provided via the grub-pc-bin package
• GNU Parted
  For manipulating disk partition table and partitions
• GNU Wget
  For acquiring Pete Batard's UEFI:NTFS UEFI bootloader
• dosfstools
  For creating FAT filesystem in --device creation method
• NTFS-3G
  For creating NTFS filesystem in --device creation method

Optional

Without the following dependencies WoeUSB will still able to run, but some functionalities will be unavailable:

• p7zip
  For workaround the problem where the Windows 7 installation media doesn't ship their UEFI bootloader in the proper location
• Pete Batard's UEFI:NTFS UEFI bootloader
  For supporting NTFS filesystems in the target USB key

Installation

To be addressed. For now refer Run from source.

Run from source

WoeUSB is a program that can be run without installation(excluding its dependencies):

1. Download the program(woeusb-N.N.N.bash) from the Releases page
2. Fix the missing executable file permission (chmod +x path/to/woeusb-N.N.N.bash)
3. Launch a terminal application and run the program via the appropriate path(sudo path/to/woeusb-N.N.N.bash --help)

License

GPL-3.0+

Credits

WoeUSB is a fork of Congelli501's WinUSB project.