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', '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.
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.
.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