E2B Payload File Extensions
If you are not sure what file extension will work best and it is an ISO file, use .isoask so that you can test all of them until you find one that works! Read more here. File extensions are not case-sensitive.
Tip: Always try a filename with no spaces or special characters first. If it works, then you can try renaming it - e.g. first try Windows_10_x64.iso - if it works then try 'Windows 10 64-bit.iso' so that the menu entry is more readable.
File extension suffixes ('pwd', '32' or '64', '4GB', '3GB' or 'AUTO')
If you add pwd (e.g. fred.isopwd) to almost any file extension (with a few exceptions such as .WIM and .VHD files), E2B will prompt you for the password which is defined by the variables 'pwd' or 'menupwd' in your MyE2B.cfg file. The default password is easy2boot. See here for more details.
File extensions suffixes only work for standard E2B menus (but you can use .iso32 or .iso64 in Windows Install menus - E2B v1.94+).
- If you add AUTO to the end of a .imgPTN family file extension, the user will not be prompted before switching the image and loading the CSM menu (.imgPTNxxxx files only).
- If you add 32 to the end of the file extension, the payload will only be listed in menus on 32-bit systems (v1.62+).
- If you add 64 to the end of the file extension, the payload will only be listed in menus on 64-bit systems.
- If you add pwd to the end of the file extension, the user will be prompted for a password before it is run.
- If you add 4GB to the file extension, the payload will only be listed in the menu if the system contains more than 4GB RAM (v1.A4+).
- If you add 3GB to the file extension, the payload will only be listed in the menu if the system contains less than 4GB RAM (v1.A4+).
You can combine suffixes as long as they are in the order .xxxx[AUTO][
32|64][pwd] where xxxx is a valid E2B file extension (v1.78+), e.g.
List of all file extensions recognised by E2B
Tip: Some payloads require a .iso extension (e.g. WinBuilder ISO files). For 'quiet' booting with no auto-suggest prompt, ensure the last letter of the file name ends in q or Q - e.g. WinPESE10_2016_x86q.iso. Create a matching .txt file if you want to change the menu entry text.
.isodef, .isodefault - same as .iso but the QRUN auto-suggest feature is disabled so the user doesn't get prompted with an alternative suggestion.
Tip: use .isodef64 for 64-bit ISOs so that they are not listed in the menu on 32-bit systems. WinBuilder ISOs must have a .ISO file extension.
.isoask - asks the user each time which of the special options should be used - useful to determine which extension works best.
.isodd - same as .iso but never shows any auto-suggest prompt (even if ISOASK variable is set then E2B will not ask how you want to run it and it will boot in the same way as a .iso file).
.isomem - loads the whole ISO file into memory and also creates a new partition containing the ISO contents (if contiguous) - use for non-contiguous linux ISOs and XP-based ISOs and Hirens ISOs (may not always work depending on payload type!).
.isowin - as .isomem but does not load ISO into memory unless it is non-contiguous, and then boots from setupldr.bin or \ntldr or \bootmgr if possible - use for WinPE ISOs - e.g. Symantec Recovery ISOs
.isolinux - tries to boot from ISO using isolinux.bin or \boot.isolinux.bin or \boot\syslinux.bin if possible
.isogrub - tries to boot from grldr within the ISO
.isoforce - loads firadisk floppy disk image and forces grub4dos to boot from the ISO even if it doesn't think it is bootable - use for CentOS ISOs
.isofira - maps the whole ISO file (if contiguous) or loads it into memory (if not contiguous) and also loads the firadisk floppy image as fd0 also if Windows ISO, will load ISO as virtual cd - use for BartPE\Strelec PE based ISOs
.isofira01 - maps the whole ISO file (if contiguous) or loads it into memory (if not contiguous) and also loads the firadisk floppy image as fd0, swaps hd0&1, also if Windows ISO, will load ISO as virtual cd - use for BartPE\Strelec PE based ISOs
.isomemfira - loads the whole ISO file into memory and also loads the firadisk floppy image as fd0 - use for BartPE\Hirens XP PE based ISOs
.isomemF01 - loads the whole ISO file into memory and also loads the firadisk floppy image as fd0, swaps hd0&1 - use for ERD/MSDaRT 5 XP ISOs
.isowinvH - loads the ISO and also WinVBlock as a floppy image - does not swap hdo/hd1 - useful for booting Hirens CD and DLC multiboot ISOs
.isoHW - combines .isoPE with .isowinVH - use for Hirens\DLC ISOs which boot to WinXP and Win7/8/10. For correct Win7/8/10, a Removable E2B USB drive or Helper Flash drive is required - otherwise manually run \_ISO\e2b\firadisk\LOADISOPE.cmd after booting to Desktop. v1.78+.
.isomemwinv - loads the ISO into memory and also WinVBlock as a floppy image - useful for booting ERDCommander, BartPE and other XP PE based ISOs if they are not contiguous
.isogz - loads the ISO into memory - use for a gzip compressed ISO.
.isoBSD - loads a .imgptn partition image file as ptn 1 and the BSD ISO as ptn3 and then boots to BSD (E2B v1.A5+). Note: This swaps out the E2B partition with a small FAT partition but on the next MBR-boot, the E2B partition will be restored.
.imgPTN Partition image file extensions (v1.51+)
All .imgPTNxxx files MUST be contiguous.
- a=active - marks the first partition as active (bootable). An active partition may be required for some WindowsToGo first boot-time images to avoid a 'Windows could not complete' error on first boot.
- LBA=forces BIOS to use LBA addresses
- 23=Partition entries 2 and 3 will be kept so they are accessible in CSM mode (add '23' to the end of a valid .imgPTN file extension)
- na=not active - does not mark any partition as Active (bootable)
Note: The partition image extensions .imgPTN, .imgPTN23 or . are the most often used.
Using File Extensions with E2B
title MS-DOS 6.22 Floppy Disk\n This boots the file DOS622.imagzmem
More extensions can be supported by editing the \_ISO\E2B\grub\QRUN.g4b grub4dos batch file and adding a new extension section of code to the batch file. Let me know if you want me to support a new extension in the QRUN.g4b file for the next version.
Suggested File Extensions to use for different ISOs/payloads
- Linux ISOs - just keep as .iso (see here if any problems)
- Puppy Linux - try .isopup
- BartPE/XP/XP Rescue ISOs - rename to .isowinv or .isomemwinv (if blank screen after boot, try .isowinve0 or .isowinvHe0)
- Hirens ISOs - rename to .isowinvH or .isoHW (or .isomem for slow loading but faster operation) - or else try extracting the \HBCD or \DLC or \DLC1 folder to the root of the Easy2Boot USB boot drive. See here for more details. For multiple Hirens with full functionality, make a .imgPTN file from each one using MakePartImage.
- Windows Install ISOs - these must be placed in the correct \_ISO\Windows\xxx folder (can also convert to .imgPTN for UEFI-booting)
- HDDR2011 ISO - compress it to .gz file and use .isogz
- Windows based ISOs that give a blank screen when Windows loads - use .isoe0,.isowinve0 or .isowinvHe0 - due to buggy BIOS!
- WinBuilder WinPE (v2/3/4) ISO files - use .ISO for WinBuilder ISOs - do NOT change extension. Else try .isomemF01 or .isoPE01 - see here for more info.
- UEFI ISOs or MSDaRT ISOs - Create a FAT32 .imgPTN file using MakePartImage.cmd
- Windows To Go - create an NTFS .imgPTNA file using MakePartImage - see blog
Compressed payload files
Recommended for Easy2Boot (fastest!) - SanDisk Extreme SDCZ880-128G-G46