Change the payload menu entry menu text using a .txt file (+ add hotkeys)
- Use a .txt file
- Check for 32-bit and 64-bit CPUs
- Check for 4GB RAM
- Hotkey support
Try a filename (without spaces or special characters like '(' or ')' or '&' ) first. 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 (except VHD/WIM files or WinBuilder-based WinPE ISO files).
You can suppress all the filename extensions from being shown in the menu, if you set EXTOFF=1 in the MyE2B.cfg file.
Use a .txt file
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 (not case-sensitive).
Make a .txt file by dragging-and-dropping the payload file onto the \_ISO\TXT_Maker.exe utility (see below).
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+).
Making a .txt file using NotePad
Watch the vid eo 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.
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), e.g.
where \_ISO\MAINMENU\LinuxTails_x86_2012_11_02.txt could contain the following text :
title ^T Tails 2 Nov 2012 (32-bit) [T]\n Press ENTER to launch the GUI once it has booted\nPassword is toor
A hotkey of T has been defined for this entry (hotkeys are always 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 \_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.
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.
Note: If using iftitle with Windows ISOs, use Txt_Maker.exe from E2B v1.94 or later (bugfix).
From E2B v1.67+, 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$ \n Boot $HOME$/$NAME$.ISO
e.g. For a Ubuntu1401.txt file in the MAINMENU folder, the menu entry will appear as 'Boot to Ubuntu1401' and help text is '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.
Checking for 64-bit or 32-bit CPUs
In E2B 1.62+ 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 (E2B v1.94+).
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\n Run 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\n Run 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 will 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 .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!
MNU Maker.cmd in action!
Checking for 4GB RAM
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
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 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 as 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 can't have both ^t and ^T, but you can have ^t and ^SHIFT+t (SHIFT+t is not the same as T with caps-lock on).
Because grub4dos uses SHIFT+e,p or c for menu editing, etc., I would avoid using SHIFT+ for hotkeys. Also, E2B uses CTRL+ for menu selection hotkeys. I recommend using ALT+ for your own menu hotkeys.
You can also use iftitle - e.g. iftitle [if exist /_ISO/MAINMENU/fred.iso] [F] Run fred.iso \n This runs fred.iso when you press F
Note: Not all key combinations can be used as the keyboard does not generate a scan code for certain combinations (e.g. Ctrl+3). See here for a list.
Avoid using number-pad keys or other special keys which may not be available on netbooks with reduced keyboards or on non-standard keyboards.
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 this page for details.