Update readme

This commit is contained in:
ValdikSS 2021-08-16 01:15:12 +03:00
parent 5129e8c868
commit 5d803853aa

View File

@ -3,7 +3,7 @@
## What is this? ## What is this?
Windows2usb is a bash script which writes Microsoft Windows 7/8/8.1/10 installation DVD images to USB Flash Drive or external HDD on Linux. It was designed with compatibility in mind, and should work in all cases, contrary to other popular Linux tools. Windows2usb is a bash script which writes Microsoft Windows 7/8/8.1/10/11 installation DVD images to USB Flash Drive or external HDD on Linux. It was designed with compatibility in mind, and should work in all cases, contrary to other popular Linux tools.
Features: Features:
@ -13,52 +13,71 @@ Features:
* Uses stock Windows bootloaders where possible * Uses stock Windows bootloaders where possible
* Does not break UEFI Secure Boot chain * Does not break UEFI Secure Boot chain
```
Windows 7/8/8.1/10/11 ISO to Flash Drive burning utility
WARNING: this program will delete all existing data on your drive!
windows2usb <device> <windows iso> <mbr/gpt/gptntfs/gpt+uefintfs>
mbr mode: the most universal, RECOMMENDED method.
This mode creates MBR partition table with FAT32 partition,
installs BIOS and UEFI bootloaders, supports Secure Boot.
install.wim file larger than 4 GiB will be split.
Suitable for all computers (UEFI/CSM/BIOS).
gpt mode: less universal mode, for modern (UEFI) computers.
GPT+FAT32, UEFI only, supports Secure Boot.
gptntfs mode: all the same as 'gpt' but NTFS is used.
GPT+NTFS, UEFI only, supports Secure Boot.
Large install.wim file will not be split.
NOTE: not all UEFI are compatible with this mode,
NTFS driver should be present on the motherboard.
gpt+uefintfs mode: alternative hacky installation method, not recommended.
This mode uses NTFS partition and third-party 'uefintfs' bootloader.
GPT+NTFS(data)+FAT32(efi), UEFI only, NO Secure Boot support.
Large install.wim file will not be split.
```
## How to use? ## How to use?
Download latest [portable AppImage version](https://github.com/ValdikSS/windows2usb/releases) from the **Releases** page, set *execution bit* (`chmod +x windows2usb-*.AppImage`) and run it from the terminal. Download latest [portable AppImage version](https://github.com/ValdikSS/windows2usb/releases) from the **Releases** page, set *execution bit* (`chmod +x windows2usb-*.AppImage`) and run it from the terminal.
`windows2usb <device> <windows iso> <mbr/gpt/gptntfs>` `windows2usb <device> <windows iso> <mbr/gpt/gptntfs/gpt+uefintfs>"`
The program prints removable storage list if no arguments supplied. The program prints removable storage list if no arguments are supplied.
If you don't want to use AppImage, you'll need to install all dependencies and download [uefi-ntfs.img](https://github.com/pbatard/rufus/tree/master/res/uefi) from Rufus project. If you don't want to use AppImage, you'll need to install all dependencies and download [uefi-ntfs.img](https://github.com/pbatard/rufus/tree/master/res/uefi) from Rufus project.
### BIOS Boot ### BIOS Boot
BIOS Boot (Legacy Boot/UEFI-CSM) uses stock Windows 7 MBR and NTFS bootloader, courtesy of [ms-sys](http://ms-sys.sourceforge.net/) project. BIOS Boot (Legacy Boot/UEFI-CSM) uses stock Windows 7 MBR and FAT32 bootloader, courtesy of [ms-sys](http://ms-sys.sourceforge.net/) project.
Use this mode if you have old computer without UEFI support or want maximum compatibility of installation media. **BIOS boot is supported only in recommended 'mbr' mode.**
To burn ISO in this mode, run: To burn ISO compatible with BIOS boot (and UEFI boot as well), run:
`windows2usb <device> <windows iso> mbr` `windows2usb <device> <windows iso> mbr`
### UEFI Boot ### UEFI Boot
UEFI Boot (`gpt` mode) creates FAT32 partition with stock Windows UEFI bootloader. **UEFI Boot is supported in all modes. Recommended mode: 'mbr'.**
This mode will not work on old computers. Use this mode for new computers with UEFI support.
This mode supports UEFI Secure Boot.
To burn ISO in this mode, run: To burn ISO in this mode, run:
`windows2usb <device> <windows iso> gpt` `windows2usb <device> <windows iso> mbr`
### UEFI Boot with NTFS Partition 'MBR', 'GPT' and 'GPTNTFS' modes utilize Windows UEFI bootloader from the ISO file, with Secure Boot support.
UEFI Boot with NTFS partition uses [uefi-ntfs](https://github.com/pbatard/uefi-ntfs) bootloader from Rufus project. ### UEFI Boot with NTFS Partition and uefi-ntfs bootloader
This mode is made for custom installation disks with install.wim file greater than 4 GiB, which could be found on various torrent trackers. **Windows2usb** creates 2 partitions in this mode, small 1 MiB FAT32 partition with **uefi-ntfs** and huge NTFS partition with ISO data. A special 'gpt+uefintfs' mode uses [uefi-ntfs](https://github.com/pbatard/uefi-ntfs) bootloader from Rufus project. **Windows2usb** creates 2 partitions in this mode, small 1 MiB FAT32 partition with **uefi-ntfs** and huge NTFS partition with ISO data.
This mode was included earlier to work with installation disks where install.wim file is greater than 4 GiB, but since then split WIM file functionality was introduced, and now this mode may be considered obsolete.
This mode does not support Secure Boot (uefi-ntfs bootloader is not signed by Microsoft or other trusted party). This mode does not support Secure Boot (uefi-ntfs bootloader is not signed by Microsoft or other trusted party).
To burn ISO in this mode, run:
`windows2usb <device> <windows iso> gptntfs`
If your ISO contains install.wim greater than 4 GiB, `gpt` mode will automatically detect that and terminate the writing process.
## Alternatives ## Alternatives
[WoeUSB](https://github.com/WoeUSB/WoeUSB)—uses GRUB for BIOS Boot. [WoeUSB](https://github.com/WoeUSB/WoeUSB)—uses GRUB for BIOS Boot.
@ -73,3 +92,4 @@ This script uses:
* [**ms-sys**](http://ms-sys.sourceforge.net/) for native Windows 7 MBR and NTFS bootloaders * [**ms-sys**](http://ms-sys.sourceforge.net/) for native Windows 7 MBR and NTFS bootloaders
* [**p7zip**](https://www.7-zip.org/) for ISO extraction * [**p7zip**](https://www.7-zip.org/) for ISO extraction
* [**autofsync**](https://github.com/i-rinat/autofsync/) to prevent filesystem bufferbloat and properly show copying progress (AppImage only) * [**autofsync**](https://github.com/i-rinat/autofsync/) to prevent filesystem bufferbloat and properly show copying progress (AppImage only)
* [**wimlib**](https://wimlib.net/) to split large install.wim files to fit FAT32 partition