MAMEWAH v1.52+ INI System

This is how the ini system works:  MAMEWAH uses three main types of ini config files; mamewah.ini (main/global settings), emuname.ini (emulator-specific settings), and emuname-?.ini (list-specific settings, where ? is the list no.).

mamewah.ini is auto-generated/updated when you run MAMEWAH, and resides in \mamewah.

To generate emuname.ini or emuname-?.ini, simply place suitably named text file(s) in the \mamewah\ini folder (eg mame.ini, mame-0.ini, mame-1.ini etc.), and run MAMEWAH.  The ini files will be automatically populated/updated with default settings.  You must have emuname.ini for each emulator you require, and the number of lists available is determined by however many emuname-?.ini files you have (emuname-0.ini will be the main, non-filterable list).

Settings Overview:

### mamewah.ini ###

### (Global) Screen-Saver Options ###
delay                       5			(seconds)
slide_duration              3			(seconds)

### Audio Options ###
enable_sounds               1			(0=no, 1=yes)
sound_volume                100			(0-100%)
music_path                  			(music folder, eg c:\music)
enable_music                1			(0=no, 1=yes)
music_volume                100			(0-100%)

### Movie Options ###
intro_movie_file            			(movie filename, eg c:\movies\intro.mpg)
exit_movie_file             			(movie filename, eg c:\movies\exit.mpg)
keep_movie_preview_aspect   game_aspect		(no / video_aspect / game_aspect)
delay_before_movie_preview  2			(seconds)
music_movie_mix             mute_movies		(mute_movies / merge / pause_music)
movie_volume                100			(0-100%)

### Misc Options ###
layout                      Classic 640x480	(layout name, see layouts.txt)
ctrlr                       			(ctrlr name, see ctrlr.txt)
wrap_list                   0			(0=no, 1=yes)
keep_image_aspect           1			(0=no, 1=yes)
refresh_images              0			(0=no, 1=yes)
correct_orientations        horizontal		(horizontal / vertical / no)
show_cursor                 0			(0=no, 1=yes)
winipac_file                			(winipac exe filename, eg c:\winipac\winipac.exe)
mamewah_ipc_file            			(default ipac ipc file, eg c:\ipc\mamewah.ipc)
lcd_com_port                1			(lcd display serial [com] port no.)
lcd_settings                			(lcd settings *)
exit_action                 choice		(choice / windows / reboot / shutdown)

### Settings used by MAMEWAH ###
current_emulator            mame		(ignore, generated by MAMEWAH)
locked                      0			(ignore, generated by MAMEWAH)
last_ipc                    			(ignore, generated by MAMEWAH)

* lcd settings should be as follows:

baud rate (110/300/600/1200/2400/9600/14400/19200/28800/38400/56000/128000/256000), parity ([e]ven, [o]dd, [n]one, [m]ark, [s]pace), data bits (4-8), stop bits (1, 1.5, 2)

eg: 9600,n,8,1

------------------------------------------------------------------------

### emuname.ini ###

emulator_title                            				(title of your choice, eg M.A.M.E.)

### List Generation Settings ###
rom_path                                  				(rom folder, eg c:\mame\roms)
rom_extension                             zip				(file extension)
dat_file                                  				(dat filename, eg c:\mame\mame.dat)
nms_file                                  				(nms filename, eg c:\mame\mame.nms)
catver_ini_file                           				(catver.ini filename, eg c:\mame\catver.ini)
list_generation_method                    rom_folder_vs_listxml		(rom_folder / dat_file / rom_folder_vs_dat_file / rom_folder_vs_listinfo / verifysets_vs_listinfo / rom_folder_vs_listxml / verifysets_vs_listxml)

