woeusb

From Gentoo Wiki
Jump to:navigation Jump to:search

This article is a stub. Please help out by expanding it - how to get started.

woeusb is a command-line utility for creating Microsoft Windows USB installation media written in Bash. Microsoft Windows Vista through Windows 11, including Windows PE, are fully supported.

Bootable media can be written using the FAT32 and NTFS filesystems, which can be booted using legacy BIOS and UEFI firmware provided the version of Windows being deployed supports it.

Installation

Emerge

root #emerge --ask sys-boot/woeusb

Additional software

While the original version of woeusb is written in Bash a Python-based rewrite is underway called woeusb-ng. This package is not yet available in the mainline Gentoo package repository, but a well maintained ebuild exists in GURU.

Usage

Invocation

user $woeusb --help
WoeUSB 5.2.4 Help Information
=============================

WoeUSB can create a bootable Microsoft Windows(R) USB storage device from an existing Windows optical disk or an ISO disk image.

Supported installation drive preparation modes
----------------------------------------------

Currently two creation methods are supported:

### `--device`, `-d` ###

Completely WIPE the entire USB storage device, then build a bootable Windows USB device from scratch.

WARNING: All previous data on the device will be gone!

```synopsis
$ woeusb --device <source media path> <device>
```

```example
woeusb --device Windows7_x64.iso /dev/sdX
woeusb --device /dev/sr0 /dev/sdX
```

### `--partition`, `-p` ###

Copy Windows files to an existing partition of a USB storage device and make it bootable.  This allows files to coexist as long as no filename conflict exists.

WARNING: All files that has the same name will be overwritten!

```synopsis
woeusb --partition <source media path> <partition>
```

```example
woeusb --partition Windows7_x64.iso /dev/sdX1
woeusb --partition /dev/sr0 /dev/sdX1
```

Command-line Options
--------------------

### `--verbose`, `-v` ###

Verbose mode

### `--help`, `-h` ###

Show this help message and exit

### `--version`, `-V` ###

Print application version

### `--about`, `-ab` ###

Show info about this application

### `--no-color` ###

Disable message coloring

### `--debug` ###

Enable script debugging

### `--label`, `-l <filesystem_label>` ###

Specify label for the newly created file system in --device creation method

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

### `--workaround-bios-boot-flag` ###

Workaround BIOS bug that won't include the device in boot menu if non of the partition's boot flag is toggled

### `--debugging-internal-function-call <function name> (function_argument)...` ###

Development option for developers to test certain function without running the entire build\n

### `--target-filesystem`, `--tgt-fs <filesystem name>` ###

Specify the filesystem to use as the target partition's filesystem.

Currently supported: FAT(default)/NTFS

### `--for-gui` ###

No longer supported, reserved for compatibility with the wrapper programs

Removal

Unmerge

root #emerge --ask --depclean --verbose sys-boot/woeusb

See also

  • dd — a utility used to copy raw data from a source into sink, where source and sink can be a block device, file, or piped input/output.

External resources