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
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 a 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 extension suffixes work in all E2B menus except \_ISO\WINDOWS\xxxx sub-menus (you can only use file extension suffixes PWD, 32, 64, 4GB and 3GB in Windows Install Vista-SVR2009 menus, XP ISOs must use .iso - 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+).
- If you add NCQ to the file extension (non-contiguous+quiet), the payload will not prompt the user with suggestions, redir will be set and will not try to make the file contiguous (v1.B0+).
- If you add QUIETP to the file extension, redir and redirp will be set so that all messages will be reduced (v1.B0+).
- If you add QUIET to the file extension, redir will be set so that messages will be reduced (v1.B0+).
- If you add ORDER to .imgPTN file extension to re-order partitions - may prevent USB key from MBR booting but enable UEFI booting - see .imgPTN section below (v1.B0+).
- If you add X4filename to then end of a .imgPTN extension, the partition image filename will be added as partion #4 - see .imgPTN section below - X4filename must be at the very end of the extension (v1.B0+).
- A, LBA, 23 - used after .imgPTN file extensions to make the new partition active, force the BIOS to use LBA addressing, and keep existing partitions 2 and 3.
Windows10x64.isopwd64 user must enter password before ISO can be used (not listed in menu if 32-bit CPU)
Windows10x64.isoNCQ will try to boot even if not contiguous
File extension override suffixes
You can force E2B to boot from a payload file as if it had a different file extension but still keep the original file extension (E2B v1.A9+).
Note: You can use a .mnu file instead to force any payload file to run as if it had a different file extension using, for example:
title Run Ubuntu64\n
qrun.g4b force.isodef $HOME$/Ubuntu64.iso
File name suffixes
*Q.ISO - .ISO filenames ending in the letter Q.iso or q.iso (Q\q for 'quiet') and with a .ISO file extension (e.g. thisismyisoQ.iso) will suppress the 'autosuggest' text usually displayed by E2B. Useful for WinBuilder-based WinPE ISOs which must use the file extension .ISO. Not case sensitive. You can also use myfilename_.isodef.iso instead.
*NCQ.* - No 'not-contiguous' warning messages are shown if the file is not contiguous (NCQ = not contiguous and quiet). Useful for WinBuilder-based WinPE (use *NCQ.ISO) and other WinPE ISOs which are not contiguous but still boot OK (v1.98+). Not case sensitive.
Add a .txt file
*.TXT - If any payload file also has a matching .txt file of the same file name (e.g. Ubuntu.iso and Ubuntu.txt) this will also automatically suppress the 'autosuggest' text usually displayed by E2B. The .txt file will contain the menu entry text and up to four lines of help text which will appear under the menu when the menu entry is selected by the user.
If you use a matching .txt file for a payload file, then the menu will always be listed, unless the .txt file also tests for 32-bit or 64-bitness. e.g. If using files fred.iso64 and fred.txt, a menu entry will be displayed on both 64-bit and 32-bit systems, unless you add extra code to the .txt file to check which CPU is present - see here for details. If the payload is not listed as expected, check the .txt file for syntax errors.
List of all file extensions recognised by E2B
If ISO file contains Windows install files WIMBOOT will be used to try to run the ISO as a Windows Installer + Setup.exe (v1.A8+).
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. You can instead use the file extension override feature (e.g. Ubuntu_.isodef.iso).
.isodef, .isodefault, .isodd - 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.
.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.
.isoboot - boot using ISOBOOT linux kernel parameters (for linux ISOs only), files can be non-contiguous (E2B v1.B0+).
.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)
- X4ffff - where ffff specifies the name of a partition image file which will be loaded as partition #4, the search order is: ((current folder)\ffff and then \_ISO\ffff - e.g. \_ISO\LINUX\UBUNTU64.imgptnX4winpe would also load the file \_ISO\LINUX\winpe or \_ISO\winpe as the 4th primary partition (E2B v1.B0+).
- ORDER - some UEFI BIOSes will refuse to UEFI-boot if the start of each Primary partition is not in ascending order. Use this if more than one partition contains an image and you want to UEFI-boot. Note that this will usually break MBR-booting however unless you modify the non-E2B images.
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 and ensure it is contiguous (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 work best if placed in the correct \_ISO\Windows\xxxx 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 - problem is due to buggy BIOS!
- WinBuilder WinPE (v2/3/4) ISO files - use .ISO for WinBuilder ISOs - do NOT change extension and no spaces in filename - use an extension override - e.g. Win10PESE_x64_.isoNCQ64.iso - see here for more info.
- Medicat, Bob Omb's WinPE, etc. - convert to FAT32 .imgPTN file.
- UEFI ISOs or MSDaRT ISOs - Create a FAT32 .imgPTN file using MakePartImage.cmd - see here for more info.
- Windows To Go - create an NTFS .imgPTN file using MakePartImage - see blog
Compressed payload files
Recommended for Easy2Boot (fastest!) - SanDisk Extreme SDCZ880-128G-G46