### Execution Settings ###
emulator_executable                       				(emulator filename, eg c:\mame\mame.exe)
send_rom_path                             0				(0=no, 1=yes)
send_rom_extension                        0				(0=no, 1=yes)
quotes_around_romnames                    0				(0=no, 1=yes)
long_filenames                            1				(0=no, 1=yes)
show_dos_box                              auto				(no / yes / auto)
default_options                           				(valid emulator commandline switches, eg -hwstretch)
extra_options_1                           				(valid emulator commandline switches, eg -hwstretch)
extra_options_2                           				(valid emulator commandline switches, eg -hwstretch)

### Artwork Locations ###
artwork_1_image_path                      				(image file folder, eg c:\mame\snap)
artwork_2_image_path                      				(image file folder, eg c:\mame\snap)
artwork_3_image_path                      				(image file folder, eg c:\mame\snap)
artwork_4_image_path                      				(image file folder, eg c:\mame\snap)
artwork_5_image_path                      				(image file folder, eg c:\mame\snap)
artwork_6_image_path                      				(image file folder, eg c:\mame\snap)
artwork_7_image_path                      				(image file folder, eg c:\mame\snap)
artwork_8_image_path                      				(image file folder, eg c:\mame\snap)
artwork_9_image_path                      				(image file folder, eg c:\mame\snap)
artwork_10_image_path                     				(image file folder, eg c:\mame\snap)
movie_preview_path                        				(movie preview folder, eg c:\mame\previews)
movie_artwork_no                          1				(1-10)

### Screen-Saver Settings ###
enable_music_in_screensaver 		  1				(0=no, 1=yes)
saver_type                                slideshow			blank_screen / slideshow / movie / run_selected_game / run_random_game / run_random_game_using_wrapper / launch_scr / shutdown
scr_file                                  				(screensaver filename, eg c:\mamess\mamescreensaver.scr)
wrapper_executable                        				(wrapper filename, eg c:\mame\cmd-launch2.exe)
wrapper_options                           				(valid emulator commandline switches, eg -wait 60)
movie_path                                				(movie folder, eg c:\movies)

### External Application Settings ###
ipc_file_or_path                          				(ipc filename or path, eg c:\ipc\mame.ipc or c:\ipc)
app_1_executable       							(external application #1 filename, eg c:\cpviewer\cpviewer.exe)
app_1_commandline_format                     				(valid external application #1 commandline format *)
app_2_executable                          				(external application #2 filename, eg c:\cpviewer\cpvgeneric.exe)
app_2_commandline_format                     				(valid external application #2 commandline format *)
app_3_executable                         				(external application #3 filename, eg c:\jukebox\jukebox.exe)
app_3_commandline_format                     				(valid external application #3 commandline format *)
auto_launch_apps                          				(the order apps are launched prior to the emulator, eg 1,2,3 or 3,2,1 or 1,2 or 1 etc.)

### Additional Settings ###
music_path                                				(music folder, eg c:\music)
lcd_display_file_path                     				(lcd file folder, eg c:\lcd)
lcd_fe_text   								(text of your choice, eg M.A.M.E. - Multiple Arcade Machine Emulator)

### Settings used by MAMEWAH ###
current_list                              0				(ignore, generated by MAMEWAH)

* as well as regular switches etc., the following strings can be used, and MAMEWAH will replace them suitably with information on the currently selected game when the application is launched:
[description], [name], [year], [manufacturer], [cloneof], [romof], [screen], [orientation], [input], [status], [color], [sound], [category].

Note that if '-clone [cloneof]' is present in the commandline_format, and the selected game is not a clone, then '-clone [cloneof]' will be ignored.

------------------------------------------------------------------------

### emuname-1.ini ###

list_title                                		(title of your choice, eg Joystick Games)

### Games List Settings ###
cycle_list                                1		(0=no, 1=yes)
list_type                                 normal	(normal / most_played / longest_played)
display_clone_info                        0		(0=no, 1=yes)
max_favorites                             0		(0=no limit, >0=limit)

### Settings used by MAMEWAH ###
current_game                              1		(ignore, generated by MAMEWAH)


NOTE: emuname-0.ini does not have the list_type, display_clone_info or max_favorites settings, as these properties for the main list are fixed.