Table of Contents
Change the menu entry text
Introduction
By default, E2B will list the file name of the payload file in the menu. For example, if you have payload files (.ISO, .bin, .img, etc.) in the Main menu or in the other folders, the actual filename will be listed in the menu.
You usually do not need to keep the original filename, so just change the name of the file.
Try a filename (without spaces or special characters like ‘(‘ or ‘)’ or ‘&’ ) first. If that works OK then you can change the filename of the payload file to any name you like and use spaces in the file name for most types of payload
Note: Some VHD/WIM files or WinBuilder-based WinPE ISO files may not work if they contain spaces or special characters such as & $ ( ) ! # or spaces.
You can suppress all the filename extensions from being shown in the menu, if you set EXTOFF=1 in the MyE2B.cfg file (default) or display the full file name using set EXTOFF= in your MyE2B.cfg file.
For simple linux ISOs and some other types of files, you can simply rename the ISO file to include whatever text you like.
For instance \_ISO\LINUX\Ubuntu 16.04 (64-bit).iso64 will be listed as ‘Ubuntu 16.04 (64-bit)‘ in the Linux menu if EXTOFF is set instead of Ubuntu 16.04 (64-bit).iso64.
Note: The .iso64 file extension ensures that E2B will not list the ISO file in the E2B menu on 32-bit systems. You can use a file extension of _.iso64.iso instead so that the Ventoy menu system will ‘see’ a .iso file and recognise it correctly.
agFM: The agFM menu system always list the full filename. agFM does support a sub-set of special file extensions such as .iso64, etc.
Ventoy: The ‘Ventoy for Easy2Boot’ menu system does not list files with non-standard file extensions like .iso64, so if you want to use Ventoy, keep the original extension.
.txt files
Instead of the actual file name being listed in the menu, you can display any menu text and menu help text you like, by creating a .txt file.
The .txt file must have exactly the same filename as the payload file (must use case-sensitive filenames after E2B v2.18 – the extension must be .txt not .TXT).
e.g.
\_ISO\MAINMENU\Clonezilla_64.iso
\_ISO\MAINMENU\Clonezilla_64.txt
Tip:
Make a .txt file by dragging-and-dropping the payload file onto the \_ISO\TXT_Maker.exe utility (see below).
OR…
you can use the \_ISO\docs\E2B Utilities\E2B TXT Maker.cmd file (you can copy the file to your Desktop first for convenience). You will be prompted to enter the menu text and help text. A new .txt file will be made automatically on the E2B drive in the same folder as your payload file.
You can instead make a .txt file using Windows Notepad or any text editor (save as UTF-8 if special characters are required)…
Note: If you create a matching .txt file, the QRUN Auto-suggest text and user prompt will be suppressed. If you wish to see suggestions, turn on SCROLL-LOCK before selecting the menu entry. (E2B v1.96+).
If you require a password prompt before execution is allowed, use .isopwd with a .txt file:
\_ISO\MAINMENU\Clonezilla_64.isopwd
\_ISO\MAINMENU\Clonezilla_64.txt
The password is determined by the grub4dos environment variable menupwd (if set in MyE2B.cfg) or by the pwd variable if menupwd is not defined.
Note: If you specify a .txt file, then the file extension suffixes of ‘4GB’, 3GB’, ’32’ and ’64’ will have no effect because you must add these tests into the .txt file. Instead, use a .mnu file.
Making a .txt file using NotePad
Watch this video at 3:40s.
Without a .txt file, if you have an ISO file at \_ISO\MAINMENU\LinuxTails_x86_2012_11_02.iso, it will be displayed in the Main menu just as the filename, e.g.
19 LinuxTails_x86_2012_11_02
However, if you also specify an alternative title in a .txt file of the same name and in the same folder, then that title will be used instead (note the line of text in the .txt file must start with lowercase grub4dos command title or iftitle), e.g.
\_ISO\MAINMENU\LinuxTails_x86_2012_11_02.iso
\_ISO\MAINMENU\LinuxTails_x86_2012_11_02.txt
where \_ISO\MAINMENU\LinuxTails_x86_2012_11_02.txt could contain the following text :
title ^T Tails 2 Nov 2012 (32-bit) [T]\nPress ENTER to launch the GUI once it has booted.\nPassword is toor.\nGood luck!
A hotkey of T has been defined for this entry (hotkeys are preceded by a ^ symbol).
If you don’t want a hotkey or if you use a GFXBoot Menu, omit the ^T characters. See below for more details about hotkeys.
- You must use .txt files which exactly match the payload filename (e.g. if your file is linux.i386.iso, then create a file called linux.i386.txt).
- The .txt file must be in the same folder that the payload file is in.
- .txt files have no effect if they are present in sub-folders below the \_ISO\xxxx menu folders because, unlike .mnu files, payload files are not enumerated if they are more than one level below \_ISO\xxxx (except for the \_ISO\Auto and \_ISO\WINDOWS\xxxx folders).
- Use only a single line of text (or one line followed by a blank line) in a .txt file. Only the first line will be used (but .txt files under \_ISO\WINDOWS\ can have multiple lines).
- .txt files must begin with title or iftitle.
Text that follows \n will appear as help text at the bottom of the menu list when the item is selected. Any more \n’s on the line (max. 4 lines) will start a new line of help text.
You can use just \n with no following text after the title text to suppress the standard grub4dos default help text (which may not be aligned correctly), e.g.
title ^T Tails 2 Nov 2012 (32-bit) [T]\n
– or –
title Tails 2 Nov 2012 (32-bit)\n
Note: the text in a .txt file must start with the lower-case word title (or iftitle) or you will see errors reported by E2B as it boots.
Tips: Save the .txt file as UTF-8 using NotePad and any special characters such as ü will be displayed correctly.
TXT_Maker.exe
Instead of using NotePad, you can make a .txt file by dragging-and-dropping the payload file onto the Windows \_ISO\TXT_Maker.exe utility…
Click on Save .txt file to write the new .txt file.
Note that if you delete the payload file (e.g. linux.iso) you do not need to delete the .txt file – it will just be ignored if the corresponding payload file of the same file name is missing.
You can also use $HOME$ (the folder path of the .txt file) and $NAME$ (the filename, without extension, of the .txt file) in .txt files – e.g.
title Boot to $NAME$\nBoot $HOME$/$NAME$.ISO
e.g. For a Ubuntu1401.txt file in the MAINMENU folder, the menu entry will appear as ‘Boot to Ubuntu1401‘ and the help text as ‘Boot /_ISO/MAINMENU/Ubuntu.ISO‘
Note: $HOME$ and $NAME$ should not be used in .txt files in the \_ISO\WINDOWS\xxxxx folders as they are not changed by E2B.
Note: If you specify a .txt file, then the payload file extension suffixes of ‘4GB’, 3GB’, ’32’ and ’64’ will have no effect because you must add these tests into the .txt file.
Checking for 64-bit or 32-bit CPUs
You can add ’32’ or ’64’ to a file extension (e.g. Ubuntu.iso64 would only appear in the menu if the system contained a 64-bit CPU). For example, you could have both Ubuntu.iso64 and Ubuntu.iso32 payload files so that on a 32-bit system, it would only list the 32-bit ISO and on a 64-bit system, it would only list the 64-bit ISO or try \_ISO\WINDOWS\WIN10\Windows10.iso64.
You can also add a ‘pwd’ suffix, e.g. Ubuntu.pwd64 so that the E2B password is required before it can be run.
However, if you use a .txt file (Ubuntu.txt) then the special 64\32\pwd suffixes will not work and your Ubuntu.iso64 file will still be listed on 32-bit systems.
To only list the file on a 64-bit system, you would need this .txt file
iftitle [checkrange 2,3 is64bit] Ubuntu\nRun Ubuntu on a 64-bit system
To only list an iso on a 32-bit system, you would need this .txt file
iftitle [checkrange 0,1 is64bit] Linux32\nRun 32-bit linux
You must use a .mnu file for Windows Installer ISOs or if you want extra features like password protection on the file, as the ‘pwd’ suffix may not work if you use a .txt file. See Password_Protect_64_32.mnu in \_ISO\docs\Sample mnu files for an example.
Another way to make a .txt file or new .mnu file, is to use the .cmd batch files in the \_ISO\docs\E2B Utilities folder.
Just drag-and-drop your payload file onto the E2B TXT Maker.cmd or E2B MNU Maker.cmd files and it will make the file for you!
Checking for 4GB+ RAM
If you also want to check for systems containing more than 4GB of memory, place the following 2 lines in your \_ISO\MyE2B.cfg file:
Note: E2B v1.A4 and later versions already add the GB4 variable for you.
# set GB4 if 4GB+ of memory present
set /a M=*0x8298 & 0xffffffff>>10+1 > nul ;; set /a M1=*0x82c0>>10+1 > nul ;; set /a M=%M% + %M1% > nul ;; if %M%>=4096 set GB4=1 ;; set M= ;; set M1=
The variable GB4 will now exist if the booted system contains more than 4GB of memory.
Examples
Suppose we have a Windows10_x86.iso and a Windows10_x64.iso:
If a system has more than 4GB of memory, we want to only show the 64-bit Windows ISO (it must have a 64-bit CPU if it detects >4GB).
If it has less than 4GB we only show the 32-bit Windows ISO.
Windows10_x64.txt
iftitle [if exist GB4] Win10 1703 x64\nInstall 64-bit Windows 10
Windows10_x86.txt
iftitle [if not exist GB4] Win10 1703 x86\nInstall 32-bit Windows 10
Hotkey support
As soon as the user presses a hotkey (e.g. presses the CTRL+T key), the menu entry with a CTRL+T hotkey assigned will immediately run (no need to press the Enter key).
Avoid using SHIFT+ P, C, E or B for hotkeys as these are used by grub4dos for password entry and editing, etc. You can use Ctrl+B or Alt+C, etc. instead.
When you use a title command (e.g. in .mnu and .txt files), you can also specify a hotkey, e.g.
title ^Ctrl+T Tails linux ISO [Ctrl+T]\nPress Ctrl+T to boot to Tails
or
iftitle [if exist $HOME$/Tails.iso] ^Ctrl+T Tails linux ISO [Ctrl+T]\nPress Ctrl+T to boot to Tails
The menu entry will be displayed as: Tails linux ISO [Ctrl+T]
You use the up-arrow symbol ^ to specify a non-displayed hotkey.
Alternatively, you can use square brackets at the beginning of the title to define a hotkey – in which case the square brackets and the hotkey character(s) will also be displayed in the menu, e.g.
title [CTRL+T] Tails linux ISO\nPress T to boot to Tails
Will be displayed in the menu as: [CTRL+T] Tails linux ISO
You can use numbers (best avoided because menu items can be selected by entering their number too!) or letters for a hotkey, as well as F1, F2, etc and Ctrl+F1 (e.g. ^Ctrl+F1). Hotkeys are not case sensitive, you cannot have both ^t and ^T (they are the same!), but you can have ^t and ^SHIFT+t.
Because grub4dos uses SHIFT+e, b, p or c for menu editing, etc., I would avoid using these keys for hotkeys. Also, E2B uses some CTRL+ for menu selection hotkeys. I recommend using Ctrl+Shift for your own menu hotkeys (some non-USA keyboards may remap some of the alt keys – e.g. Hungarian kbd!).
You can also use iftitle – e.g.
iftitle [if exist /_ISO/MAINMENU/fred.iso] [shift+F] Run fred.iso \n
This runs fred.iso when you press shift+F
Note: Not all key combinations can be used as the keyboard BIOS does not generate a scan code for certain combinations (e.g. Ctrl+3). See here for a list.
Ctrl+, shift+ and alt+ combined with 1-9 and F1-F10 are good choices (but E2B uses ctrl+F8).
Avoid using number-pad keys or other special keys which may not be available on netbooks or non-standard keyboards.
Global hotkeys can also be defined in the MyE2B.cfg file (or a .mnu file).
Tip: Make a .txt file by dragging-and-dropping the payload file onto the \_ISO\TXT_Maker.exe utility.
OR
Use the \_ISO\docs\E2B Utilities\E2B TXT Maker.cmd file (you can copy the file to your Desktop first for convenience). You will be prompted to enter the menu text and help text. A new .txt file will be made automatically on the E2B drive in the same folder as your payload file.
Hide Payloads
You can hide any payload file by using a special .txt file, so that the payload file is not added to the menus unless the user enters a password to enable them to be listed. See the ‘Hide payload’ page for details.