Change the payload menu entry menu text using a .txt file (+ add hotkeys)
- Intro
- Use a .txt file
- TXT_Maker.exe
- Check for 32-bit and 64-bit CPUs
- Check for 4GB RAM
- Hotkey support
Introduction
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 (default) or display the full file name using set EXTOFF= in your 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).
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 menupwd (if set in MyE2B.cfg) or by pwd 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.
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), 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 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.
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.
4GB options only work with E2B v1.A4 and later versions.
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$\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 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.
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.
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\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!
MNU Maker.cmd in action!
Checking for 4GB+ RAM
Note: E2B v1.A4 and later versions already add the GB4 variable for you.
Windows10_x86.txt
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 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 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 ALT+ for your own menu hotkeys (but some non-USA keyboards may remap some of 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 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.
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 this page for details.
