Do not edit any of the original E2B files because if you later update the E2B drive with a newer version of E2B, you will lose all your changes. If you need to change one of the E2B files, rename it first, e.g. rename \_ISO\MAINMENU\ZZSubMenuAll.mnu to ZZSubMenuAllXYZ.mnu before you edit it.
Note: The CSM menu is created by MakePartImage and is inside the .imgPTN image file, so it's menu is not affected by MyE2B.cfg or any file within E2B - see 'Modifying the CSM Menu' on this page.
A YouTube Video about changing the E2B Menu background and using a MyE2B.cfg file is here.
To change the wallpaper - add a 800x600 \_ISO\Mybackground.bmp file - see below for details.
To change individual payload menu entries simply rename the payload file (e.g. 'ubuntu-14.04-desktop-amd64.iso' can be renamed to 'Ubuntu 14.04 64-bit Desktop.iso'), or add a .txt file.
Menu entry order is determined by E2B which sorts the payload and .mnu filenames alphabetically - so just rename them to change their order in a menu.
To change the Main Menu heading, footer help text, menu position, size, colours, language, password and many other options - copy and rename the \_ISO\Sample_MyE2B.cfg file to \_ISO\MyE2B.cfg - then read and edit the file (many settings can be changed!) - or use the E2B_Editor.exe menu editing utility (see below) to design your own custom MyE2B.cfg file and menu.
E2B uses .mnu files in the menu folders to add entries into a menu - you can add more .mnu files, delete or rename them (but don't edit an existing E2B .mnu file unless you first change it's filename).
Many E2B configuration settings can be changed by making and editing the \_ISO\MyE2B.cfg file - please see this page for details.
E2B looks for a \_ISO\MyE2B.cfg user configuration file and, if it is present, uses the settings within it. It then looks for .mnu files (of any name) and payload files that are in, or under, the \_ISO\MAINMENU folder.
E2B uses keyword lookup strings ($$STRxxxx). If you need to change the language, menu entries and headings, prompts and messages, you can use your own STRINGS.txt file to modify the text. Please use the LANG variable in the \_ISO\MyE2B.cfg configuration file (for details, see 'Changing the Language' in the MyE2B.cfg page).
E2B automatically adds payload files (.ISOs, .IMAs, .IMG, etc.) to the menu, only if they are at the 2nd folder level (i.e the \_ISO\xxxx level).
Payload files (and .mnu files) are listed in alphabetical order of their file names.
Note that all .mnu files are found, even if they are nested below the 2nd folder level (nested sub-folders), but for automatic addition to a menu, a payload file must be in the menu folder.
\_ISO\LINUX\FRED\Ubuntu.iso <<< will not be added to the LINUX menu
\_ISO\LINUX\FRED\Ubuntu.mnu <<< will be added to the LINUX menu
\_ISO\LINUX\Clonezilla.iso <<< will be added to the LINUX menu
\_ISO\LINUX\Clonezilla_Persistent.mnu <<< will be added to the LINUX menu
Change the background wallpaper
To add your own wallpaper background, prepare a .bmp file which is exactly 800x600 in size and 24/32-bit colour depth.
Name the file as mybackground.bmp and copy it to the \_ISO folder.
If you wish, you can reduce it's file size by using 7Zip to compress it using GZip format (name it mybackground.bmp.gz or mybackground.bmp). Some high-quality wallpapers can be downloaded from here and here (choose a size of 800x600). You can also have an E2B menu of 640x480 or 1024x768 by changing the \_ISO\MyE2B.cfg file and the GMODE value (see below).
The \_ISO\mybackground.bmp file can also be a JPEG encoded file (e.g. saved as a JPEG file called mybackground.bmp using MSPaint or Gimp - note that a name of mybackground.jpg is not recognised by E2B).
If you add a \_ISO\MyE2B.cfg configuration file, you can specify a different background wallpaper file name and path (notice the forward slashes for grub4dos paths!) - e.g.
Or... set MYWBMP=/User_E2B/myimage.jpg
It is also possible to load a different background wallpaper for each submenu - see here for details.
Do not use a wallpaper larger than 1024x768 (it can cause E2B to crash!) - use either 800x600 or 1024x768
I recommend you use 800x600 because not all systems can display 1024x768x24 colours.
Although E2B supports .jpg files, grub4dos version 0.4.5c does not - so if you use or switch to grub4dos 0.4.5c, do not use a .jpg file.
Choosing a suitable background bitmap
When designing or choosing a menu bitmap, it is best to avoid lots of different colours in the menu area because the menu text needs to be a different colour from any colour in the background so that it stands out clearly with good contrast against the wallpaper image.
Therefore, choose an area for the menu which is suitable to have text overlaid on it so that it will stand out. You could do this by drawing a blank rectangle on the image before saving the bitmap.
The help text area directly below the menu needs 5 clear lines of space, because up to 5 lines of help text can be printed, starting at the 'tophelp' position, on the display.
If a default menu entry is chosen by the user, they may see a 'This highlighted entry will be booted automatically in x seconds' message at position tophelp+5 if a default menu item is set. This text is part of grub4dos. It's position is the 5th line down from the menu help text start position (tophelp set in MyE2B.cfg file). Thus you can define a maximum of 4 lines of help text for each menu entry.
e.g. if the .mnu file was title TEST \n1\n2\n3\n4\n5\n6
The help text below the menu would be 1
The highlighted entry will be booted automatically in x seconds
So you always need to ensure that there a 5 clear lines directly below your menu and then the HELPTEXT footer text below that.
If you want to hide the menu title help text, set tophelp to a large value so it is positioned off-screen (e.g. set tophelp=70) in the \_ISO\MyE2B.cfg file.
Tip: To check you have left 5 lines clear below the menu. As a test, set a timeout of 10 seconds - the countdown message will appear in line 5 under the menu.
Try the new E2Bed .cfg file editor to design your own menu system.
1. Run \_ISO\E2B_Editor.exe (Windows only) and choose a .cfg file (e.g. \_ISO\MyE2B.cfg or select the Sample_MyE2B.cfg file)
2. Choose a 800x600 or 1024x768 .bmp file (uncompressed) or .jpg, if one was not specified in the .cfg file - MUST be anywhere under \_ISO on the E2B USB drive.
3. Use the mouse to draw a rectangle for the menu text position (a menu border, if configured, will be drawn around the outside of the menu text)
4. Change the colours, header and footer and other settings as required.
5. Click on the red Save button to save the new settings (if you chose Sample_MyE2B.cfg then New_MyE2B.cfg or MyE2B.cfg will be saved)
Tip: You can just view the new settings in Notepad by answering 'No' to the 'Save' question.
Note: E2B will load the \_ISO\MyE2B.cfg file for configuration settings.
The diagram below shows an 800x600 display mode (100 text characters x 37.5 lines, GMODE=800).
A 1024x768 display is 128x48 characters (GMODE=1024).
If GFX=none is set, we will have 640x480 mode or 80x30 characters.
Note: The border is always drawn outside of the menu, e.g. if rstart=2 then the border vertical is in column 0 and an arrow pointer is in column 1. The menu text starts in column 2. Allow 1 line for the horizontal border lines. rstart=0 and rstart=1 are equivalent. If GMODE=800 then get 100 characters (0-99) per line and 37 lines (0-36).
Menu headings are positioned using HEADPOS+HPAD+the heading text
HEADPOS is 0000 by default, HPAD is used to shift all the menu headings to the right by a set number of spaces.
Note: HPAD is a variable that contains a string of one or more spaces and it is automatically calculated from the rstart value by E2B. You can specify your own spaces padding for HPAD in your \_ISO\MyE2B.cfg file - e.g. set HPAD=\x20 \x20. The menu headings may have leading spaces - if you want to change this, copy the STRINGS.txt file to your own LANGuage folder and edit the headings that are in the STRINGS.txt file. See here for more details.
Tip: To centre menu headings on an 800 pixel/100 character wide display, use:
E2B can automatically choose the best available resolution by adding code to your \_ISO\MyE2B.cfg file - see my blog post here. However, I suggest you stick to 800x600.
You can cause all menu headings to be centred by setting set CENTREHD=1 in the \_ISO\MyE2B.cfg file (v1.65+).The central position is calculated from the menuw value that has been set in MyE2B.cfg (the default value is set in the E2B.cfg file = 64). You can skew the menu headings by using a non-0 HEADPOS value or a value other than 1 for CENTREHD - e.g. set CENTREHD=65 will make E2B use 65 instead of the menuw value to calculate the centre of the menu. CENTREHD pads out the heading string with the correct number of spaces, HEADPOS and HPAD\rstart are still used to shift the heading over to the right.
Note that HBTM (the bottom help text position) is not padded by HPAD and not centered even if CENTREHD is set.
Other changes (headings, menu position, colours, etc.)
The main way to change E2B is to make a new \_ISO\MyE2B.cfg file by making a copy of the \_ISO\Sample_MyE2B.cfg file. See the MyE2B.cfg page for more details.
E2B v1.50 and later versions use keyword lookup strings which begin with $$STR followed by 4 alphanumeric characters. To change the existing E2B menu headings or standard menu entries or change the language, please go to the 'Languages' page here.
Sub-Menu heading positions
Sub-menu headings may start with leading spaces. If you look in the \_ISO\e2b\grub\ENG\STRINGS.txt file you will see entries like:
$$STRm017=\x20 AntiVirus Menu \x20
The sub-menu heading position is determined by HEADPOS + HPAD + (heading string)
\x20 is a single space character and should be used where leading or trailing spaces are required..
HEADPOS can be set in the MyE2B.cfg file.
HPAD is usually automatically calculated by E2B from the rstart value set in MyE2B.cfg.
e.g. If HEADPOS = 0200 (3rd line down) and rstart=4 (5th column across) then HPAD will be automatically set to '\x20\x20\x20' (i.e. rstart = 3 spaces) - followed by the heading string (2 spaces + 'AntiVirus Menu')
So if you want all the Headings to start at the extreme left side of the sub-menus, you must remove the spaces in all the STRINGS.txt headings - e.g.
$$STRm017=AntiVirus Menu \x20
You can make and change your own STRINGS.txt file (do NOT edit the E2B files!). see 'Changing the Language'.
Tip: It is best to keep HEADPOS ending in xx00 so that it always starts in column 0 (e.g. 0200). HPAD will be set to the rstart value minus 1, unless you specify your own string of spaces for HPAD in the MyE2B.cfg file.
Sub-Menu headings will be automatically centred if CENTREHD has been set in the MyE2B.cfg file.
Changing the filenames that are listed in the menus
By default, payload files (e.g. ISO files, etc.) are listed in the E2B menus by their full filename but without their file extension (EXTOFF=1).
To force E2B to list the filename+extension, use set EXTOFF= in the MyE2B.cfg file.
If you use set EXTOFF=1 in a \_ISO\MyE2B.cfg file then only the filename will be displayed in the menus. The filename can be any name you like, E2B will look at the file extension to decide how to boot from it. e.g. a file named \_ISO\MAINMENU\Boot Ubuntu 14.04.iso will appear in the menu as 'Boot Ubuntu 14.04' if EXTOFF=1 (default).
To change the text of a menu entry and add your own menu help text, make a .txt file of exactly the same name as the payload file.
e.g. for a payload ISO in \_ISO\MAINMENU\fred.iso, you can create a \_ISO\MAINMENU\fred.txt file containing the line:
title This is a menu for Fred\n This is help text\n This is a 2nd line of help text
and the 'fred.iso' menu entry will now appear as 'This is a menu for Fred' and the Help text at the bottom of the menu will also be changed. See here for more details.
To do this without having to use a file editor, copy the \_ISO\TXT_Maker.exe or \_ISO\docs\E2B Utilities\E2B TXT Maker.cmd file to your Windows Desktop. Then drag and drop the payload file (.e.g .iso file) and you will be prompted to enter the menu text and help text. A new .txt file will be made on the E2B drive in the same folder as your payload file. You can also define a hotkey for the menu entry.
Using .mnu files
If you use a .mnu file, you can also define the menu entry text and help text.
.mnu files contain just grub4dos menu lines that you might find in a normal grub4dos menu.lst file. All .mnu file contents are automatically collated and added into the Easy2Boot menu each time you boot E2B. Save the text file as UTF-8 if you want to display special non-ANSI characters.
.mnu files are typically used for special cases and many example files can be found in the \_ISO\docs\Sample mnu Files folder. Instructions for use are inside each .mnu file (view/edit using Notepad).
Typically, .mnu files and their payload files are placed at the 3rd level (e.g. \_ISO\MAINMENU\MNU). Normally, you can use any name instead of MNU for the 3rd level folder or have many different 3rd level folders.