Note: All Menu folders must be directly under \_ISO and the folder name must not contain spaces.
An easy way to add a new Main Menu entry for a new folder, is to use the \_ISO\docs\E2B Utilities\Make SubMenu.cmd file - just run this or drag-and-drop your new \_ISO\MSDART folder onto it, to make a Main menu entry for it. Watch the YouTube video above or read the Blog for more details.
Otherwise, do it the harder way and follow the steps below.
Let us suppose we want a new menu folder called 'MSDaRT' for our MSDart ISOs (this could hold XP-based, Vista/7/8 based or UEFI .imgPTN files - see blog). We want this new menu to be listed in the Main menu as a SubMenu.
1. Make a new folder at \_ISO\MSDART and put an ISO in it (or whatever payload files you want). If you want to add payload files + .mnu files to it, make a \_ISO\MSDART\MNU folder (any name will do!) and put your .mnu files + payload files in there.
To add a new menu folder and a new Main Menu entry for that folder, simply use one of the existing menu folder .mnu files located in \_ISO\MAINMENU as a template.
2. Create a new text file \_ISO\MAINMENU\ZZSubMenu$MSDART.mnu from the WINPE example menu below (actually the name of your new .mnu file is not important, but it's name will determine the order it appears in the Main menu - so to have it appear before the other menu entries call it $$ZZSubMenuMSDART.mnu - to have it appear last, call it ZZZZSubMenuMSDART.mnu)
3. Edit the new .mnu file and change 'WINPE' to 'MSDART' and all the other text shown below in bold text. Choose a new hotkey letter (or delete the ^Ctrl+W text) and a new heading for the menu.
This is for non-GFX Boot Menu E2B configurations because a hotkey does not work in GFXBoot Menus.
iftitle [ls (bd)/_ISO/WINPE/ > (md)0x9F00+1 && checkrange 1:-1 read 0x13E0000 > nul && if "%GFX%"==""] ^Ctrl+WWINPE Menu [Ctrl+W]\n Bootable WinPE's
#MFOLDER must be the full folder path starting with /
#HDG is the top heading for the menu - \x20 is the code for a single SPACE character
set HDG=\x20WinPE Menu \x20
Look at \_ISO\MAINMENU\ZZSubMenuAll.mnu for other examples.
Ensure you save it as UTF-8 encoded if you use non-ANSII characters (use NotePad- File - Save As...).
If you want to make a Sub-Sub-Menu under this, e.g. if you want to have an MSDART5 menu in the MSDART menu, create a folder called \_ISO\MSDART_5, and create a ZZSubMenuMSDART_5.mnu file (any name will work!) which has been edited to use that new \_ISO\MSDART_5 folder path. Then simply place the ZZSubMenuMSDART_5.mnu file in the \_ISO\MSDART folder.
Add new Payload folders
If you want to add more menu folders that work like the \_ISO\AUTO folder, then create a .mnu text file in the \_ISO\MAINMENU folder and use this format:
The folders do not have to be below /_ISO.
iftitle [if "%GFX%"=="" && ls (bd)/_ISO/LinuxISO/Ubuntu > (md)0x9F00+1 && checkrange 1:-1 read 0x13E0000 > nul] Ubuntu Menu\n Go to Ubuntu Menu
The \_ISO\UTILITIES_MEMTEST folder is actually a sub-sub-menu folder for the Memory Test menu which can only be reached via the Utilities menu.
The \_ISO\UTILITIES\Utilities_MemTest.mnu file is used to add a menu item in the Utilities Menu which will take you to the UTILITIES_MEMTEST menu.
In the UTILITIES_MEMTEST folder there is a ZZBackTo_Utils.mnu file which will take you back to the Utilities Menu from the Memory Test menu.
New in v1.62:
An easy way to add a new Main Menu entry for a folder is to use the \_ISO\docs\E2B Utilities\Make SubMenu.cmd file - just run this or drag-and-drop your new \_ISO\MSDART folder onto it, to make a Main menu entry for it. See the Blog for more details.
Otherwise, do it the hard way and follow the steps below.
If you want your own sub-sub-menu, then you will need to create these two files and edit them as required.
Example for Linux - Ubuntu sub-sub-menu
You want a new UBUNTU sub-sub-menu in the Linux Menu for Ubuntu ISOs
1. Use the \_ISO\docs\E2B Utilities\E2B SUBMENU Maker.cmd to create a LINUX_UBUNTU folder
Yoy can specify a hotkey (e.g. Ctrl+U) if you wish.
2. Move the file created in the \_ISO\MAINMENU folder (ZZSubMenu$LINUX_UBUNTU.mnu) to the \_ISO\LINUX folder
3. Copy your Ubuntu ISO files into the new, empty \_ISO\LINUX_UBUNTU folder
4. You can now test your menu, but you can only go back to the Main menu using F8.
To return to the LINUX menu from the LINUX_UBUNTU menu, add a new \_ISO\LINUX_UBUNTU\ZZReturn.mnu file:
title Return to Linux Menu\n Go back to the previous menu
set HDG=Linux Menu
#HDG will be the heading for the menu
You can define a hotkey too, by using a different titile line, e.g.
title ^Ctrl+F8 Return to Linux Menu [Ctrl+F8]\n Go back to the previous menu
To change the order of the menu entries, start the .mnu file name with either $ or Z as files are sorted alphabetically (the actual name of .mnu files does not matter).
You can edit the .mnu files if you wish to change them (do NOT edit existing E2B .mnu files!).