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.
The menu language and keyboard type can also be changed using the MyCSM.cfg file (see below).
MyCSM.cfg - Changing the menu and wallpaper (v0.067+ Aug 2016+)
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.
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) - the E2B USB drive should now contain a \e2b folder
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 (ignore any 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!
Do not copy the \heading.g4b file - this is created by MPI and sets and overrides the PAYLOAD variable (MPI 0.089+).
Make sure that the path in the MyCSM.cfg file is correct - e.g.
Note: If a \MyCSM.cfg file exists, the menu messages about 32-bit and 64-bit EFI boot files at the bottom of the CSM menu can 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.
# 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 after the .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%
Note that the \heading.g4b file (created by MPI inside the .imgPTN file) can be modified instead if you wish.
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 (default) then the background bar will be transparent (invisible), e.g. highlight=yellow/black.
You can specify a background color as well as a highlight colour 0x00rrggbb00RRGGBB - e.g. for a blue background (bb=CC)
You can centre the menu entries and remove the menu border in MyCSM.cfg using MPI v0.085+ using:
setmenu --box l=0
If you do not want the EFI boot file text to be displayed under the menu, use set set NOEFITXT=1 in the MyCSM.cfg file to suppress it.
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\ENG.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\ENG1.txt and
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.
Later versions of MPI use a different menu file (e.g. GFX_menu_ENG.lst) instead of the \menu.lst file - if you want to change the GFX menu, add a copy of GFX_menu_ENG.lst to the .\CUSTOM\e2b\LANG folder and then edit that copy. The language translation files (e.g. ENG.txt) are NOT used when using a message file.
Example for GFX menu in German:
- Add .\CUSTOM\e2b\message file
- If the 'GERMAN' language is set (set LANG=GERMAN) in the MyCSM.cfg file, then the file \e2b\LANG\GFX_menu_GERMAN.lst will be used (if it is present).
The 'default' and 'timeout' settings will be valid for a GFXBoot menu, but the HEADING and other menu settings will not be displayed.
GFX Boot Menu Languages
To use a GFX menu, copy the GFX message file to the MakePartImage .\CUSTOM\e2b folder.
For non-English GFX Menus, you must copy GFX_menu_ENG.lst to the .\CUSTOM\e2b\LANG folder and edit it manually.
Then set the LANG variable - e.g. GFX_menu_GERMAN.lst is used if set LANG=GERMAN.
This file will only be used if the file \e2b\message also exists.
Language support in 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 USA 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. If not already present in the .\csm\e2b folder, copy the \_ISO\e2b\grub\KBD_*.g4b files to the .\csm\e2b folder
2. Add a MyCSM.cfg file to the MPI .\CUSTOM folder to call the appropriate keyboard batch file, e.g.
#turn off errorchecking in case an older grub4dos version is being used
Now when you make a new .imgPTN file, the keyboard scan codes will be converted correctly.
You can instead use
in the MyCSM.cfg file (v0.096 and later versions only).
To remove the menu password so that you do not need to enter a password:
in the CUSTOM\MyCSM.cfg file (or set the password as required, e.g. set pwd=fred).
Add an animation
Example lines to add to \MyCSM.cfg file (change text in red as required):
# 1st param - use 0x90 for looping+transparent background, use 0x10 for opaque background
# 2nd param is delay (1\18th second), 3rd is last frame number, 4th is x pos, 5th is y pos (in pixels), 6th is path to first frame
set ANIMATE=0x10=3=%last%=590=400 (fd3)/E2B/CheetahAnimatedKick_frame_0001.BMP
# load IMA as fd3
map --mem %ANIMFD3% (fd3) > nul
map --hook > nul
# play sequence now
# remove params
set ANIMATE= ;; set last= ;; set ANIMFD3=
Using a 1024x768 menu
The default menu expects an 800x600 display but you can set the mode to 1024x768 using set GMODE=1024 in the MyCSM.cfg file. Note that the menu width and height will be changed.
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:
debug 1 ;; vbeprobe > (md)0x220+5 ;; debug 0
cat --locate=1024x768x24 (md)0x220+5 > nul || /MyCSM800.cfg && goto :EOF
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.
To suppress the EFI boot file info lines use:
To add your own 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 displayed on line 33 and the 64-bit message is displayed 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.
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) using SWITCH_E2B.exe or by MBR-booting and selecting the .imgPTN file - then you can directly edit the files on the USB drive under Windows or linux.
Note: Your menu.lst file must contain certain phrases which are recognised by E2B and SWITCH_E2B. These phrases are in the 'Easy2Boot switch' menu code. If these 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.cmd 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, use a \MyCSM.cfg file and set the HEADING parameter.