WoeUSB is a simple tool that enable you to create your own usb stick windows installer from an iso image or a real DVD. It is a fork of Congelli501's WinUSB.
Shell C++ M4 Roff Makefile Inno Setup
Clone or download
Lin-Buo-Ren Cosmetic fix
Signed-off-by: 林博仁(Buo-ren, Lin) <Buo.Ren.Lin@gmail.com>
Latest commit b102855 Aug 14, 2018



Latest Release WoeUSB License Build Status

brandthumbnail of GUI wrapper screenshotthumbnail of CLI application screenshot

A Linux program to create a Windows USB stick installer from a real Windows DVD or image.

This package contains two programs:

  • woeusb: A command-line utility that enables you to create your own bootable Windows installation USB storage device from an existing Windows Installation disc or disk image
  • woeusbgui: A GUI wrapper of woeusb based on WxWidgets

Supported images:

Windows Vista, Windows 7, Window 8.x, Windows 10. All languages and any version (home, pro...) and Windows PE are supported.

Supported bootmodes:

  • Legacy/MBR-style/IBM PC compatible bootmode
  • Native UEFI booting is supported for Windows 7 and later images (limited to the FAT filesystem as the target)

This project is a fork of Congelli501's WinUSB software, which has not been maintained since 2012, according to the official website.


Prebuilt Packages

Note that prebuilt packages are not necessarily the latest release and we are NOT responsible for the trustworthiness of these packages. Regarding any related issues contact its maintainer first.

Official Distribution Packages

  • Fedora packages maintained by mprahl

Third-party Distribution Packages

Build from Source

The following are the instructions to install WoeUSB if prebuilt version is not available or too old.

Acquire WoeUSB's Source Code

Clone WoeUSB's Git repository to your local machine using git clone https://github.com/slacka/WoeUSB.git

NOTE: We no longer support building from source archives provided in the GitHub Releases page as the software version is not set.

Setting the Application Version String

This step is required for generating the proper version name based on the Git tags. This step should be repeated if the version is changed.

$ ./setup-development-environment.bash

Install WoeUSB's Build Dependencies

# For Debian-based distributions (NOTE: For your convenience, this package is already provided in the release page)
$ sudo apt-get install devscripts equivs gdebi-core
$ cd <WoeUSB source code directory>
$ mk-build-deps # NOTE: Currently, due to Debian Bug #679101, this command will fail if the source path contains spaces.
$ sudo gdebi woeusb-build-deps_<version>_all.deb

# For Fedora > 22
$ sudo dnf install wxGTK3-devel

# For Fedora 22
$ sudo dnf install wxGTK-devel dh-autoreconf.noarch

Build & Install WoeUSB

# For Debian-based distributions
$ dpkg-buildpackage -uc -b # NOTE: Currently, due to a bug in the build system, this command will fail if the source's path contains space or single quotes, refer to issue #84 for details
$ sudo gdebi ../woeusb_<version>_<architecture>.deb

# Generic method
$ autoreconf --force --install # Most non-Debian derived distros will need this
$ ./configure
$ make
$ sudo make install


WoeUSB is distributed under the GPL license.