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.
File extension suffixes ('pwd', '32' or '64', 'AUTO')
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.
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.You can also 'hide' payloads, so that they are not listed in the menu system - see here.
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)
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
BitCoin also accepted.