The CSM menu is determined by the \menu.lst file which you will find inside the .imgPTN image file (NOT the small \menu.lst file on the E2B drive).
Note that changes to E2B, the \_ISO\MyE2B.cfg or STRINGS.txt files will NOT affect the CSM menu. You cannot set a different language for the CSM Menu (you must replace the \menu.lst file with a different one).
If, for some strange reason (!), you don't like my choice for the CSM Menu background ("\csm\e2b\CSM.bmp.gz") or text colours or want to change the language or text, you can change them.
Do NOT change any of the MakePartImage toolkit files EXCEPT you can add files, such as a MyCSM.cfg configuration file and wallpaper bmp or jpg, etc., into the CUSTOM folder.
You can, of course, edit the existing partition image contents, either by mounting the .imgPTN file using ImDisk or by switching to the partition image on an E2B USB drive by using a real system (or QEMU or VBox or SWITCH_E2B.exe) and then access the files directly in Windows Explorer.
The CUSTOM folder
To change MakePartImage (MPI) so that it always uses your own custom CSM menu whenever you make a .imgPTN file, you must use the CUSTOM folder in MPI.
You should never change any other folder. If you later add a new version of the MPI Tool Kit, you can simply copy your CUSTOM folder into the new MPI folder.
When MakePartImage runs, the entire CUSTOM folder will be copied to the partition image when it is made and will overwrite the existing MPI files inside the .imgPTN image. See below for details.
The \menu.lst file
The .\csm\menu.lst file is used for the CSM menu. Most lines are commented for you, to tell you what they do.
WARNING: Do NOT change the long, single line in menu.lst:
This long line in \menu.lst is automatically changed by MakePartImage and it will be replaced with the name of the payload file.
Never edit or replace the .\csm\menu.lst file. Instead use a .\CUSTOM\MyCSM.cfg file and\or copy the .\csm\menu.lst file to the .\CUSTOM folder.
Make sure the 'set PAYLOAD=' line is as shown above.
Modifying the CSM Menu using the CUSTOM folder
To create new .imgPTN images using MakePartImage with modified contents, place your new or replacement files in the CUSTOM folder.
The contents of the CUSTOM folder will be copied by MakePartImage to the root of the image after the payload\ISO has been extracted - any existing files will be overwritten by the files in the CUSTOM folder.
For example: You can place your own menu.lst or MyCSM.cfg file in the CUSTOM folder and it will be used by MPI. If you place your own 800x600 bitmap file at .\CUSTOM\e2b\CSM.bmp.gz it will overwrite the default background wallpaper (the file does not need to be a compressed .gz file and it can be a JPEG file instead of a .bmp file, but it must be named CSM.bmp.gz). MPI v0.085 and later will load \e2b\csm.bmp and \e2b\csm.jpg automatically, if they are present.
To change the CSM menu, simply copy any of the files that you want to change (e.g. csm\menu.lst) to the CUSTOM folder (e.g. .\CUSTOM\menu.lst).
You can then edit the menu.lst file situated in the CUSTOM folder or change the CSM.bmp.gz background file in the CUSTOM\e2b folder and make any other changes you like.
You can add any other files or folders you like under the CUSTOM folder and they will be copied to each new image that you make using MakePartImage.
A typical change is to add a .jpg file and a .\CUSTOM\MyCSM.cfg file which will change the wallpaper, colours, menu position, etc.
The CUSTOM folder already contains some sample .cfg files. You can rename one of these to MyCSM.cfg and see what it does.
MyCSM.cfg - Changing the menu and wallpaper (v0.067+ Aug 2016+)
Recent MPI Tool Kit versions (0.067+) after July 2016, will use a \MyCSM.cfg file which can be created using the E2B_Editor.exe utility.
MyCSM.cfg does not support different languages or keyboards and the F7, F9 and F10 menu entries cannot be suppressed using NOF7. NOF9 and NOF10.
The \Sample_MyCSM.cfg (included in the image) is an example of a MyCSM.cfg configuration file.
Sample_MyCSM.cfg when used as \MyCSM.cfg
Design you own CSM Menu
1. Copy the \_ISO\E2B_Editor.exe file to your Windows Desktop (or run it from an E2B USB drive)
2. Make a .imgPTN file (any ISO will do) and switch to it (using Switch_E2B.exe or boot to E2B and select the .imgPTN file)
3. Place your background wallpaper in \e2b folder on the USB drive (in CSM mode) - 24-bit colour .bmp or .bmp.gz or .jpg (800x600 recommended, or 1024x768)
4. Rename \Sample_MyCSM.cfg to \MyCSM.cfg on the E2B USB drive (in CSM mode)
5. Run the E2B_Editor.exe, select the \MyCSM.cfg file on the E2B USB drive when prompted
6. Select the bitmap or jpeg file you placed in the \e2b folder (ignoreany warnings about it being a non-ISO/non-USB folder and any language\keyboard warnings)
7. Use the E2B_Editor GUI to configure your menu - tip: place XXXX in the HEADING field so you can see where the heading will be placed
8. Boot to the image to test it (you can use RMPrepUSB - F11)
9. Make sure the HEADING field in E2B_Editor is completely empty (THIS IS IMPORTANT!)
Now re-save the \MyCSM.cfg file and check that the HEADING value is blank:
10. Now copy the \MyCSM.cfg file into the .\CUSTOM\ folder and copy the wallpaper .bmp/.jpg file into the .\CUSTOM\e2b folder in the MPI Toolkit download folder (you can delete the Sample_MyCSM.cfg file if you wish).
Do NOT copy the \menu.lst file (because the 'set PAYLOAD= ;; #####' line needs to be unmodified)!
Make sure the HEADING value is empty in the MyCSM.cfg file, otherwise all your new .imgPTN files will all have the same heading!
Make sure that the path in the MyCSM.cfg file is correct - e.g.
Note: If a \MyCSM.cfg file exists, the informational menu messages about 32-bit and 64-bit EFI boot files at the bottom of the CSM menu will be suppressed (see below). Also, the Menu heading will be set to the Payload name (as set by MakePartImage when the .imgPTN file was made), i.e. there will be no 'EASY2BOOT MAIN MENU xxx' heading.
You can also change the grub4dos password and change the default menu entry and add a timeout using the MyCSM.cfg file, e.g. add these lines to the bottom of the MyCSM.cfg file:
# -- ADVANCED MENU
# All lines below here will be preserved by the MyE2B_Editor.
# PAYLOAD HEADING IS USED IF HEADING is blank
#to change default menu entry and timeout
# -- ADVANCED MENU
# All lines below here will be preserved by the MyE2B_Editor.
# set the default menu entry (0-99) - dask should be set to same number
default 4 && set dask=4
# set default timeout in seconds (-1 = no timer) - task should be set to same number
timeout 99 && set task=99
If you want to adjust the Menu Heading afterthe .imgPTN file has been created, then edit the 'set HEADING=' entry in the \MyCSM.cfg file inside the .imgPTN file, e.g.
set HEADING=My new menu (%VER%) %B64% %@DATE% %@TIME%
The HEADING parameter supports the variables %B64% %day% %month% %year% %@DATE% %@TIME% %VER% and %UUID%
To have a full-length menu bar for the highlighted menu item, add this line to either the \menu.lst file or the \MyCSM.cfg file:
# set full length highlight bar for selected menu item (--highlight-short or --highlight-full)
setmenu --highlight-full > nul
Note: If black is used for the highlight background colour then the background bar will be transparent (invisible), e.g. highlight=yellow/black.
You can centre the menu entries and remove the menu border in MyCSM.cfg using MPI 0.085+ using:
setmenu --box l=0
Note that the LANG and KBD setting in the MyCSM.cfg file will not work...
Change the language of the CSM Menu
MPI 0.085 and later support a limited number of languages - the .\e2b\LANG folder holds the .txt files which are available (e.g. .\e2b\LANG\GERMAN.txt)
You can use these language files by setting the LANG variable in .\CUSTOM\MyCSM.cfg file:
# This will cause the strings in \e2b\LANG\GERMAN.txt to be used instead of \e2b\LANG\ENGLISH.txt
When the .imgPTN file is made, the \MyCSM.cfg file must be in the root of the USB drive.
Use the Sample_MyCSM.cfg file as a template.
You can make your own language translation by copying the ENG.txt file and renaming and modifying it - e.g. .\CUSTOM\LANG\SPANISH1.txt and set LANG=SPANISH1.
For GFX Menus, you must copy GFX_menu_ENG.lst to the .\CUSTOM\e2b\LANG folder and edit it manually. If you want to be able to use more than one language, rename your new file and set the LANG variable - e.g. GFX_menu_GERMAN.lst is used if LANG=GERMAN. The file is only used if \e2b\message exists.
For older MPI versions
The CSM menu does not support different languages in older versions.
To change the language, we must replace the English default menu.lst with a different file with translated menu entries.
1. Copy the .\csm\menu.lst file from the MPI Tool Pack folder, to the CUSTOM folder in the MPI Tool Pack.
Note: Do NOT use the \menu.lst file from an existing .imgPTN file because it will have been modified by MakePartImage.cmd. You must copy the menu.lst file from the .\csm folder.
2. Now edit the .\CUSTOM\menu.lst file and change the 'title' and 'iftitle' lines into your own language. For example:
title EASY2BOOT - Switch back to the Easy2Boot menu\n Restore the Easy2Boot MBR.\n This will restore all the Easy2Boot partitions.
title EASY2BOOT - Zurück zum Easy2Boot-Menü\n Easy2Boot MBR wiederherstellen.\n Das wird alle Easy2Boot Partitionen wiederherstellen.
Save the file in UTF-8 format using NotePad.
Now, whenever you make a new .imgPTN file, the .\CUSTOM\menu.lst file will be used.
The CSM menu will assume that a standard US QWERTY keyboard is present.
If your keyboard is not a QWERTY keyboard, you may not be able to enter the menu password of 'easy2boot'. To use a different keyboard for all your new .imgPTN files:
1. Copy the \_ISO\e2b\grub\KBD_*.g4b files to the MPI .\CUSTOM\e2b folder
2. Add a MyCSM.cfg file to the MPI .\CUSTOM folder containing the appropriate keyboard code, e.g.
Now when you make a new .imgPTN file, the keyboard scan codes will be converted correctly.
Alternatively, remove the menu password so that you do not need to enter a password by using:
in the CUSTOM\MyCSM.cfg file.
Using a 1024x768 menu
Modern systems which support UEFI-booting will support 1024x768x24 graphics mode. However, some older systems (e.g. netbooks) may only support 800x600x24. In this case, you can create an alternate configuration file, e.g. MyCSM800.cfg, and use the following 2 lines at the top of your \MyCSM.cfg file:
If the system does not support 1024x768x24 then the MyCSM800.cfg file will be used instead of the settings in MyCSM.cfg.
Updating the MPI Tool Pack
By using the CUSTOM folder, your changes can be kept when you update the MPI Tool Pack to a newer version - just copy your CUSTOM folder to the new CUSTOM folder in the new MPI download.
Frettt has provided a German translation of the CSM Menu.lst file - check the Alternate Downloads - Other files folder! It may be outdated however.
When you use a \MyCSM.cfg file, the UEFI boot file messages are not displayed because they may conflict with the new menu position.
To include the EFI boot file lines under the menu, add the following 5 lines to your \MyCSM.cfg file
# To adjust position, change P:XXXX in lines below
if exist /EFI/boot/bootia32.efi set E=%E%echo -n -e -P:3331 \\x24INFORMATION: x86 32-bit UEFI boot file \\\\EFI\\\\boot\\\\bootia32.efi present
if exist /EFI/boot/bootx64.efi set E=%E% \necho -n -e -P:3431 \\x24INFORMATION: x86 64-bit UEFI boot file \\\\EFI\\\\boot\\\\bootx64.efi present
ls /EFI > nul || set E=\necho -n -e -P:3331 \\x24INFORMATION: No \\\\EFI folder present (cannot UEFI boot)
Note that the 32-bit message is on line 33 and the 64-bit message is on line 34 in this example.
To display a single \ character, you must use \\\\.
To display any more text on the CSM menu, add another line similar to:
set E=%E%\necho -n -e -P:3731 \\x24Here is my text
 defines the colour (see \_ISO\Sample_MyE2B.cfg for explanation of colours - e.g.  = 0 no blink, 1=bright, 0=black\transparent background, 3=cyan). You can also use 0xRRGGBB instead of the 4-digit colour codes (e.g. [0xFF0000] for red).
