iskrid / WoeUSB

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

Home Page:https://github.com/WoeUSB/WoeUSB

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

WoeUSB

https://github.com/WoeUSB/WoeUSB

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

Continuous Integration(CI) Status Badge

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.

About

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

https://github.com/WoeUSB/WoeUSB


Languages

Language:Shell 95.5%Language:Roff 4.5%