agFM v1.15 now supports a user theme menu

a1ive has very kindly added support for a user-configurable theme or a user-specified text+wallpaper menu system.

v1.15 includes a slightly modified theme.

0 Default agFM theme

1 User theme

2 User text-mode + wallpaper

Instructions

1. Download agFM v1.15
2. Extract the files to the root of your 2nd FAT32 E2B drive partition overwriting any existing files.
3. Rename or copy \boot\grubfm\SAMPLE_startup_menu.txt to \boot\grubfm\startup_menu.txt.
4. Rename the \boot\grubfm\themes\sample_slack folder to \boot\grubfm\themes\slack.

Now agFM should use the slack theme from the \boot\grubfm\themes\slack folder.

Tweaking the menu system

You can edit the \boot\grubfm\startup_menu.cfg file to change the menu appearance.

If you do not want the small user startup menu, then you should set the timeout value to 0.
set timeout=0

Menu type

#0=standard agFM theme
#1=e2b 'slack' theme
#2=User wallpaper
set mymenu=1
The mymenu variable can be 0, 1 or 2.

1 User 'slack' theme

If mymenu=1 then the \boot\grubfm\themes\slack  folder will be used for the theme.

Change the background by replacing \boot\grubfm\themes\slack\background.png with your own 1024x768 PNG file.

The dark-grey square behind the menu text can be enabled by removing the comment (#) symbol from each of the \boot\grubfm\themes\slack\*.txt files.

Uncomment  in each .txt file to add the background dark-grey square...
#    menu_pixmap_style = "menu_bkg_*.png"

menu text colours can be changed in all .txt files:
  item_color = "#ffffff"
  selected_item_color = "#ff0000"

The title of each menu is set in each .txt file, e.g. :
title-text: "agFM Menu"

Feel free to experiment with any other settings, but remember that there are five different theme .txt files.

2 User text-mode + wallpaper

If mymenu=2 then the commands in the startup_menu.txt USER MENU CONFIG area will be used:

############ USER MENU CONFIG ############
if [ "${mymenu}" = "2" ] ; then
#Remove standard agFM theme - comment out if you want standard agFM theme for agFM
unset theme_std; unset theme_fm; unset theme_open; unset theme_info; unset theme_help;
#Don't use a theme for this menu
unset theme
set resolution (1024x768 recommended)
set gfxmode=1024x768
terminal_output gfxterm
set gfxpayload=1024x768
#Menu colours - format: text/background  (black background=transparent)
#Choice: black,blue,brown,cyan,dark-gray,green,light-cyan,light-blue,light-green,light-gray,light-magenta,light-red,magenta,red,white,yellow
set menu_color_highlight=yellow/black
set menu_color_normal=light-green/black
set color_normal=light-gray/black
#add either your background image or a fill colour - use stretch or normal - .png, .tga, .jpg, or .jpeg
background_image -m stretch (${user})/boot/grubfm/seven.jpg
#valid fill_colors: black,blue,brown,cyan,green,gray,magenta,red,white,yellow
###background_color magenta
fi
###########################################

This is set to use the seven.jpg image (which is 800x600 but stretched to fit).

You can change the wallpaper and text colours by editing this area of the startup_menu.txt file.

Instead of using an image file, you can just fill the screen with a single colour. Comment out the 'background_image...' line and uncomment the next line.

If you want the user Startup menu to use this mode, but you still want the agFM menu system to use the default theme, then comment out the first  'unset theme_std...' line.

Start agFM at the \_ISO\MAINMENU folder

Add the text in red so that agFM opens at the MAINMENU folder.
Set the timeout value as required.

# === DO NOT CHANGE ANY LINES BELOW HERE ===

#grubfm must not be menu entry 1 or above (either 0 or remove this entry)

menuentry "a1ive grub2 File Manager" --class=dir {

grubfm "(hd0,msdos1)/_ISO/MAINMENU/"

}