-P:RRCC defines the Row and Column position where the text will start - e.g. 3331 = line 33 down and 31 characters across.
\n throws a new line.
Add a GFXBoot Menu file
Recent MPI Tool Kit versions (0.067+) after July 2016, will support a GFX menu.
Ensure that your GFXMenu file is at .\CUSTOM\e2b\message (it must be named message with no file extension). It will automatically be used if it is present.
If you do not want any of the F7, F9 or F10 menu entries, then copy the .\csm\menu.lst file to the .\CUSTOM\ folder, and edit it to delete the menu entries you do not need.
The 'default' and 'timeout' settings will be valid for a GFXBoot menu, but the HEADING and other menu settings will not apply.
Testing the changes
If you have existing .imgPTN files, instead of making new images, you can mount the .imgPTN file using ImDisk (right-click on the file) - then make your changes, e.g. you can replace the menu.lst and CSM.bmp.gz files, etc. and then dismount the virtual drive to save the changes. An easier alternative is to switch E2B to that image (CSM mode) and then edit the partition on the USB drive under Windows or linux directly.
Note: Your menu.lst file must contain certain phrases which are recognised by E2B. These phrases are in the 'Easy2Boot switch' menu code. If these 'Switch' code phrases are not in the menu.lst file, E2B will refuse to load the partition image (because there will be no way to switch back to E2B from the CSM Menu!).
MakePartImage will replace the string '##set PAYLOAD= ;; ' in the menu.lst with the name\title of the payload and remove the ## characters. To change the payload title in the menu, change the line:
or better yet, use a \MyCSM.cfg file and set the HEADING parameter.
Tip: When a new version of MPI is downloaded, compare the .\csm\menu.lst file with your .\CUSTOM\menu.lst file to see what has changed!
Set a default menu entry and a timeout
MPI 0.082+ allows you to change the default and timeout setting using the menu entry near the bottom of the menu.
If using MPI 0.067 or later (after July 2016), then you can use the \MyCSM.cfg file, e.g.
default 3 && set dask=3
timeout 20 && set task=20
For older versions of MPI, you can make the CSM menu automatically boot to any one of the menu entries by editing the \menu.lst file (the one inside the .imgPTN file). e.g. The line in red has been added so it will run the selected menu entry after 2 seconds unless the user presses a key to stop the timeout.
You can change the default menu item that is automatically run by changing the 'default 2' line.